Reference
MCP tools
The eight tools an agent gets, and what each one takes.
Every tool returns a JSON string in a text block. create_project, prompt_project and get_project return the project object described in the REST reference. On failure the result has isError: true. See Errors.
#create_project
Start a project and send its first prompt. Work is usage-metered as it runs.
| Argument | Type | Required | Notes |
|---|---|---|---|
flow (deprecated) | string | no | Deprecated compatibility hint. Accepted but ignored. |
prompt | string | yes | What to make: the product URL, recording, document, asset, brief, topic, or instructions |
options | object | no | launch-video { resolution, narration, music }; demo-video { url, voice, script, background, shape, browserHeader }; deck { slideCount, template, mode }; recording-edit { productName, productUrl } |
uploads | array | no | { fileBase64, fileName } entries: PDFs or images for demo-video assets, a PDF or PPTX for deck, a video for recording-edit |
Returns the project with status: "working". The output is not ready at that point; poll get_project.
#prompt_project
Send a usage-metered follow-up message to a project’s agent. Returns the project; the agent works asynchronously.
| Argument | Type | Required | Notes |
|---|---|---|---|
projectId | string | yes | |
text | string | yes | |
scene | string | no | Scope to a scene or shot id |
slide | number | no | Scope to a slide, 1-based |
delivery | "queue" | "steer" | no | Queue behind active work (default), or steer the active run |
delivery: "steer" when the new instruction should redirect the active run.#get_project
Read one project by projectId: status, outputs, scenes or slides, shareUrl, error. Free. This is what the agent polls.
#list_projects
Your projects, newest first. Optional limit (1 to 100, default 50). Returns { data, total }.
#export_project / export_status
Start an export with projectId and optional res (720p, 1080p, or 4k), then poll export_status. Export work is usage-metered.
#get_credits
Balance, subscription, and transactions. Free. Call it before create_project.
#get_pricing
Usage-metering rates and indicative launch export tiers. Free. Same payload as GET /v1/pricing.