# timeline_get_state MCP tool

Get the current state of the project timeline: all layers, clips, positions, and properties.

{/* Generated by landing/scripts/generate-mcp-docs.ts. Do not edit. */}

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.