Subtitle files from words with times
make_subtitlesGenerates SRT, VTT, and ASS subtitle files from timed speech-to-text words or existing caption files while leaving the video unchanged.
Instructions
Use it when the user wants an SRT, VTT or ASS subtitle file for a video. Writes subtitle files from words with times the user already has, and changes no video: captions.srt and captions.vtt, lines of up to 42 characters for any player or place that takes a captions file, captions.ass with the font, the colors and the place, laid out for the frame of the video given (else a phone's for tiktok, reels or shorts, a square for square alone, and 16:9 for the rest), and words.json, captions.json and CAPTIONS.md, which the result shows with how fast the captions read. The words are a speech-to-text JSON, an SRT or WebVTT file, or a demo's steps file, whose step notes become the captions; without video, a demo's captions end where its steps file says the video does. To burn the captions into the video, use caption_video instead. The captions playbook (makersmcp_playbook) has the whole job. (easycaptionkit 0.1.4, on this machine.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"words": "<words>"
},
"name": "make_subtitles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| box | No | A dark box behind the words in captions.ass instead of an outline. | |
| for | No | The places the video goes to, whose free space captions.ass keeps to (default: the places of the video's shape, or of the frame laid out). | |
| font | No | A font family for captions.ass, like Inter. | |
| size | No | The letters' size in captions.ass, in percent of a phone's width or of the frame's short side, 2 to 20 (default 6.5, or 9.5 for the word style). | |
| brand | No | A brand kit, its folder or brand.json, for captions.ass's highlight color and font. make_brand_kit makes one. | |
| fonts | No | A font kit, its folder or fonts.css, for captions.ass's font. make_font_kit makes one. | |
| lines | No | Lines a caption may take, 1 to 3 (default 2). | |
| style | No | How captions.ass shows them: karaoke lights the word being spoken (default karaoke), line shows whole captions, word one word at a time. | |
| video | No | The video the subtitles are for, read for its size and length only. | |
| words | Yes | The words and their times: a speech-to-text JSON, an SRT or WebVTT file, a demo's steps.json, or the words.json of an earlier run with a misheard word fixed by hand. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: <words-folder>/easycaptionkit-subtitles-<words-name>, where <words-name> is the name of words without its extension and <words-folder> is the folder words is in. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. | |
| position | No | Where in the free space captions.ass puts them (default bottom). | |
| highlight | No | The spoken word's color in captions.ass, like #ffd23f. | |
| max_chars | No | Characters a line of captions.srt and captions.vtt may take, 8 to 80 (default 42); captions.ass cuts its lines to what fits across its frame. | |
| wait_seconds | No | How long to wait for the result, counted from the start of the call, before returning a job_id to wait on. Some clients end a call after 60 or 240 seconds; 45 is safe in all of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| docs | No | The notes the text shows, and where each one is. | |
| next | No | What to do next, as the Next line says. | |
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| continued | No | True when this call continued the job of an identical call whose answer did not reach the client, instead of starting another. | |
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |