MCP Server

Beta. MCP support is an early feature and is still under security review before it is generally available. The entity model below is stable and worth understanding now; the way you connect will firm up as the feature ships. For developers -- if you use the app through its screens, you do not need anything on this page: you navigate by menus, not paths.

Ordinary Animator exposes an MCP server (Model Context Protocol) so an external AI tool such as Claude Code can read and change your production data programmatically. The in-app AI Assistant uses the same addressing scheme under the hood.

The entity path scheme

Every entity is addressed by a hierarchical path. project on its own (no leading slash) lists all your projects; every other path starts with /:

Entity	Path
All projects	project
Project	/project/{projectId}
Episode	/project/{projectId}/episode/{episodeId}
Scene	/project/{projectId}/episode/{episodeId}/scene/{sceneId}
Shot	/project/{projectId}/episode/{episodeId}/scene/{sceneId}/shot/{shotId}
Character	/project/{projectId}/character/{characterId}
Location	/project/{projectId}/location/{locationId}
Prop	/project/{projectId}/prop/{propId}
Agent	/project/{projectId}/agent/{agentId}
Recipe	/project/{projectId}/recipe/{recipeId}
Step	/project/{projectId}/recipe/{recipeId}/step/{stepId}
Idea	/project/{projectId}/idea/{ideaId}
Swimlane	/project/{projectId}/swimlane/{swimlaneId}
Arc	/project/{projectId}/swimlane/{swimlaneId}/arc/{arcId}

These paths mirror the entity hierarchy. A tool uses them to fetch data, create entities, and navigate ("go to character kira"). Start from project to discover your project IDs, then drill down.

Connecting

While MCP support is in beta there is no public, per-user hosted endpoint yet. The server currently runs as part of the agent service in a dev mode, scoped to a single user -- so today you connect by running the agent service yourself. A hosted, per-account connection is planned once the security review is complete.

See Entities & the Data Model for the concepts behind the hierarchy and the property model.