Tools

ask_editor_agent

Give Heavenly's own editing assistant an instruction in plain words ("cut the first 3 seconds", "add captions"). It plans and edits the timeline itself. Costs 1 AI credit per call. Small edits are applied; bigger ones come back as a proposal: show the user, then apply_editor_proposal or discard_editor_proposal.

Access token · edit · Changes account data

Parameters

projectId string required

The project's id (from list_projects).

View schema

{
  "description": "The project's id (from list_projects).",
  "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)$"
}

message string required

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 4000
}

Request example

{
  "name": "ask_editor_agent",
  "arguments": {
    "projectId": "00000000-0000-4000-8000-000000000001",
    "message": "YOUR_MESSAGE"
  }
}

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.