Get Timeline Gaps
get_timeline_gapsFind gaps between timeline clips to identify missing content or spots where clips can be tightened. Returns a paginated list with offsets for further inspection.
Instructions
Find a bounded page of gaps (50 by default; follow pagination.nextOffset) on the timeline between clips. Useful for identifying where content is missing or where clips can be tightened.
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": "get_timeline_gaps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip_limit | No | Page size (default: 50, maximum: 200). Payload budget may shorten a page. Inspect nextOffset. | |
| track_type | No | Which track type to analyze (default: both) | |
| clip_offset | No | Offset into matching clips (matching gaps for get_timeline_gaps), video before audio (default: 0). | |
| end_seconds | No | Optional exclusive window end; must exceed start_seconds. | |
| sequence_id | No | Sequence name or ID. Uses active sequence if omitted. | |
| track_index | No | Optional zero-based track index within each selected type. | |
| start_seconds | No | Optional inclusive window start; returns overlapping items. | |
| min_gap_seconds | No | Minimum gap duration in seconds to report (default: 0.04 = ~1 frame at 24fps) |
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. |