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.
- Viber bot video message: 26 MB, 180 s, .mp4 URL, a Sume clip
Viber's bot API wants an MP4 URL ending in .mp4, 26 MB max, 180 s max, and a JPEG thumbnail. A 60 second Sume avatar clip fits. The checks to run first.
- WhatsApp Business MCP is dev-only: keep Sume generation server-side
WhatsApp Business tools MCP was announced as dev and test only. Generate with Sume on your server and gate the MCP transport by environment. Tested code.
Written by Sume