timeline_get_state MCP tool

MCP name timeline_get_state dispatches to renderer getTimelineState.

Does not use hosted quota. Local editor operation.

Get the current state of the project timeline: all layers, clips, positions, and properties. Editor must be open. Does not use hosted quota. Local editor operation.

Advertised MCP input

The MCP server validates this object with .strict(). Unknown fields are rejected.

Field	Type	Required	Constraints	Default	Description
includeClipDetails	boolean	no	—	true	Whether to include detailed clip information
resultStart	integer	no	min 0; max 9007199254740991	0	First character offset to return. Use 0 for the first call.
resultEnd	integer	no	min 1; max 9007199254740991	8000	Exclusive end offset. resultEnd - resultStart must be at most 8000. Increment resultStart by 8000 to page through large results.

Renderer schema

Authoritative input the editor applies after MCP passthrough or dispatch.

Field	Type	Required	Constraints	Default	Description
includeClipDetails	boolean	no	—	true	Whether to include detailed clip information

Result window

Every local MCP tool accepts resultStart and resultEnd so large payloads can be paged.

• resultStart — first character offset. Default 0.
• resultEnd — exclusive end offset. Default 8000.
• resultEnd - resultStart must be at most 8000 characters.
• Increment resultStart by 8000 to read the next window.