MCP Server
Expose the RemotionUI registry to agents as MCP tools.
remotion-ui-mcp is a Model Context Protocol server that exposes the RemotionUI registry as agent-callable tools over stdio. It reuses the CLI's registry client, so results match remotion-ui search, view, and add exactly.
Use it when your agent should discover components on its own. For installing them, the agent still runs the CLI — the server returns the command, it does not write files.
Tools
| Tool | Input | Returns |
|---|---|---|
list-components | registryUrl? | The full registry index |
search-components | query?, lane?, tier?, registryUrl? | Matching index entries |
get-component-detail | name, preset?, registryUrl? | The full registry item — files, dependencies, composition, compat |
get-install-command | name | npx remotion-ui@latest add <name> |
Lanes: atoms, signals, vectors, spatial, blocks, cuts, reels. Tiers: core, advanced.
Failures come back as isError results carrying the same { code, message } envelope as the CLI's --json mode. See Error codes.
Install
The server is not published to npm standalone yet. Build it from a monorepo checkout and point your MCP client at the built entrypoint.
git clone https://github.com/riaz37/remotion-ui
cd remotion-ui && pnpm install
pnpm --filter remotion-ui-mcp buildThat produces packages/remotion-ui-mcp/dist/index.js.
Claude Code
Add to .mcp.json in your project root:
{
"mcpServers": {
"remotion-ui": {
"command": "node",
"args": ["/absolute/path/to/remotion-ui/packages/remotion-ui-mcp/dist/index.js"]
}
}
}Other MCP clients
Point any stdio-capable client at the same command. Claude Desktop uses the same command / args shape in its config file.
Agent workflow with MCP
search-componentsorlist-componentsto find a fit.get-component-detailto read files, dependencies, and composition metadata.get-install-command, then run it with the CLI.- Import from local source paths — never from the
remotion-uinpm package.
The agent skill encodes the same workflow for agents that do not speak MCP. See AI Usage for the plain HTTP endpoints (/llms.txt, /ai/components.json).