Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SPINE_CLI_PATHNoPath 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 inherit (the pre-4.2 field name). skin: Only active while a skin that contains it is active. color: Optional bone color as RRGGBB or RRGGBBAA.

spine_add_slotA

Add a draw-order slot attached to an existing bone.

Slots are drawn in list order (later slots on top). Use index to insert at a specific draw position instead of appending.

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:

  • region - textured rectangle centered on x/y; needs width/height. image_path is the region name inside the images folder/atlas, without extension (defaults to the attachment name; a .png suffix is stripped).

  • mesh - textured mesh; a regular grid centered on x/y is generated from width/height/cols/rows unless explicit uvs/vertices/triangles are given (then list the outline vertices first and pass hull = their count).

  • point - single point with rotation (projectile/particle spawn).

  • boundingbox - polygon for hit detection; needs vertices (x,y pairs).

  • path - curve for spine_add_path_constraint; vertices are the anchor points (x,y pairs, in the slot bone's space). Smooth handles and the curve lengths are generated. closed makes a loop; constant_speed (default) keeps bones evenly spaced along it.

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):

  • rotate (bone) keys: {"time": 0, "value": 15} ("angle" is accepted too)

  • translate (bone) keys: {"time": 0, "x": 10, "y": -4}

  • scale (bone) keys: {"time": 0, "x": 1, "y": 1}

  • shear (bone) keys: {"time": 0, "x": 0, "y": 0}

  • translatex/translatey/scalex/scaley/shearx/sheary (bone) keys: {"time": 0, "value": 3}

  • inherit (bone) keys: {"time": 0, "inherit": "noScale"}

  • attachment(slot) keys: {"time": 0, "name": "eyes-closed"} (null clears)

  • rgba / rgb (slot) keys: {"time": 0, "color": "FFFFFFFF"} (RRGGBB for rgb)

  • rgba2 / rgb2 (slot) keys: {"time": 0, "light": "FFFFFFFF", "dark": "000000"}

  • alpha (slot) keys: {"time": 0, "value": 0.5}

  • event keys: {"time": 0.2, "name": "footstep", "int": 1}

  • drawOrder keys: {"time": 0, "offsets": [{"slot": "arm", "offset": 1}]}

  • ik (constraint) keys: {"time": 0, "mix": 1, "softness": 0, "bendPositive": false}

  • transform (constraint) keys: {"time": 0, "mixRotate": 1, "mixX": 0.5, ...} (mixRotate/mixX/mixY/mixScaleX/mixScaleY/mixShearY; omitted mixes keep the setup value)

  • path.position / path.spacing (constraint) keys: {"time": 0, "value": 0.25}

  • path.mix (constraint) keys: {"time": 0, "mixRotate": 1, "mixX": 1, "mixY": 1}

  • physics.inertia/strength/damping/mass/wind/gravity/mix keys: {"time": 0, "value": 30}

  • physics.reset keys: {"time": 0.5} (physics target "" = every physics constraint)

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 curve argument is the default for keys that do not specify one.

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 times (seconds), or the whole timeline when times is omitted. Curves of the remaining keys keep their shape.

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.

new_name renames the bone everywhere (children, slots, constraints, skins, animations). parent re-parents it (with its whole subtree; cycles are refused). Pass color="" to clear it.

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 bones or their children), e.g. "foot-target". mix: 0..1 influence. bend_positive: Bend direction of a 2-bone chain. softness: Distance before full extension where the chain starts to slow down. compress / stretch / uniform: Scale the bone(s) to reach the target. order: Constraint order (default: after existing constraints).

spine_add_transform_constraintA

Add a transform constraint: bones copy the source bone's rotation, position, scale and/or shear (e.g. a cape following the torso, wheels sharing rotation). Animate it with timeline "transform". Written in the file's format (4.3 "constraints" list or 4.2 "transform").

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 properties. order: Update order among constraints (default: last).

spine_add_path_constraintA

Add a path constraint: bones are placed along the path attachment shown in slot (add one first with spine_add_attachment kind="path"). Animate "path.position" to move them along it.

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 copy_from to start from another skin's attachments, then add or replace attachments with spine_add_attachment(skin=name).

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 timeout if needed.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 26 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count3/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues