Errors
Video MCP error codes — what they mean and what the agent should do next.
Job failures appear on get_status as failed, not as MCP protocol errors. create_video succeeding with a jobId is expected.
| Code | Meaning |
|---|---|
UNAUTHORIZED | Missing or invalid OAuth |
PLAN_REQUIRED | Free plan hit the Video MCP |
FORBIDDEN | Not a member of the workspace |
NOT_FOUND | Project, job, or asset missing |
CREDITS_EXHAUSTED | Owner cannot pay for this job |
RECIPE_REQUIRES_FOOTAGE | edit without a video asset |
RECIPE_REQUIRES_BRIEF | Empty brief |
ASSET_NOT_READY | Upload still processing — retry create_video |
JOB_STILL_RUNNING | Another job is active on the project |
GENERATION_FAILED | Clip/image generation failed after retries |
COMPOSE_FAILED | Build or validation failed |
EXPORT_FAILED | Render failed |
RATE_LIMITED | Back off; Retry-After may be present |
What the agent should do
UNAUTHORIZED— complete browser OAuth, then retry. See OAuth and access.PLAN_REQUIREDorCREDITS_EXHAUSTED— stop and show the billing URL. Do not retry.JOB_STILL_RUNNING— pollget_statusorcancel_job.ASSET_NOT_READY— wait and retrycreate_video.RECIPE_REQUIRES_FOOTAGE— upload a video asset, or switch togenerate/compose.- Recoverable compose failures —
revise_videowith the error message.
Connection problems (server never appears, OAuth loop) are covered on each agent page and in Troubleshooting.