Skip to main content
Glama
unreal-animation-mcp

unreal-animation-mcp

by tumourlove

unreal-animation-mcp

Animation data inspector and editor for Unreal Engine AI development via Model Context Protocol.

Inspect, search, and edit animation sequences, montages, blend spaces, animation blueprints, skeletons, and skeletal meshes — 62 tools total.

Why?

Animation data in Unreal is deeply nested and spread across many asset types — sequences hold notifies, curves, and bone tracks; montages add sections and slots on top; blend spaces map animations to parameter grids; and Animation Blueprints wire it all together through state machines, transitions, and blend nodes. AI agents can't see any of this from C++ alone. This server exposes the full animation stack as structured data so agents can inspect, search, audit, and edit animation assets alongside the rest of your project.

Complements (does not replace):

  • unreal-source-mcp — Engine-level source intelligence (full UE C++ and HLSL)

  • unreal-project-mcp — Project-level source intelligence (your C++ code)

  • unreal-editor-mcp — Build diagnostics and editor log tools (Live Coding, error parsing, log search)

  • unreal-blueprint-mcp — Blueprint graph reading (nodes, pins, connections, execution flow)

  • unreal-blueprint-reader — C++ editor plugin that serializes Blueprint graphs to JSON for AI tooling

  • unreal-material-mcp — Material graph intelligence and editing (expressions, connections, parameters, instances, graph manipulation)

  • unreal-config-mcp — Config/INI intelligence (resolve inheritance chains, search settings, diff from defaults, explain CVars)

  • unreal-niagara-mcp — Niagara VFX intelligence and editing (emitters, modules, HLSL generation, procedural creation, 70 tools)

  • unreal-api-mcp by Nico Bailon — API surface lookup (signatures, #include paths, deprecation warnings)

Together these servers give AI agents full-stack UE understanding: engine internals, API surface, your project code, build/runtime feedback, Blueprint graph data, config/INI intelligence, material graph inspection + editing, animation data inspection + editing, and Niagara VFX inspection + creation.

Related MCP server: Spine MCP Server

Prerequisites

  • AnimationMCPReader plugin installed in your UE project (unreal-animation-reader) — required for C++-backed tools (montage sections, blendspace samples, ABP state machines/transitions/blend nodes, notify time/duration, bone track keys)

  • Python Remote Execution enabled in the editor: Edit > Project Settings > search "remote" > under Python Remote Execution, check "Enable Remote Execution?"

Quick Start

Install from GitHub

uvx --from git+https://github.com/tumourlove/unreal-animation-mcp.git unreal-animation-mcp

Claude Code Configuration

Add to your project's .mcp.json:

{
  "mcpServers": {
    "unreal-animation": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tumourlove/unreal-animation-mcp.git", "unreal-animation-mcp"],
      "env": {
        "UE_PROJECT_PATH": "D:/Unreal Projects/YourProject"
      }
    }
  }
}

Environment Variables

Variable

Required

Description

UE_PROJECT_PATH

Yes

Path to the UE project root (containing the .uproject file)

UE_EDITOR_PYTHON_PORT

No

TCP port for editor Python commands (default: 6776)

UE_MULTICAST_GROUP

No

UDP multicast group for editor discovery (default: 239.0.0.1)

UE_MULTICAST_PORT

No

UDP multicast port for editor discovery (default: 6766)

UE_MULTICAST_BIND

No

Local interface to bind multicast listener (default: 127.0.0.1)

