Tools

list_automation_runs

The newest uploads (or finished Twitch streams) an automation found, newest first: each one's state (queued, waiting, clipping, exporting, posting, done, skipped, failed), why, and its chosen clips with their scores, posting times and whether they wait for approval.

Access token · read · Read only

Parameters

automationId string required

The automation's id (from list_automations).

View schema

{
  "description": "The automation's id (from list_automations).",
  "type": "string",
  "format": "uuid",
  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
}

Request example

{
  "name": "list_automation_runs",
  "arguments": {
    "automationId": "00000000-0000-4000-8000-000000000001"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.