API & MCP
Everything a person can do on Multitrack Timeline Renderer, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://reelcrafttimelinerender.usefulweb.app/api/v1/calculate– run Multitrack Timeline RendererGET https://reelcrafttimelinerender.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Multitrack Timeline Renderer
Renders a Reelcraft timeline into one MP4 video (H.264/AAC) on the usefulweb server. The timeline lists video, image, audio and text tracks; each clip has a start, an in-point and a length, a gain in dB, fade-in and fade-out and an optional crossfade or dip-to-black transition from the clip before it. Pictures are fitted into the canvas (letterboxed or cropped), stacked with the top track on top, titles are drawn as text and all sounds are mixed without normalisation. Send the timeline as JSON and up to eight media files; the report lists every clip as rendered.
| Field | Type | Default | Description |
|---|---|---|---|
timeline (required) | textarea | — | Timeline (JSON). width, height (even, ≤ 1920, ≤ 1920×1080 pixels), fps (24/25/30), background (#rrggbb), tracks [{kind: video|image|audio|text, name, gain, muted, hidden, clips:[{src: 1–8, start, in, dur, gain, fadeIn, fadeOut, transition:{kind: crossfade|dip, dur}, mute, fit: contain|cover} or {text, pos: top|center|bottom, size: s|m|l, color, box}]}]. The first track is drawn on top. Reelcraft writes this for you. |
media1 | file | — | Media file 1 (src 1). Video (MP4, MOV, MKV/WebM, AVI, MPEG-TS), audio (MP3, WAV, FLAC, Ogg, M4A, AIFF) or a still (PNG, JPEG, WebP); 189 MB for all files together. Processed in a private temporary folder that is deleted afterwards; the result can be downloaded for about 2 hours. |
media2 | file | — | Media file 2 (src 2) |
media3 | file | — | Media file 3 (src 3) |
media4 | file | — | Media file 4 (src 4) |
media5 | file | — | Media file 5 (src 5) |
media6 | file | — | Media file 6 (src 6) |
media7 | file | — | Media file 7 (src 7) |
media8 | file | — | Media file 8 (src 8) |
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://reelcrafttimelinerender.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
reelcraft_timeline_render - Local stdio connector:
node src/mcp-stdio.ts --tool=reelcraft-timeline-render
{
"mcpServers": {
"reelcraft-timeline-render": { "type": "http", "url": "https://reelcrafttimelinerender.usefulweb.app/mcp" }
}
}