unreal-animation-mcp
Provides tools for inspecting, editing, and searching animation data (sequences, montages, blend spaces, animation blueprints, skeletons, and skeletal meshes) in a running Unreal Engine editor, enabling AI agents to manage animation assets programmatically.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@unreal-animation-mcp list all animation sequences in the project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude 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 |
| Yes | Path to the UE project root (containing the .uproject file) |
| No | TCP port for editor Python commands (default: |
| No | UDP multicast group for editor discovery (default: |
| No | UDP multicast port for editor discovery (default: |
| No | Local interface to bind multicast listener (default: |
How It Works
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.Helper Upload — Uploads
animation_helpers.pyto{project}/Saved/AnimationMCP/on first use. The helper module wrapsunreal.AnimationLibraryand related APIs for inspection, editing, and search operations.Plugin Bridge — For advanced operations, sends Python commands that call
AnimationMCPReaderLibrarystatic functions from the companion C++ plugin. The plugin serializes animation graph data to JSON strings.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_markersAnimMontage:
get_montage_info,get_montage_sections,get_montage_slotsBlendSpace:
get_blendspace_info,get_blendspace_samplesSkeleton/Mesh:
get_skeleton_info,get_skeletal_mesh_infoAnimBlueprint:
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_durationCurves:
add_curve,add_curve_keys,remove_curveSync Markers:
add_sync_marker,remove_sync_markersProperties:
set_root_motion,set_rate_scale,set_additive_typeVirtual Bones:
add_virtual_bone,remove_virtual_bonesMontage:
set_montage_blend,add_montage_section,delete_montage_section,set_section_next,set_section_timeBlendSpace:
add_blendspace_sample,edit_blendspace_sample,delete_blendspace_sampleBone Tracks:
add_bone_track,remove_bone_track,set_bone_track_keysMisc:
copy_notifies,add_meta_data,remove_meta_data
Search & Analysis (8)
search_animations,search_by_notify,search_by_curve,search_by_slotaudit_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-mcpRequirements
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 toolsadd_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
Scored across 61 tools
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.
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'.
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).
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
Related MCP Connectors
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables 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 npm2-
- 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
- AlicenseAqualityBmaintenanceEnables 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.341Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to author, validate, render, measure, and fix 2D rigs and animations through 16 tools, returning results as images and providing a live editor bridge.41MIT