# Vidova docs
> Local desktop editor MCP. Start at the overview, then fetch one tool page.

## Docs
- [Vidova documentation](https://vidova.ai/docs.md): Local MCP for the Vidova desktop editor, plus custom elements authored with @vidova/2d, @vidova/core, and @vidova/components.
- [Custom elements](https://vidova.ai/docs/custom-elements.md): A custom element is a TSX class that extends Node. It compiles into a component asset and plays on a type=component clip.
- [Custom element quickstart](https://vidova.ai/docs/custom-elements/quickstart.md): Write a Node subclass with @vidova/2d, implement animateIn and animate, then place it with component create and timeline_edit addClip.
- [Vidova MCP](https://vidova.ai/docs/mcp.md): Connect Cursor, Claude Code, Codex, or Windsurf to the local Vidova desktop editor at http://127.0.0.1:17373/mcp.
- [@vidova packages](https://vidova.ai/docs/custom-elements/packages.md): Custom elements import @vidova/2d for nodes and JSX, @vidova/core for signals and tweens, and @vidova/components for built-in scene nodes.
- [Vidova Cursor MCP quickstart](https://vidova.ai/docs/mcp/quickstart.md): Open a Vidova project from Cursor or Claude, read the timeline, capture a preview, and set vidovaSettings.cursorStyle to banana.
- [Authoring a custom element](https://vidova.ai/docs/custom-elements/authoring.md): Define a props interface with SignalValue, extend Node, wire @initial and @signal, add children in the constructor, then implement animateIn and animate.
- [Vidova MCP architecture](https://vidova.ai/docs/mcp/architecture.md): Localhost Streamable HTTP MCP at 127.0.0.1:17373, no HTTP auth, 1MB body, 5 minute timeout, 8000-character result windows, and grouped-tool passthrough.
- [Component inputs](https://vidova.ai/docs/custom-elements/inputs.md): inputDefs are static inspector values. Asset inputs store IDs on the clip and resolve to playback URLs or VidovaClipData before they reach the class.
- [Signals](https://vidova.ai/docs/custom-elements/signals.md): Class props are signals. Read with label(), write with label(value), tween with yield* label(next, duration). Bind children with () => this.label().
- [Vidova MCP tools](https://vidova.ai/docs/mcp/tools.md): Index of every published Vidova Local MCP tool, including timeline_edit, generate_asset, and project tools.
- [Layout](https://vidova.ai/docs/custom-elements/layout.md): Do not shadow Node methods, do not flex-size to unmeasured text, match anchors to coordinates, and keep sizes proportional to the frame.
- [Shaders](https://vidova.ai/docs/custom-elements/shaders.md): SkSL runtime effects on cached nodes. Include the common prelude or wrap the body with withCommonShader. Not GLSL.
- [Animation](https://vidova.ai/docs/custom-elements/animation.md): animate() is the timeline entry point. animateIn() is the intro. Use generator functions, yield*, all, and tween. Keep fontSize a positive constant.
- [Vidova MCP patterns](https://vidova.ai/docs/mcp/patterns.md): Preview-and-iterate, silence removal, zooms, vidovaSettings cursor, components, hosted image and speech polling, and recipe search.
- [Vidova MCP use cases](https://vidova.ai/docs/mcp/use-cases.md): Product jobs for Vidova Local MCP: clean a screen recording, restyle a cursor, add zooms, place a title, and generate a still.
- [Vidova MCP dos and don'ts](https://vidova.ai/docs/mcp/dos-and-donts.md): Hard rules for Vidova Local MCP from editor skills and tests. Read timeline state before ids. Never invent silence timestamps. Never use type=text.
- [Vidova MCP quotas](https://vidova.ai/docs/mcp/quotas.md): Local Vidova MCP tools do not use hosted quota. generate_asset image is metered. Speech and transcription use included rolling quotas.
- [Tools not in Vidova MCP](https://vidova.ai/docs/mcp/not-in-mcp.md): Retired and advertised-but-unreachable names. Do not call web_research, vidova_set_cursor, or generate_asset kinds music and video.

## Optional
- [Vidova MCP schemas](https://vidova.ai/docs/mcp/schemas.md): Nested objects used by Vidova MCP, including vidovaSettings, perspective, zooms, and scene config.
- [list_projects MCP tool](https://vidova.ai/docs/mcp/tools/list_projects.md): List all projects stored by this local Vidova desktop app.
- [get_active_project MCP tool](https://vidova.ai/docs/mcp/tools/get_active_project.md): Show which local Vidova project MCP is currently targeting.
- [create_project MCP tool](https://vidova.ai/docs/mcp/tools/create_project.md): Create a new empty local Vidova project and set it as the active project.
- [set_active_project MCP tool](https://vidova.ai/docs/mcp/tools/set_active_project.md): Set which local Vidova project MCP should target for editor tool calls.
- [timeline_get_state MCP tool](https://vidova.ai/docs/mcp/tools/timeline_get_state.md): Get the current state of the project timeline: all layers, clips, positions, and properties.
- [timeline_edit MCP tool](https://vidova.ai/docs/mcp/tools/timeline_edit.md): Edit the timeline.
- [clip_enhance MCP tool](https://vidova.ai/docs/mcp/tools/clip_enhance.md): Zooms and chroma key.
- [asset MCP tool](https://vidova.ai/docs/mcp/tools/asset.md): Project assets.
- [inspect_media MCP tool](https://vidova.ai/docs/mcp/tools/inspect_media.md): Look at project media.
- [import_asset MCP tool](https://vidova.ai/docs/mcp/tools/import_asset.md): Bring media into the project.
- [preview MCP tool](https://vidova.ai/docs/mcp/tools/preview.md): Look at the live timeline.
- [generate_asset MCP tool](https://vidova.ai/docs/mcp/tools/generate_asset.md): Start or poll hosted generation.
- [sfx MCP tool](https://vidova.ai/docs/mcp/tools/sfx.md): Search and import sound effects.
- [component MCP tool](https://vidova.ai/docs/mcp/tools/component.md): Custom components and scene config.
- [branch_action MCP tool](https://vidova.ai/docs/mcp/tools/branch_action.md): Project branches.
- [project_history MCP tool](https://vidova.ai/docs/mcp/tools/project_history.md): Get edit history, or perform undo/redo.
- [recipe MCP tool](https://vidova.ai/docs/mcp/tools/recipe.md): Reusable playbooks.
- [sleep MCP tool](https://vidova.ai/docs/mcp/tools/sleep.md): Wait for a specified number of seconds before continuing.
- [cameraSettings schema](https://vidova.ai/docs/mcp/schemas/camera-settings.md): Field specification for the cameraSettings object used by Vidova MCP tools.
- [captionSettings schema](https://vidova.ai/docs/mcp/schemas/caption-settings.md): Field specification for the captionSettings object used by Vidova MCP tools.
- [chromaKey schema](https://vidova.ai/docs/mcp/schemas/chroma-key.md): Field specification for the chromaKey object used by Vidova MCP tools.
- [clipTransition schema](https://vidova.ai/docs/mcp/schemas/clip-transition.md): Field specification for the clipTransition object used by Vidova MCP tools.
- [colorGrading schema](https://vidova.ai/docs/mcp/schemas/color-grading.md): Field specification for the colorGrading object used by Vidova MCP tools.
- [cursorSpotlight schema](https://vidova.ai/docs/mcp/schemas/cursor-spotlight.md): Field specification for the cursorSpotlight object used by Vidova MCP tools.
- [focus schema](https://vidova.ai/docs/mcp/schemas/focus.md): Field specification for the focus object used by Vidova MCP tools.
- [keyframeAction schema](https://vidova.ai/docs/mcp/schemas/keyframe-action.md): Field specification for the keyframeAction object used by Vidova MCP tools.
- [vidovaSettings.mouseIndicator schema](https://vidova.ai/docs/mcp/schemas/mouse-indicator.md): Field specification for the vidovaSettings.mouseIndicator object used by Vidova MCP tools.
- [normalizedVector schema](https://vidova.ai/docs/mcp/schemas/normalized-vector.md): Field specification for the normalizedVector object used by Vidova MCP tools.
- [perspective schema](https://vidova.ai/docs/mcp/schemas/perspective.md): Field specification for the perspective object used by Vidova MCP tools.
- [setSceneConfig schema](https://vidova.ai/docs/mcp/schemas/set-scene-config.md): Field specification for the setSceneConfig object used by Vidova MCP tools.
- [vector schema](https://vidova.ai/docs/mcp/schemas/vector.md): Field specification for the vector object used by Vidova MCP tools.
- [vidovaSettings.camera schema](https://vidova.ai/docs/mcp/schemas/vidova-camera.md): Field specification for the vidovaSettings.camera object used by Vidova MCP tools.
- [vidovaSettings.crop schema](https://vidova.ai/docs/mcp/schemas/vidova-crop.md): Field specification for the vidovaSettings.crop object used by Vidova MCP tools.
- [vidovaSettings schema](https://vidova.ai/docs/mcp/schemas/vidova-settings.md): Field specification for the vidovaSettings object used by Vidova MCP tools.
- [zoomDepth schema](https://vidova.ai/docs/mcp/schemas/zoom-depth.md): Field specification for the zoomDepth object used by Vidova MCP tools.
- [zoomSegment schema](https://vidova.ai/docs/mcp/schemas/zoom-segment.md): Field specification for the zoomSegment object used by Vidova MCP tools.