Tools

capture_frames

Name the owned source frame at each time in the cut. Nothing new is generated and nothing is spent.

Access token · read · Read only

Parameters

variant_id string required

View schema

{
  "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)$"
}

times array optional

View schema

{
  "maxItems": 8,
  "type": "array",
  "items": {
    "type": "number",
    "minimum": 0,
    "maximum": 90
  }
}

Request example

{
  "name": "capture_frames",
  "arguments": {
    "variant_id": "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.