describe_frame
Capture the current video frame as a downscaled image, optionally seeking to a specific position first, so you can inspect what is on screen.
Instructions
Return the frame showing right now as an image, so you can see what is on screen. Optionally seek to a position first. The picture is the one the viewer is watching — GUI, CLI and MCP share a single player. Downscaled to keep the response small; subtitles and on-screen controls are not burned in.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "describe_frame"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_edge | No | Longest edge in pixels (64-2048, default 768) | |
| position | No | Seek here (seconds) before capturing |