Tools

get_clip_job

A Clips job's status (queued, processing, completed, failed, cancelled), progress 0-100, what it is doing and how many clips are ready. Wait poll_after_seconds between calls; it is null once the job is done.

Access token · read · Read only

Parameters

job_id string required

The Clips job id (from clip_video or list_clip_jobs).

View schema

{
  "description": "The Clips job id (from clip_video or list_clip_jobs).",
  "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_clip_job",
  "arguments": {
    "job_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.