Spine MCP Server
Enables AI agents to drive the Spine 2D animation editor through its CLI: export and import skeleton data, pack and unpack texture atlases, run animation clean-up, open the editor, repair skeleton JSON for import, and compose multiple rigged characters into a single scene with a rendered layout preview.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
engine-mcp
Let an AI agent drive the Spine 2D animation editor, and plug a Godot MCP endpoint into every AI client with one command.
Game-engine tools are built for hands on a mouse. engine-mcp exposes them over the Model Context Protocol so an agent can export, import, pack, repair and compose skeletal animation assets itself, and get back a structured result it can branch on instead of a wall of console text.

A real client session against the server: connect, list tools, compose two characters into one scene, import it into a Spine project.
Status: v0.1, early. Small on purpose.
Features
Spine MCP server: 12 tools over stdio, usable from Claude Desktop, Claude Code, Cursor, Codex CLI or any other MCP client.
Editor lane: wraps the official Spine command-line interface (export, import, texture pack and unpack, animation clean-up, open the editor).
Prep lane: repairs generated skeleton JSON so the Spine 4.x importer accepts it. Converts weighted meshes to unweighted, loose keyframe lists to proper timelines, and 3.x Bezier curves to 4.x form. Pure Python, writes a new file, never touches the source.
Scene lane: merges several rigged characters into one skeleton with prefixed names and re-based mesh bone indices, and renders a layout preview PNG. Pure Python.
Godot connector: a small CLI that checks a Godot MCP addon's HTTP endpoint and registers it with Claude Code, Codex, Grok, Hermes and a project
.mcp.json.One result contract: every tool returns a dict with an
okflag.
Related MCP server: Spine Motion MCP
Quickstart
pip install engine-mcp
engine-mcp-spine --selftestTo run the examples, work from a clone instead:
git clone https://github.com/kurtstaines/engine-mcp.git
cd engine-mcp
pip install -e .
python examples/compose_scene.py--selftest lists the registered tools and reports whether the Spine CLI was found. The example composes two characters into one scene with no Spine install needed.
The sample rig's idle, wave and cheer animations, recorded playing in the Spine editor.
The sample rig
examples/build_rig.py turns one flat character image into a Spine skeleton:
keys out the background and cuts the art into six parts (body, head, upper arms, forearms)
writes
examples/mecha.jsonwith seven bones and region attachmentsgenerates three animations as functions of time, with each part trailing the body a beat late so the idle loop breathes instead of bobbing
The cut lines and joint positions are hand-picked for this one image; it is an example, not a general auto-rigger. The source art was generated with Grok Imagine.

