Skip to main content
Glama

Check a video

check_video
Read-onlyIdempotent

Check a video and show it, waiting for news while it is being made. state is waiting (upload link in the answer), uploading, editing, ready, draft (a rough cut, not the finished edit; next_step says how to finish it), cancelled, or failed (problem says why). A download link: with_download: true.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "check_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
waitNoLeave it out: waiting keeps a check from being wasted.
job_idNoThe job_id a change answered with: also reports that change.
video_idNoThe video to check, from list_videos or the answer that made it.
import_idNoThe import_id edit_video gave while the upload is still on its way.
output_idNoOne output to show (a hook, a Short or a shape); the main video when left out.
with_downloadNotrue: also make a 15-minute download link (only when the user wants the file).

Output Schema

NameRequiredDescriptionDefault
codeNo
costNo
errorNo
readyNo
stateNo
changeNo
statusNo
dry_runNo
messageNo
outputsNo
plan_idNo
durationNo
playableNo
progressNo
style_idNo
video_idNo
availableNo
import_idNo
narrationNo
output_idNo
studio_urlNo
version_idNo
downloadableNo
download_page_urlNo
previous_version_idNo
revision_in_progressNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / wait / description
      Previous value: -"The video card sends false. Leave it out: waiting keeps a check from being wasted."New value: +"Leave it out: waiting keeps a check from being wasted."
  2. Changed2 schema fields changed
    • changedInput schema / properties / job_id / description
      Previous value: -"The job_id revise_video returned: also reports that change."New value: +"The job_id a change answered with: also reports that change."
    • changedInput schema / properties / video_id / description
      Previous value: -"The video to check (from edit_video, create_video or list_videos)."New value: +"The video to check, from list_videos or the answer that made it."
  3. Changed2 schema fields changed
    • changedInput schema / properties / job_id / description
      Previous value: -"The job_id revise_video returned: also reports that change (steps, reply, what it could not do)."New value: +"The job_id revise_video returned: also reports that change."
    • changedInput schema / properties / wait / description
      Previous value: -"The video card's own refresh sends false to answer at once. Leave it out: waiting for news is what keeps a check from being wasted."New value: +"The video card sends false. Leave it out: waiting keeps a check from being wasted."
  4. Changed1 schema field changed
    • changedInput schema / properties / job_id / description
      Previous value: -"The job_id revise_video returned for a change by typing: also reports that change (its steps so far, then its reply, whether it changed anything, and anything it could not do)."New value: +"The job_id revise_video returned: also reports that change (steps, reply, what it could not do)."
  5. Changed3 schema fields changed
    • addedInput schema / properties / import_id / description
      Added value: +"The import_id edit_video gave while the upload is still on its way."
    • addedInput schema / properties / output_id / description
      Added value: +"One output to show (a hook, a Short or a shape); the main video when left out."
    • addedInput schema / properties / video_id / description
      Added value: +"The video to check (from edit_video, create_video or list_videos)."
  6. Changed1 schema field changed
    • addedOutput schema / properties / download_page_url
      Added value: +{
      +  "format": "uri",
      +  "type": "string"
      +}
  7. Changed2 schema fields changed
    • addedInput schema / properties / job_id
      Added value: +{
      +  "description": "The job_id revise_video returned for a change by typing: also reports that change (its steps so far, then its reply, whether it changed anything, and anything it could not do).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / change
      Added value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
  8. Changed1 schema field changed
    • addedInput schema / properties / wait
      Added value: +{
      +  "description": "The video card's own refresh sends false to answer at once. Leave it out: waiting for news is what keeps a check from being wasted.",
      +  "type": "boolean"
      +}
  9. Changed1 schema field changed
    • addedOutput schema / properties / narration
      Added value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
  10. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "Clypmint check_video result. Error results carry error; successful requests expose the identifiers and state available for the next step. Signed media stays in private metadata.",
      +  "properties": {
      +    "available": {
      +      "type": "boolean"
      +    },
      +    "code": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "cost": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "downloadable": {
      +      "type": "boolean"
      +    },
      +    "dry_run": {
      +      "type": "boolean"
      +    },
      +    "duration": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "type": "string"
      +    },
      +    "import_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "message": {
      +      "type": "string"
      +    },
      +    "output_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "outputs": {
      +      "items": {
      +        "additionalProperties": true,
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "plan_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "playable": {
      +      "type": "boolean"
      +    },
      +    "previous_version_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "progress": {
      +      "maximum": 1,
      +      "minimum": 0,
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "ready": {
      +      "type": "boolean"
      +    },
      +    "revision_in_progress": {
      +      "type": "boolean"
      +    },
      +    "state": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "type": [
      +        "string",
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "studio_url": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "style_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "version_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "video_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  11. Changed1 schema field changed
    • addedInput schema / properties / with_download
      Added value: +{
      +  "description": "true: also make a 15-minute download link (only when the user wants the file).",
      +  "type": "boolean"
      +}
  12. Changed1 schema field changed
    • addedInput schema / properties / output_id
      Added value: +{
      +  "type": "string"
      +}
  13. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), and the description adds real value on top by enumerating the possible states and what each answer carries (upload link when waiting, next_step for draft, problem for failed). That state-machine disclosure is exactly the behavioral context annotations cannot express; the only omission is whether repeated calls are cheap or rate-limited.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short and front-loads the core action before the state enumeration. The state list is dense but each entry earns its place by telling the agent how to interpret the answer; phrasing is slightly telegraphic but not padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists and annotations cover safety, so return values and risk do not need restating. However, for a tool with six optional parameters and zero required ones, the description never says that at least one identifier (video_id, job_id, import_id) must be supplied, nor how to choose among them — a meaningful gap for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all six parameters, setting the baseline at 3. The description adds only the with_download mapping ("A download link: with_download: true"), which largely restates the schema, and says nothing about the relationship between video_id, job_id, import_id and output_id.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a concrete verb and resource ("Check a video and show it") and adds the key qualifier that it waits for news while the video is being made, which distinguishes it from creation/edit siblings. It stops short of naming an explicit alternative, but an agent can identify this as the status/polling tool without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: "waiting for news while it is being made" suggests polling a job in progress, and the state list implies when the result is meaningful. There is no explicit when-to-use/when-not guidance, no polling cadence advice, and no mention of which sibling to call instead once the video is ready.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources