Make a thumbnail
make_thumbnailExport platform-sized thumbnails from a video by auto-picking the sharpest, best-exposed frame or using a specific timestamp, then crop to the target aspect ratio.
Instructions
Export a thumbnail sized for a platform (YouTube 1280x720, Reels/TikTok/Shorts cover 1080x1920, Instagram grid 3:4, feed 4:5, square, X, LinkedIn). Give at to use a specific frame, or leave it out and the tool samples the video, rejects black/white/flat frames, and picks the sharpest, best-exposed one — returning the top candidates so you can choose a different one. Crops to the aspect ratio with an adjustable anchor.
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": {
"path": "<path>"
},
"name": "make_thumbnail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Use the frame at this time instead of auto-picking. | |
| end | No | Only look up to this time. | |
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| start | No | Only look from this time on. | |
| width | No | Custom width (overrides preset). | |
| height | No | Custom height (overrides preset). | |
| preset | No | Size preset: youtube, youtube_shorts, instagram_reels_cover, instagram_grid, instagram_feed, tiktok_cover, square, x, linkedin | youtube |
| quality | No | ||
| anchor_x | No | Horizontal crop anchor: 0 keeps the left edge, 1 the right. | |
| anchor_y | No | Vertical crop anchor: 0 keeps the top, 1 the bottom. | |
| overwrite | No | ||
| candidates | No | Frames to evaluate when auto-picking. | |
| output_path | No | Defaults to <name>_<preset>_thumb.jpg next to the video. .jpg, .png or .webp. | |
| show_candidates | No | Return this many runner-up frames as small images. |