examples/mecha.json imported into a Spine project with spine_import and opened with spine_open_editor: seven bones, six image parts and three animations.
Requirements: Python 3.10+. The editor lane also needs a licensed Spine install; set SPINE_EXE if the CLI is not at C:\Program Files\Spine\Spine.com. The prep, scene and image tools work without it.
Connect an MCP client
Claude Code
claude mcp add spine -- engine-mcp-spineClaude Desktop (claude_desktop_config.json), Cursor, or a project .mcp.json:
{
"mcpServers": {
"spine": {
"command": "engine-mcp-spine",
"env": { "SPINE_EXE": "C:/Program Files/Spine/Spine.com" }
}
}
}With uv installed you can skip the install step and let the client fetch the package: set "command": "uvx" and "args": ["--from", "engine-mcp", "engine-mcp-spine"].
If the client cannot find engine-mcp-spine on its PATH (common when you installed into a virtual environment), point command at that environment's Python and use "args": ["-m", "engine_mcp.spine_server"]. A copy of this config lives in examples/mcp.json.
Variable | Purpose |
| Path to the Spine CLI. Default |
| Optional. Pins the editor version for every call, for example |
Tools
Tool | Inputs | What it does |
| none | Reports the Spine version and the CLI path in use. |
|
| Exports a project or skeleton data. |
|
| Imports skeleton JSON or |
|
| Packs a folder of images into a texture atlas. |
|
| Unpacks a texture atlas back into images. |
|
| Runs Spine's animation clean-up. |
|
| Opens the Spine editor, optionally with a project. Does not block. Spine shows its launcher first and waits for Start unless "Start automatically" is ticked there. The editor closes when the MCP client disconnects. |
|
| Repairs skeleton JSON for the editor importer. Writes |
|
| Reports transparent, opaque and partial alpha percentages and whether the image is already keyed. |
|
| Merges characters into one skeleton. Each character is |
|
| Composites each character's texture at its placement into a layout PNG. |
|
| Imports a composed scene into a |
Godot connector
Needs a Godot project with an MCP addon that serves HTTP from the running editor. Defaults: endpoint http://127.0.0.1:8000/mcp, addon folder addons/godot_ai, server name godot-ai; override with --url, --addon, --name.
engine-mcp-godot --project path/to/godot_project doctor
engine-mcp-godot verify
engine-mcp-godot --clients claude,codex connectCommand | What it does |
| Shows whether the endpoint port is open and which clients are registered. |
| Reports addon install, endpoint liveness and client registration as three separate facts, because each fails for a different reason. |
| Sends a real MCP |
| Registers the endpoint with |
Architecture
flowchart LR
client["MCP client<br/>Claude Desktop, Claude Code, Cursor"]
server["spine_server.py<br/>FastMCP, 12 tools"]
core["spine_core.py"]
cli["Spine CLI"]
json["Skeleton JSON<br/>prep and scene lanes"]
png["Pillow<br/>alpha check, preview"]
connector["godot_connect.py<br/>engine-mcp-godot"]
godot["Godot editor<br/>MCP addon over HTTP"]
configs["Client configs<br/>Claude, Codex, Grok, Hermes, .mcp.json"]
client -- stdio --> server --> core
core -- subprocess --> cli
core --> json
core --> png
connector -- "initialize probe" --> godot
connector -- registers --> configs
client -. "HTTP, after connect" .-> godotThe server is a thin layer: each tool is one call into spine_core, which you can also import directly from a script (see examples/compose_scene.py).
Tests
pip install -e ".[dev]"
pytest24 tests cover the prep, scene and image lanes end to end on a synthetic rig, the MCP tool registration and a tool call round trip, and the Godot connector against a local stand-in HTTP endpoint. The editor lane is tested at the level of the arguments it passes to the Spine CLI; CI does not have Spine installed, so the CLI itself is not exercised there. Registration through the claude and codex CLIs is not covered.
Roadmap
Command-line front door for the Spine tools, for agents without an MCP client
Engine registry and status server (which engine adapters are installed and live)
Bone-marker tool: draw markers on art and save them as rig presets
Automatic rigging lane (image to rigged skeleton)
3D animation workflow for Godot driven through MCP
Contributing
Issues and pull requests are welcome. Before opening a PR:
ruff check . && ruff format --check . && pytestKeep tools returning the {"ok": bool, ...} contract, and add a test for anything that does not need the Spine editor to run.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Render Spine 3.8 skeleton animations to PNG frames or GIF. Pay per call with points.
Create AI animations and export transparent sprite sheets, alpha video, frames, and game assets.
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
Game dev tools: rig 2D characters, fix AI PNGs, pixel art and sprite sheets, palettes, XP curves.
Related MCP Servers
- AlicenseAqualityDmaintenanceAutomates Spine asset pipeline tasks such as export, texture packing, resource validation, and file summarization through the Spine CLI.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables authoring, preview, and export of Spine 2D skeletal animations via natural language from Claude Code or any MCP client, with a web dashboard and tools for keyframing, templates, and GIF preview.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI clients to directly control Spine 3.8.75 animation workflows through 55 MCP tools, including reading projects, editing keyframes, manipulating skeletons, constraints, meshes, atlases, and rendering previews.27 npm28MIT
- FlicenseAqualityBmaintenanceEnables converting layered PSD or PhotoshopToSpine exports into validated Spine 2D rigs, animations, atlases, previews, runtime JSON, and optionally editable .spine projects. It provides MCP tools and an OpenAI/Codex workflow for rigging, animation generation, validation, preview auditing, and batch processing.14-