Render a Short over MCP: timeline_create, jobs_wait, timeline_get
Three hosted MCP tool calls turn a Timeline document into a vertical Short: create with an idempotency_key, wait on the job, then fetch the result.
On the hosted MCP server, rendering a Short is three tool calls: timeline_create submits the Timeline document, jobs_wait waits for the job, and timeline_get reads the result, which is GET /v1/jobs/:id/result. The write needs an idempotency_key, and under OAuth the mcp:write scope. Read from the Sume docs on 2026-10-06.
What does each call take?
| Step | Tool | Notes |
|---|---|---|
| 1 | timeline_create | Same document as the REST route; requires idempotency_key |
| 2 | jobs_wait | Waits on the job; call again if it is still running |
| 3 | timeline_get | Returns video_url, duration_seconds, billable_minutes and warnings |
What should the agent put in the document?
Keep it declarative: audio.duration_seconds at 180 or less for a Short, video[] slots with increasing starts, and the default 1080x1920 frame. Ffmpeg fields such as codec or filtergraph are refused, so do not let an agent invent them. Media must already be media.sume.com URLs from a prior import.
Why loop on jobs_wait?
A single jobs_wait call may return before a long render finishes, so call it again. Do not resubmit with a new key while waiting, since that would start and bill a second render.
Sources
Related posts
More in Integrations
- GitHub Actions job that renders a 9:16 clip on Sume as an artifact
A workflow file that replaces a Sora render step: submit to Sume, poll with a deadline, and upload the mp4 as a build artifact. The key stays in a secret.
- stt_create dry_run and max_spend_usd: cap an MCP transcription run
On Sume's hosted MCP, dry_run previews admission and cost without submitting, and max_spend_usd caps a paid stt_create. Add an idempotency_key to every write.
- Can I swap a Sume MCP OAuth token for an API key? Why you should not
A hosted MCP OAuth token is not a Sume API key. Do not mint keys as a workaround for a read-only session; turn Write on at consent, or use a key on purpose.
- Trae IDE: add Sume as a remote MCP server with Add Manually
In Trae, open Settings > MCP > Add > Add Manually and paste a JSON entry with Sume's hosted URL and an Authorization header. Steps, trade-offs, key handling.
Written by Sume