Tools

get_motion_design

A job's status (queued, created, running, awaiting_user_input, completed, failed), what the designer is doing, and, once completed, the project to open, a download link to the design and the sources audit. Wait poll_after_seconds between calls; stop when it is null.

Access token · read · Read only

Parameters

jobId string required

The design's job id (from create_motion_design or list_motion_designs).

View schema

{
  "description": "The design's job id (from create_motion_design or list_motion_designs).",
  "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": "get_motion_design",
  "arguments": {
    "jobId": "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.