Read Video Scopes
read_video_scopesRead sampled waveform and RGB parade percentiles, saturation, and near-black/near-white occupancy from a decoded local video frame to check exposure and color levels without Premiere-rendered scopes.
Instructions
Read waveform percentiles, RGB parade percentiles, saturation, and near-black/near-white RGB occupancy from one bounded decoded local-media frame. Read-only; this is a sampled analytical proxy, not Premiere's rendered scopes.
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": {
"media_path": "<media_path>"
},
"name": "read_video_scopes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_path | Yes | Existing local video file | |
| time_seconds | No | Source-relative frame time from 0 through 86400 seconds (default: 0) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. |