Grab a frame
grab_frameExtract a frame from a local video at a specified timestamp and return it as a viewable image; optionally save the full-resolution frame as JPG, PNG, or WebP for inspection or export.
Instructions
Return the frame at a timestamp as an image you can look at (e.g. 'what's on screen at 1:23?', 'is the logo legible here?'). Optionally also save it at full resolution as JPG, PNG or WebP.
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": "grab_frame"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Time: seconds, "MM:SS", "HH:MM:SS.mmm" or "50%". | 50% |
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| format | No | jpeg | |
| max_width | No | Width of the returned preview image. | |
| overwrite | No | ||
| save_path | No | Also save the frame at full resolution here (.jpg, .png or .webp). |