spine-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SPINE_CLI_PATH | No | Path to a specific Spine CLI installation (e.g. Spine.com / SpineTrial.com on Windows, Spine.app on macOS, Spine.sh on Linux). Optional; the server otherwise auto-detects the Spine CLI. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| spine_doctorA | Check the environment: Python/MCP SDK versions, detected Spine CLI paths and versions. Call this first when export or import fails, or to discover whether the Spine editor is installed and usable from the command line. |
| spine_list_projectsA | Find Spine files under a directory: binary .spine editor projects (type "project") and Spine skeleton JSON (type "json", with version and counts). Other JSON is skipped. Args: root: Directory to scan (absolute or relative to the server working directory). include_json: Also look at .json files (default true). limit: Maximum number of results (1-2000). |
| spine_inspectA | Read a .spine/.json file and return its structure: version, bone tree, slots, skins, attachment counts by type, animations with durations and events. Args: project: Path to a .spine project or exported Spine JSON. detail: "summary" (default) or "full" to include every animation track. |
| spine_validateA | Validate a Spine JSON project offline: duplicate names, missing parents, bones listed after their parent, unknown slot bones, malformed attachments, timelines pointing at missing bones/slots/events, unsorted keyframes and curves. Returns {"ok": bool, "errors": [...], "warnings": [...], "stats": {...}}. |
| spine_create_projectA | Create a new Spine 4.x skeleton JSON file containing a single "root" bone. Args: project: Target path ending in .json (the editor's .spine format is binary; convert the JSON into a real project with spine_import_data). name: Skeleton name (defaults to the file name). width: Skeleton bounds width reported in the skeleton section. height: Skeleton bounds height reported in the skeleton section. spine_version: Version string written to skeleton.spine (default 4.3.00 or $SPINE_VERSION). images: Image folder stored in skeleton.images. audio: Audio folder stored in skeleton.audio. overwrite: Replace an existing file. |
| spine_add_boneC | Add a setup-pose bone. The bone is inserted after its parent's subtree so that "parents always come first" stays valid. Returns the resulting bone tree. Args:
inherit: normal, onlyTranslation, noRotationOrReflection, noScale or noScaleOrReflection.
transform: Deprecated alias of |
| spine_add_slotA | Add a draw-order slot attached to an existing bone. Slots are drawn in list order (later slots on top). Use Args: attachment: Name of the setup-pose attachment (must exist in a skin). color: RRGGBB or RRGGBBAA setup color. dark: 6-digit dark color for two-color tinting. blend: normal, additive, multiply or screen. |
| spine_add_attachmentA | Attach something to a slot inside a skin (registration + optional setup assignment). Kinds:
Args: assign: Also set this attachment as the slot's setup-pose attachment. skin: Skin to put the attachment in (created if missing). |
| spine_add_animationB | Create an empty animation. Add keyframes afterwards with spine_set_keyframes. |
| spine_set_keyframesA | Add or replace keyframes of one timeline (the animation is created if missing). Timelines and their key fields (written in the Spine 4.x JSON format):
Curves: every key accepts "curve": "linear" (default), "stepped", a preset
("ease", "ease-in", "ease-out", "ease-in-out", "smooth") or [cx1, cy1, cx2, cy2]
normalized to the interval up to the next key (0..1, like CSS cubic-bezier).
They are converted to Spine's absolute bezier values automatically and keep their
shape when keys are added later. The Args: target: Bone name for bone timelines, slot name for slot timelines, constraint name for ik/transform/path/physics. Ignored for event/drawOrder. mode: upsert (default: merge, new keys win at equal times), append (merge, error on equal times) or replace (the whole timeline). |
| spine_add_eventC | Define a named event (setup-pose values) that animations can trigger. Args: int_value: Integer payload. float_value: Float payload. string: String payload. audio: Audio path played by the event. volume: Audio volume (default 1). balance: Stereo balance, -1..1 (default 0). |
| spine_delete_animationB | Remove an animation (e.g. before regenerating it). Other animations are untouched. |
| spine_delete_keyframesA | Remove keys from one timeline: the keys at Args: timeline: Same names as spine_set_keyframes (rotate, translate, attachment, event, drawOrder, ik...). target: Bone, slot or IK constraint name (empty for event/drawOrder). |
| spine_duplicate_animationB | Copy an animation under a new name (e.g. "walk" -> "walk-fast" before retiming it). |
| spine_update_boneA | Change an existing bone's setup pose. Only the arguments you pass are changed.
|
| spine_update_slotA | Change an existing slot. Only the arguments you pass are changed. Args: new_name: Rename the slot everywhere (skins, animations, draw order keys, path constraints). bone: Move the slot to another bone. attachment: Setup-pose attachment; "" clears it (the slot starts empty). color: RRGGBB(AA) setup color; "" resets to white. dark: RRGGBB dark color for two-color tinting; "" removes it. blend: normal, additive, multiply or screen. index: New draw-order position (0 = drawn first / at the back). |
| spine_deleteB | Delete a bone, slot, attachment, event, constraint, animation or skin and clean up everything that refers to it (timelines, draw order keys, constraints, skin entries). Args: kind: bone, slot, attachment, event, constraint, animation or skin. slot: Required for kind="attachment". skin: Skin of the attachment (kind="attachment"). cascade: For bones: also delete child bones and their slots (otherwise refused if any exist). |
| spine_add_ik_constraintA | Add an IK constraint: 1 bone points at the target, 2 bones (parent, direct child) bend like a limb so the child's tip reaches the target. Animate it with timeline "ik". Args:
bones: [bone] or [upper, lower], e.g. ["thigh", "shin"].
target: Bone to reach (must not be one of |
| spine_add_transform_constraintA | Add a transform constraint: Args:
properties: What to copy, any of rotate, x, y, scaleX, scaleY, shearY (default all).
mix: 0..1 influence per property, e.g. {"rotate": 1, "x": 0.5} (default 1).
offsets: Constant offsets per property, e.g. {"rotate": 90, "x": 10}.
local: Use local instead of world transforms.
additive: Add to the bones' own transform instead of replacing it (4.2: "relative").
clamp: (4.3) Clamp converted values to the mapping's max.
mapping: (4.3) Raw property map for cross-property links, e.g.
{"rotate": {"to": {"x": {"scale": 2}}}} turns the source's rotation into x movement.
Overrides |
| spine_add_path_constraintA | Add a path constraint: Args: position_mode: percent (position 0..1 of the path length) or fixed (in pixels). spacing_mode: length, fixed, percent or proportional (distance between the bones). rotate_mode: tangent, chain or chainScale. rotation: Rotation offset in degrees. position: Setup position along the path. spacing: Setup spacing between bones. mix_rotate / mix_x / mix_y: 0..1 influence (mix_y defaults to mix_x). |
| spine_add_physics_constraintA | Add a physics constraint (Spine 4.2+): the bone reacts like a spring when the skeleton moves - hair, tails, ears, cloth. At least one of x, y, rotate, scale_x, shear_x must be > 0. Animate it with "physics.wind", "physics.gravity", "physics.reset", ... Args: x / y / rotate / scale_x / shear_x: 0..1 how much the bone reacts in each channel. inertia: 0..1, how much movement is kept from the parent (default 0.5). strength: Spring stiffness (default 100). damping: 0..1, how quickly motion settles (default 0.85). mass: > 0 (default 1). wind / gravity: Constant forces (default 0). mix: 0..1 overall influence. limit: Maximum speed (default 5000). fps: Simulation rate (default 60). |
| spine_add_skinB | Create a skin (e.g. an outfit). Use |
| spine_upgradeA | Fix a document written by spine-mcp 0.1: rotate "angle" -> "value", alpha -> "value", "draworder" -> "drawOrder", bone "transform" -> "inherit" and normalized curves -> absolute Spine 4.x curves. Every editing tool does this automatically; use this to fix a file as is. |
| spine_exportA | Export a .spine project through the Spine CLI (Spine -i project -o output -e json). The editor must be installed; the executable is auto-detected or taken from
SPINE_CLI_PATH. The first run of the Trial launcher can download the editor and
therefore be slow - raise Args: output: Output folder (files are named after the skeleton). format: "json" or "binary". pack: Also pack a texture atlas (json+pack / binary+pack). clean: Animation clean-up before export (-m); does not modify the project. settings: Path to a saved export-settings JSON; overrides format/pack. timeout: Seconds to wait for the CLI. dry_run: Only return the command that would be executed. |
| spine_import_dataC | Import a Spine JSON/binary file (or another project) into a .spine project via the CLI (Spine -i data -o project -r [name]). The project is created if missing. |
| spine_cli_infoB | Ask the Spine CLI for project information (-i project). Shows the editor version, animation counts and warnings for files the offline parser may not understand. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 26 tools
Each tool targets a distinct resource+action (add_bone vs update_bone vs add_slot vs set_keyframes), and the descriptions do a good job of separating near-neighbours like spine_inspect (offline parser) and spine_cli_info (editor CLI). There is some genuine redundancy: spine_delete_animation is a strict subset of spine_delete(kind="animation"), and spine_delete_keyframes overlaps with spine_set_keyframes(mode="replace"), but these are convenience shortcuts rather than true ambiguity.
All names share a spine_ prefix and snake_case, with a clear verb_noun convention (add_bone, update_slot, set_keyframes, delete_animation, create_project, list_projects). A handful of tools drop the verb (spine_inspect, spine_doctor, spine_upgrade, spine_cli_info), which is a minor deviation but still readable and consistent in style.
26 tools sits at the heavy end of the rubric for a single-purpose server. The domain is genuinely broad (bones, slots, attachments, keyframes, four constraint types, skins, export/import), but the four spine_add_*_constraint tools plus spine_add_attachment's kind-switch suggest the surface could be consolidated.
Lifecycle coverage is strong: create/inspect/validate/export/import plus add/update/delete for bones and slots, add/set/delete for keyframes and animations, and delete for every entity kind. The main gaps are the absence of update tools for constraints, events, and attachments (and no animation rename), which force a delete-and-re-add workaround.