Skip to main content
Glama

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 <---> Cavalry

The 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 build

Configure 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

cavalry_ping

Check if Cavalry + Stallion are reachable

cavalry_run_script

Execute arbitrary JavaScript in Cavalry

cavalry_create_layer

Create a layer (textShape, basicShape, null, etc.)

cavalry_set_attribute

Set attributes on a layer

cavalry_get_attribute

Read an attribute value

cavalry_connect

Connect attributes between layers

cavalry_keyframe

Set a keyframe at a specific frame

cavalry_magic_easing

Apply easing to keyframed attributes

cavalry_get_scene_layers

List all layers in the scene

cavalry_get_selected_layers

Get currently selected layers

cavalry_select_layers

Select layers by ID

cavalry_delete_layers

Delete layers by ID

cavalry_get_composition_info

Get resolution, frame range, FPS

cavalry_set_current_frame

Move the playhead

cavalry_render_png

Render current frame as PNG

cavalry_set_generator

Set a generator on a layer (ellipse, rectangle, etc.)

cavalry_duplicate_layer

Duplicate a layer

cavalry_get_bounding_box

Get a layer's bounding box

cavalry_save_scene

Save the scene

cavalry_open_scene

Open a .cv scene file

cavalry_add_dynamic_attribute

Add a dynamic attribute to a layer

Example conversation

You: Create a bouncing text that says "Hello World"

Claude will:

  1. Create a textShape layer

  2. Set the text content, font size, and color

  3. Add position keyframes for the bounce

  4. 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 position

  • rotation — Rotation in degrees

  • scale.x, scale.y — Scale

  • opacity — Layer opacity (0–100)

  • fontSize — Text layer font size

  • fill.color — Fill color (hex string)

  • stroke.color, stroke.width — Stroke properties

License

MIT

Available Tools

21 tools
cavalry_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

    A3.7/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers