Vidova Cursor MCP quickstart

This path assumes Vidova is running, Local MCP is on, and a project is open in the editor. Install steps are on the overview.

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:

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

cursorStyle is an enum on vidovaSettings. 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, preview.