How It Works

  1. Editor Discovery — Discovers the running UE editor via UDP multicast (the same protocol as UE's built-in remote_execution.py). Opens a TCP command channel to execute Python in the editor.

  2. Helper Upload — Uploads animation_helpers.py to {project}/Saved/AnimationMCP/ on first use. The helper module wraps unreal.AnimationLibrary and related APIs for inspection, editing, and search operations.

  3. Plugin Bridge — For advanced operations, sends Python commands that call AnimationMCPReaderLibrary static functions from the companion C++ plugin. The plugin serializes animation graph data to JSON strings.

  4. Serving — FastMCP server exposes 62 tools over stdio. Claude Code manages the server lifecycle automatically.

No database, no indexing — all data comes live from the running editor. The server is stateless; animation data is read on demand from whatever assets are loaded.

Adding to Your Project's CLAUDE.md

## Animation Data (unreal-animation MCP)

Use `unreal-animation` MCP tools to inspect, edit, and search animation data —
sequences, montages, blend spaces, ABPs, skeletons, and meshes. Requires
**AnimationMCPReader** plugin and **Python Remote Execution** enabled in editor.

| Category | Tools | When |
|----------|-------|------|
| Sequence Inspect | `get_anim_sequence_info`, `get_anim_notifies`, `get_anim_curves`, `get_bone_tracks` | Understand an animation's properties, notifies, curves, bone data |
| Montage Inspect | `get_montage_info`, `get_montage_sections`, `get_montage_slots` | Read montage structure, sections, slot assignments |
| BlendSpace | `get_blendspace_info`, `get_blendspace_samples` | Read blend space parameters and sample points |
| ABP Inspect | `get_abp_info`, `get_abp_state_machines`, `get_abp_transitions` | Read AnimBP graph structure, state machines, transitions |
| Notify Edit | `add_notify`, `add_notify_state`, `remove_notifies`, `set_notify_time` | Add/remove/move animation notifies |
| Montage Edit | `add_montage_section`, `set_section_next`, `set_montage_blend` | Edit montage sections and blend settings |
| Search | `search_animations`, `search_by_notify`, `audit_notifies` | Find animations by type/folder, audit notify usage |

**Asset paths (no extension):**
- Project `Content/`: `/Game/Path/To/Asset`
- Project `Plugins/`: `/PluginName/Path/To/Asset`
- Engine plugins: `/PluginName/Path/To/Asset`

Tools (62)

Inspection (23)

  • AnimSequence: get_anim_sequence_info, get_anim_notifies, get_anim_curves, get_bone_tracks, get_bone_pose_at_time, get_sync_markers

  • AnimMontage: get_montage_info, get_montage_sections, get_montage_slots

  • BlendSpace: get_blendspace_info, get_blendspace_samples

  • Skeleton/Mesh: get_skeleton_info, get_skeletal_mesh_info

  • AnimBlueprint: get_abp_info, get_abp_graphs, get_abp_nodes, get_abp_asset_overrides, get_abp_state_machines, get_abp_state_info, get_abp_transitions, get_abp_blend_nodes, get_abp_linked_layers

Editing (31)

  • Notifies: add_notify, add_notify_state, remove_notifies, add_notify_track, remove_notify_track, set_notify_time, set_notify_duration

  • Curves: add_curve, add_curve_keys, remove_curve

  • Sync Markers: add_sync_marker, remove_sync_markers

  • Properties: set_root_motion, set_rate_scale, set_additive_type

  • Virtual Bones: add_virtual_bone, remove_virtual_bones

  • Montage: set_montage_blend, add_montage_section, delete_montage_section, set_section_next, set_section_time

  • BlendSpace: add_blendspace_sample, edit_blendspace_sample, delete_blendspace_sample

  • Bone Tracks: add_bone_track, remove_bone_track, set_bone_track_keys

  • Misc: copy_notifies, add_meta_data, remove_meta_data

Search & Analysis (8)

  • search_animations, search_by_notify, search_by_curve, search_by_slot

  • audit_notifies, audit_blendspace, compare_animations, get_animation_summary

Development

# Clone and install
git clone https://github.com/tumourlove/unreal-animation-mcp.git
cd unreal-animation-mcp
uv sync

# Run tests
uv run pytest -v

# Run server locally
uv run unreal-animation-mcp

Requirements

  • Python 3.11+

  • uv (recommended) or pip

  • Unreal Engine 5.x with Python plugin and Remote Execution enabled

  • AnimationMCPReader C++ plugin

License

MIT

Available Tools

61 tools
add_blendspace_sampleC

Add a sample to a BlendSpace.

Args: asset_path: BlendSpace asset path anim_path: Animation asset path for the sample x: X axis value y: Y axis value

Inputs: x (required), y (required), anim_path (required), asset_path (required). Returns: result

add_bone_trackC

Add a bone track to an animation.

Args: asset_path: Unreal asset path bone_name: Bone name

Inputs: bone_name (required), asset_path (required). Returns: result

add_curveB

Add a curve to an animation.

Args: asset_path: Unreal asset path curve_name: Name for the new curve curve_type: 'float', 'vector', or 'transform'

Inputs: asset_path (required), curve_name (required), curve_type (required). Returns: result

add_curve_keysC

Add keys to a float curve.

Args: asset_path: Unreal asset path curve_name: Curve name times: List of key times values: List of key values

Inputs: times (required), values (required), asset_path (required), curve_name (required). Returns: result

add_meta_dataC

Add metadata to an animation asset.

Args: asset_path: Unreal asset path meta_data_class: Metadata class name

Inputs: asset_path (required), meta_data_class (required). Returns: result

add_montage_sectionC

Add a new section to a montage.

Args: asset_path: Unreal asset path section_name: Name for the new section start_time: Start time in seconds

Inputs: asset_path (required), start_time (required), section_name (required). Returns: result

add_notifyB

Add a notify to an animation.

Args: asset_path: Unreal asset path track_name: Notify track name time: Trigger time in seconds notify_class: Notify class name (e.g. 'AnimNotify_PlaySound')

Inputs: time (required), asset_path (required), track_name (required), notify_class (required). Returns: result

add_notify_stateB

Add a notify state to an animation.

Args: asset_path: Unreal asset path track_name: Notify track name time: Start time in seconds duration: Duration in seconds notify_state_class: Notify state class name

Inputs: time (required), duration (required), asset_path (required), track_name (required), +1 more. Returns: result

add_notify_trackB

Add a notify track to an animation.

Args: asset_path: Unreal asset path track_name: Name for the new track

Inputs: asset_path (required), track_name (required). Returns: result

add_sync_markerC

Add a sync marker to an animation.

Args: asset_path: Unreal asset path marker_name: Marker name time: Time in seconds track_name: Notify track name

Inputs: time (required), asset_path (required), track_name (required), marker_name (required). Returns: result

add_virtual_boneC

Add a virtual bone to a skeleton.

Args: asset_path: Unreal asset path to skeleton source_bone: Source bone name target_bone: Target bone name

Inputs: asset_path (required), source_bone (required), target_bone (required). Returns: result

audit_blendspaceC

Analyze BlendSpace sample coverage and find issues.

Args: asset_path: BlendSpace asset path

Inputs: asset_path (required). Returns: result

audit_notifiesB

Audit notify usage across animations.

Args: asset_path: Specific asset to audit (omit for folder scan) folder: Folder to scan

Inputs: folder, asset_path. Returns: result

compare_animationsC

Compare two animation assets.

Args: path_a: First animation asset path path_b: Second animation asset path

Inputs: path_a (required), path_b (required). Returns: result

copy_notifiesB

Copy notifies from one animation to another.

Args: source_path: Source asset path dest_path: Destination asset path

Inputs: dest_path (required), source_path (required). Returns: result

delete_blendspace_sampleA

Delete a sample from a BlendSpace.

Args: asset_path: BlendSpace asset path sample_index: Index of the sample to delete

Inputs: asset_path (required), sample_index (required). Returns: result

delete_montage_sectionB

Delete a section from a montage.

Args: asset_path: Unreal asset path section_index: Index of the section to delete

Inputs: asset_path (required), section_index (required). Returns: result

edit_blendspace_sampleA

Edit a BlendSpace sample position and/or animation.

Args: asset_path: BlendSpace asset path sample_index: Index of the sample to edit x: New X axis value y: New Y axis value anim_path: New animation path (empty to keep current)

Inputs: x (required), y (required), asset_path (required), sample_index (required), +1 more. Returns: result

get_abp_asset_overridesB

Get parent node asset overrides in an AnimBlueprint.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_abp_blend_nodesA

Get blend nodes in an AnimBlueprint graph.

Args: asset_path: Unreal asset path graph_name: Graph name to inspect (empty for first graph)

Inputs: asset_path (required), graph_name. Returns: result

get_abp_graphsC

List animation graphs in an AnimBlueprint.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_abp_infoB

Get core metadata for an AnimBlueprint.

Args: asset_path: Unreal asset path, e.g. '/Game/Characters/ABP_Hero'

Inputs: asset_path (required). Returns: result

get_abp_linked_layersC

Get linked animation layers in an AnimBlueprint.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_abp_nodesA

Enumerate anim graph nodes in an AnimBlueprint.

Args: asset_path: Unreal asset path node_class: Filter by node class name (e.g. 'AnimGraphNode_BlendListByBool')

Inputs: asset_path (required), node_class. Returns: result

get_abp_state_infoC

Get detailed info about a specific state in an ABP state machine.

Args: asset_path: Unreal asset path machine_name: State machine name state_name: State name

Inputs: asset_path (required), state_name (required), machine_name (required). Returns: result

get_abp_state_machinesA

Get all state machines in an AnimBlueprint with states and transitions.

Args: asset_path: Unreal asset path, e.g. '/Game/Characters/ABP_Hero'

Inputs: asset_path (required). Returns: result

get_abp_transitionsB

Get detailed transitions in an ABP state machine.

Args: asset_path: Unreal asset path machine_name: State machine name

Inputs: asset_path (required), machine_name (required). Returns: result

get_animation_summaryB

Get folder-level animation stats.

Args: folder: Unreal folder path, e.g. '/Game/Animations'

Inputs: folder (required). Returns: result

get_anim_curvesA

Get all curves on an animation sequence.

Args: asset_path: Unreal asset path curve_type: Filter by type: 'float', 'vector', or 'transform'

Inputs: asset_path (required), curve_type. Returns: result

get_anim_notifiesA

Get all notifies on an animation asset.

Args: asset_path: Unreal asset path to an AnimSequence or AnimMontage

Inputs: asset_path (required). Returns: result

get_anim_sequence_infoA

Get core metadata for an AnimSequence.

Returns length, frame count, rate scale, interpolation type, additive type, root motion settings, bone track names, and skeleton reference.

Args: asset_path: Unreal asset path, e.g. '/Game/Animations/AS_Run'

Inputs: asset_path (required). Returns: result

get_blendspace_infoB

Get core metadata for a BlendSpace.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_blendspace_samplesB

Get all sample points in a BlendSpace.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_bone_pose_at_timeA

Get bone transforms at a specific time.

Args: asset_path: Unreal asset path bone_names: List of bone names to query time: Time in seconds

Inputs: time (required), asset_path (required), bone_names (required). Returns: result

get_bone_tracksA

Get bone track names, or detailed keys for a specific bone.

Args: asset_path: Unreal asset path bone_name: Specific bone to inspect (omit for track list)

Inputs: asset_path (required), bone_name. Returns: result

get_montage_infoC

Get core metadata for an AnimMontage.

Args: asset_path: Unreal asset path, e.g. '/Game/Montages/AM_Attack'

Inputs: asset_path (required). Returns: result

get_montage_sectionsA

Get detailed section list for a montage.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_montage_slotsB

Get slot tracks for a montage.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_skeletal_mesh_infoC

Get metadata for a SkeletalMesh.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_skeleton_infoA

Get bone hierarchy and metadata for a Skeleton.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

get_sync_markersC

Get sync markers on an animation sequence.

Args: asset_path: Unreal asset path

Inputs: asset_path (required). Returns: result

remove_bone_trackA

Remove a bone track from an animation.

Args: asset_path: Unreal asset path bone_name: Bone name include_children: Also remove child bone tracks

Inputs: bone_name (required), asset_path (required), include_children. Returns: result

remove_curveC

Remove a curve from an animation.

Args: asset_path: Unreal asset path curve_name: Curve to remove

Inputs: asset_path (required), curve_name (required). Returns: result

remove_meta_dataB

Remove metadata from an animation asset.

Args: asset_path: Unreal asset path meta_data_class: Specific class to remove (omit for all)

Inputs: asset_path (required), meta_data_class. Returns: result

remove_notifiesA

Remove notifies by name or track.

Args: asset_path: Unreal asset path notify_name: Remove notifies with this name track_name: Remove all notifies on this track

Inputs: asset_path (required), track_name, notify_name. Returns: result

remove_notify_trackA

Remove a notify track.

Args: asset_path: Unreal asset path track_name: Track to remove

Inputs: asset_path (required), track_name (required). Returns: result

remove_sync_markersB

Remove sync markers by name, track, or all.

Args: asset_path: Unreal asset path marker_name: Remove markers with this name track_name: Remove markers on this track

Inputs: asset_path (required), track_name, marker_name. Returns: result

remove_virtual_bonesA

Remove virtual bones from a skeleton.

Args: asset_path: Unreal asset path bone_names: Specific bones to remove (omit for all)

Inputs: asset_path (required), bone_names. Returns: result

search_animationsA

Search for animation assets by name, type, folder, or skeleton.

Args: query: Name pattern to match (case-insensitive) anim_type: Filter by type: AnimSequence, AnimMontage, BlendSpace, BlendSpace1D, AnimBlueprint folder: Unreal folder path, e.g. '/Game/Animations' skeleton: Filter by skeleton path

Inputs: query, folder, skeleton, anim_type. Returns: result

search_by_curveA

Find animations containing a specific curve.

Args: curve_name: Curve name to search for curve_type: Filter by type: 'float', 'vector', 'transform' folder: Restrict search to folder

Inputs: curve_name (required), folder, curve_type. Returns: result

search_by_notifyA

Find animations containing a specific notify.

Args: notify_name: Notify name to search for notify_class: Notify class to search for folder: Restrict search to folder

Inputs: folder, notify_name, notify_class. Returns: result

search_by_slotB

Find montages using a specific slot.

Args: slot_name: Slot name to search for folder: Restrict search to folder

Inputs: slot_name (required), folder. Returns: result

set_additive_typeC

Set additive animation type.

Args: asset_path: Unreal asset path additive_type: Additive type (e.g. 'AAT_None', 'AAT_LocalSpaceBase') base_pose_type: Base pose type (e.g. 'ABPT_None', 'ABPT_RefPose')

Inputs: asset_path (required), additive_type (required), base_pose_type. Returns: result

set_bone_track_keysB

Set bone track keys for an animation.

Args: asset_path: Unreal asset path bone_name: Bone name positions_json: JSON array of [x,y,z] positions rotations_json: JSON array of [x,y,z,w] rotations scales_json: JSON array of [x,y,z] scales

Inputs: bone_name (required), asset_path (required), scales_json (required), positions_json (required), +1 more. Returns: result

set_montage_blendC

Set montage blend settings.

Args: asset_path: Unreal asset path blend_in_time: Blend in time in seconds blend_out_time: Blend out time in seconds blend_out_trigger: Blend out trigger time auto_blend_out: Enable auto blend out

Inputs: asset_path (required), blend_in_time, auto_blend_out, blend_out_time, +1 more. Returns: result

set_notify_durationB

Set the duration of a notify state.

Args: asset_path: Unreal asset path notify_index: Index of the notify state new_duration: New duration in seconds

Inputs: asset_path (required), new_duration (required), notify_index (required). Returns: result

set_notify_timeA

Set the trigger time of a specific notify.

Args: asset_path: Unreal asset path notify_index: Index of the notify new_time: New trigger time in seconds

Inputs: new_time (required), asset_path (required), notify_index (required). Returns: result

set_rate_scaleC

Set the rate scale of an animation.

Args: asset_path: Unreal asset path rate_scale: New rate scale value

Inputs: asset_path (required), rate_scale (required). Returns: result

set_root_motionA

Enable/disable root motion on an animation.

Args: asset_path: Unreal asset path enabled: Enable or disable root motion lock_type: Lock type (e.g. 'AnimFirstFrame', 'Zero', 'RefPose')

Inputs: enabled (required), asset_path (required), lock_type. Returns: result

set_section_nextC

Set the next section for a montage section.

Args: asset_path: Unreal asset path section_name: Current section name next_section_name: Next section to play

Inputs: asset_path (required), section_name (required), next_section_name (required). Returns: result

set_section_timeA

Set the start time of a montage section.

Args: asset_path: Unreal asset path section_name: Section name new_time: New start time in seconds

Inputs: new_time (required), asset_path (required), section_name (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 61 tools

    Disambiguation4/5

    Most tools target a distinct asset type or operation, and argument descriptions are detailed enough to differentiate them. However, sync markers and notifies overlap conceptually, and the many AnimBlueprint getters (graphs, nodes, state machines, blend nodes) require careful reading to avoid confusion.

    Naming Consistency4/5

    The verb_noun snake_case pattern is used consistently for most tools (get_, add_, remove_, set_, search_, audit_). Minor inconsistencies exist: delete_montage_section and delete_blendspace_sample use 'delete' while similar operations use 'remove', and edit_blendspace_sample uses 'edit' instead of 'set' or 'update'.

    Tool Count2/5

    With 61 tools, this greatly exceeds the 25+ threshold for a comfortable, scoped set. While the Unreal animation domain is complex, the sheer number feels overwhelming and could benefit from consolidation (e.g., merging related ABP getters or montage section operations).

    Completeness3/5

    The toolset provides extensive read and edit coverage for AnimSequences, Montages, BlendSpaces, and Skeletons, including notifies, curves, sync markers, sections, samples, and bone tracks. However, AnimBlueprint operations are entirely read-only (no state/node editing), and there are no create/delete operations for animation assets, leaving notable lifecycle gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to create and edit Rive animations through 139 MCP tools, supporting shapes, animations, state machines, physics, and export to .riv or .rev files.
      453 npm
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      28
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to operate the Unreal Editor via MCP: reading, creating, and editing blueprints at the node level, authoring materials and UMG widgets, auditing projects, and verifying runtime behavior in PIE with read-back checks.
      34
      1
      Apache 2.0