Cavalry MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cavalry MCP Create a bouncing text that says 'Hello World'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
cavalry-mcp
MCP server that connects Claude to Cavalry animation software. Create layers, set attributes, animate with keyframes, render frames, and more — all through natural language.
How it works
Claude <--MCP (stdio)--> cavalry-mcp <--HTTP POST--> Stallion <---> CavalryThe MCP server sends JavaScript to Cavalry via the Stallion bridge (an HTTP server running inside Cavalry on 127.0.0.1:8080).
Related MCP server: MCP-Claude-AI Server
Prerequisites
Cavalry (with Stallion script enabled: Scripts > Stallion)
Node.js >= 18
Setup
npm install
npm run buildConfigure in Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"cavalry": {
"command": "node",
"args": ["/absolute/path/to/cavalry-mcp/dist/index.js"]
}
}
}Available tools
Tool | Description |
| Check if Cavalry + Stallion are reachable |
| Execute arbitrary JavaScript in Cavalry |
| Create a layer (textShape, basicShape, null, etc.) |
| Set attributes on a layer |
| Read an attribute value |
| Connect attributes between layers |
| Set a keyframe at a specific frame |
| Apply easing to keyframed attributes |
| List all layers in the scene |
| Get currently selected layers |
| Select layers by ID |
| Delete layers by ID |
| Get resolution, frame range, FPS |
| Move the playhead |
| Render current frame as PNG |
| Set a generator on a layer (ellipse, rectangle, etc.) |
| Duplicate a layer |
| Get a layer's bounding box |
| Save the scene |
| Open a .cv scene file |
| Add a dynamic attribute to a layer |
Example conversation
You: Create a bouncing text that says "Hello World"
Claude will:
Create a textShape layer
Set the text content, font size, and color
Add position keyframes for the bounce
Apply BounceOut easing
Common layer types
basicShape, textShape, null, colorPlane, group, subMesh, linearGradient, duplicator, connectShape, noiseDeformer, stagger, trail, javaScriptUtility, javaScriptShape, imageAsset, videoAsset, soundAsset
Common attribute paths
position.x,position.y— Layer positionrotation— Rotation in degreesscale.x,scale.y— Scaleopacity— Layer opacity (0–100)fontSize— Text layer font sizefill.color— Fill color (hex string)stroke.color,stroke.width— Stroke properties
License
MIT
Available Tools
21 toolscavalry_add_dynamic_attributeA
Add a dynamic attribute to a layer (e.g., on a JavaScript Utility). Types: "int", "double", "bool", "string", "color", "int2d", "double2d", "position2d".
Inputs: layerId (required), attrName (required), attrType (required).
cavalry_connectA
Connect an output attribute to an input attribute between layers. Use "id" as the outAttr to connect a layer's main output.
Inputs: sourceAttr (required), targetAttr (required), sourceLayerId (required), targetLayerId (required), +1 more.
cavalry_create_layerA
Create a new layer in the Cavalry scene. Common layer types: basicShape, textShape, null, colorPlane, ellipse, rectangle, group, subMesh, linearGradient, cameraRig, pathfinder, duplicator, connectShape, noiseDeformer, meshDeformer, stagger, trail, spreadsheet, csvAsset, soundAsset, imageAsset, videoAsset, javaScriptUtility, javaScriptShape.
Inputs: name (required), layerType (required).
cavalry_delete_layersA
Delete layers from the Cavalry scene by their IDs.
Inputs: layerIds (required).
cavalry_duplicate_layerB
Duplicate a layer in the scene.
Inputs: layerId (required).
cavalry_get_attributeA
Read the value of an attribute from a Cavalry layer.
Inputs: layerId (required), attrPath (required).
cavalry_get_bounding_boxA
Get the bounding box of a layer (useful for positioning).
Inputs: layerId (required).
cavalry_get_composition_infoA
Get information about the active composition (resolution, frame range, FPS).
Inputs: no named parameters.
cavalry_get_scene_layersA
Get a list of all layers in the current Cavalry scene with their IDs and types.
Inputs: no named parameters.
cavalry_get_selected_layersA
Get the currently selected layers in Cavalry.
Inputs: no named parameters.
cavalry_keyframeB
Set a keyframe on a layer attribute at a specific frame.
Inputs: frame (required), layerId (required), attributes (required).
cavalry_magic_easingA
Apply Magic Easing to a keyframed attribute. Easing types include: EaseIn, EaseOut, EaseInOut, BounceIn, BounceOut, BounceInOut, ElasticIn, ElasticOut, ElasticInOut, BackIn, BackOut, BackInOut, Linear.
Inputs: frame (required), layerId (required), attrPath (required), easingType (required).
cavalry_open_sceneB
Open a Cavalry scene file (.cv).
Inputs: filePath (required).
cavalry_pingA
Check if Cavalry is running and the Stallion bridge is reachable
Inputs: no named parameters.
cavalry_render_pngA
Render the current frame as a PNG file.
Inputs: filePath (required), scale.
cavalry_run_scriptA
Execute arbitrary JavaScript in Cavalry's JavaScript Editor. Use Cavalry's api, cavalry, and ui namespaces. This is the most flexible tool — use it when no specialized tool fits.
Inputs: code (required).
cavalry_save_sceneA
Save the current Cavalry scene. Optionally save to a new path.
Inputs: filePath.
cavalry_select_layersB
Select specific layers in Cavalry by their IDs.
Inputs: layerIds (required).
cavalry_set_attributeA
Set one or more attributes on a Cavalry layer. Attributes use dot-notation paths, e.g. "position.x", "fontSize", "fill.color".
Inputs: layerId (required), attributes (required).
cavalry_set_current_frameA
Set the playhead to a specific frame in the timeline.
Inputs: frame (required).
cavalry_set_generatorA
Set a generator on a layer. For example, set a Basic Shape to use an ellipse or rectangle generator. Use api.getGenerators(layerId) to discover available generators.
Inputs: layerId (required), generatorId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a distinct operation (create, get, set, delete, etc.) with clear resource categories (layer, attribute, scene, composition). The catch-all run_script explicitly notes it's for cases where no specialized tool fits, reducing ambiguity. No two tools appear to serve the same purpose.
All tools share the cavalry_ prefix and mostly use verb_noun (create_layer, get_attribute, save_scene). A few deviate: 'keyframe' and 'magic_easing' are noun-like commands rather than verb phrases, but the overall pattern is consistent enough.
With 21 tools, the set is substantial but not bloated. It covers the primary workflow of creating, manipulating, animating, and rendering scenes. No redundant tools; each offers distinct functionality. Slightly heavy but appropriate for a professional design tool.
The tools cover scene lifecycle (open/save), layer CRUD, attribute reading/writing, animation (keyframes/easing), composition info, and rendering. Missing advanced features like undo or asset management, but the core workflows are fully supported. The run_script escape hatch fills niche gaps.
Maintenance
Related MCP Connectors
Make animated videos by asking Claude, Cursor or any MCP client. Your AI writes it, we render it.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
MCP server for Hailuo (MiniMax) AI video generation
AI video, image and audio generation with 140+ AI models from any MCP agent
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables control of Adobe After Effects via natural language, allowing project manipulation, layer creation, animation, and rendering through MCP.72MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-assisted 3D scene manipulation in Cinema 4D via natural language, using an MCP server that communicates with a C4D plugin.MIT
- FlicenseBqualityDmaintenanceMCP server for driving Cavalry's 2D motion-graphics engine from LLMs, enabling scene creation and animation via natural language.283-
- AlicenseBqualityDmaintenanceMCP server that lets AI assistants control Adobe After Effects via natural language, enabling composition and layer creation, animation, effects, presets, rendering, and arbitrary ExtendScript execution with Arabic/RTL support.50182 npmMIT