Check a job
video_jobRead-only
Check a video processing job's status, stage, and progress, optionally waiting up to 300 seconds for completion with streamed progress updates.
Instructions
A job's status, stage and progress, optionally waiting for it to finish. Progress is also streamed as MCP progress notifications while waiting.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "video_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job id from video_ingest, video_ingest_batch or video_download. | |
| wait_seconds | No | Seconds to wait for completion before returning the job. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | What the job does. | |
| next | No | The call to make to keep waiting, while the job is unfinished. | |
| error | No | 'code: message — hint' when the job failed. | |
| stage | Yes | Current step: queued, download, transcribe, frames, embed or done. | |
| job_id | Yes | Pass to video_job to poll, or video_cancel to stop. | |
| result | No | When succeeded: the ingest report (video_id, counts, stages, embedding tokens, elapsed seconds) or the download report (path, codecs, size, whether audio was merged). | |
| source | Yes | The URL or path being processed. | |
| status | Yes | `interrupted` means the server restarted mid-job; ingest again to resume. | |
| message | Yes | Latest human-readable progress line. | |
| progress | Yes | Overall completion from 0 to 1, weighted by how long each stage usually takes. | |
| video_id | No | Known once the source has been resolved; use it with every other tool. |