Get Sequence Structure
get_sequence_structureRetrieve a bounded structural page of the active Premiere sequence to inspect track counts, paged clips, gaps, and metadata before editing.
Instructions
Get a bounded structural page of the active sequence (50 clips by default; follow pagination.nextOffset): all track counts, paged clips with positions, gaps, and clip metadata. Essential for understanding timeline state before making edits.
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_sequence_structure"
}
}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 | Track type to page (default: both). Track counts remain available. | |
| 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. |
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. |