# Vidova Cursor MCP quickstart

Open a Vidova project from Cursor or Claude, read the timeline, capture a preview, and set vidovaSettings.cursorStyle to banana.

This path assumes Vidova is running, Local MCP is on, and a project is open in the editor. Install steps are on the [overview](/docs/mcp).

## 1. Confirm the project

Call `get_active_project`. If nothing is active, call `list_projects` and then `set_active_project` with that `projectId`.

Editor tools fail until the matching editor window is open.

## 2. Read the timeline

Call `timeline_get_state`. Use the clip ids and layer ids it returns. Do not invent ids.

## 3. Capture one preview

Call `preview` with `action` `captureFrame` and `timecode` `0` (zero is valid). Confirm the composition rendered before you edit.

## 4. Change a screen-recording clip

This is a real `timeline_edit` call that sets the banana cursor on a Vidova clip:

```json
{
  "action": "updateClip",
  "clipId": "CLIP_ID_FROM_STATE",
  "vidovaSettings": {
    "cursorStyle": "banana"
  }
}
```

`cursorStyle` is an enum on [vidovaSettings](/docs/mcp/schemas/vidova-settings). `banana` is a valid value. There is no `vidova_set_cursor` tool.

After the edit, capture `preview` `captureFrame` again at a timecode where the cursor is visible.

## 5. Page large results

If a tool result is truncated, pass `resultStart` and `resultEnd`. The window is at most 8000 characters. Increment `resultStart` by 8000 to read the next window.

Full field lists: [timeline_edit](/docs/mcp/tools/timeline_edit), [preview](/docs/mcp/tools/preview).