A video in each place's shape
reframe_videoConvert one finished video into platform-ready versions for TikTok, Reels, Shorts, YouTube, X and LinkedIn, with motion-following crops, padded shots, length cuts, loudness targets and covers.
Instructions
Use it when the user wants a video for TikTok, Reels, Shorts, YouTube, X or LinkedIn: vertical, square or 4:5, or cut to a place's length or size. Turns one finished video into the version each place takes, with ffmpeg on this machine: 9:16 for TikTok, Reels and Shorts, 4:5 for the feeds, 1:1, and 16:9 for YouTube, X and LinkedIn. In each shot the crop follows what moves, not faces, and a shot whose action or words are wider than the crop is padded, shown whole on a blurred copy of itself. Each file is cut at a shot change to its place's length, kept under its size limit, set to the loudness asked for, given a cover beside it and checked against the limits the place publishes. FORMATS.md, which the result shows, lists every file with its checks; sheet.png, the picture to show first, draws each shape's window on every shot. A launch film's timeline or a demo's steps file beside the video gives its shots. To move a window, plan first and edit crop.json. For a look at the windows before anything renders, use plan_reframe instead. The reframe playbook (makersmcp_playbook) has the whole job. (reframekit 0.1.3, 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": {
"video": "<video>"
},
"name": "reframe_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| for | No | The places, in one run at most 12: any of tiktok (1080x1920), reels (1080x1920), shorts (1080x1920), youtube (1920x1080), x (1920x1080), linkedin (1920x1080), feed (1080x1350, for the 4:5 feeds), square (1080x1080), all (every one of them, the default), or a size like 1080x1350, even sides of 64 to 4096 pixels from 1:4 to 4:1. | |
| fps | No | The files' frame rate, like 30 or 29.97 (default: the video's own, within what the places take). | |
| pad | No | What a padded shot sits on: blur (default, a blurred, darkened copy of itself), black, white, a color like #0f172a, or brand, the page background of the brand kit given as brand. | |
| crop | No | A crop.json from plan_reframe or an earlier run, edited by hand: its windows are rendered as they are, and a shape it has none of is planned for its shots. It takes no cuts or steps, and no mode but fit. | |
| cuts | No | Every shot change, in place of those found: seconds like 3.2,7.5, or a JSON file of seconds, of frames with their fps like {"fps": 30, "cuts": [96, 225]}, a launch film's film.timeline.json or a demo's steps.json. | |
| lufs | No | The loudness of every file in LUFS (default -14). | |
| mode | No | follow crops each shot where what moves is, and pads a shot a crop would cut (default follow); center crops from the middle; pad shows every shot whole on a blurred copy or a color; fit keeps the picture's own shape and only fits each place's limits. | |
| trim | No | Set to false never to cut a file to its place's length, for an account a place allows more, like TikTok's 10 minutes; FORMATS.md then says the file is over. | |
| brand | No | A brand kit, its folder, brand.json or _brand.yml: padded shots then sit on its page background color. make_brand_kit makes one. | |
| cover | No | The moment each place's cover shows, in seconds like "4.5" or as "0:04.5" (default: picked). | |
| steps | No | The steps.json of the demo this video is, when it is not beside the video under its name: it gives the pages, the page box and each click. | |
| video | Yes | The finished video, any file ffmpeg reads, like film.mp4 from a launch film or demo.mp4 from a demo. The film.timeline.json or steps.json beside it, under its name, gives its shots. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: <video-folder>/reframekit-<video-name>, where <video-name> is the name of video without its extension and <video-folder> is the folder video is in. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. | |
| seconds | No | Keep at most this long in each place's video, cut at a shot change: seconds like "30", or "1:30". | |
| 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 |