unreal-mcp-ue4
Connects Claude or other MCP clients to Unreal Engine 4.27.2 via Python Remote Execution, no custom plugin required. You get granular tools to read project info, spawn and modify actors, search assets, create data assets and string tables, and manage sequences through the built-in SequencerScripting module. The manage_* namespace tools are the main interface, with manage_editor.project_info and manage_level.world_outliner as your read entry points and manage_editor.run_python as an escape hatch for unwrapped API calls. Forked from runreal's unreal-mcp but heavily refactored for UE4 compatibility and expanded scope. Requires Editor Scripting Utilities and Python Editor Script Plugin enabled in your project settings before the server can talk to your open editor session.
- GitHub stars
- 10
- tools
- 30
- transport
- STDIO
- last updated
- Mar 31, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
get_unreal_engine_pathGet the active Unreal Engine root path from the connected editor session
Get the active Unreal Engine root path from the connected editor session
No parameter schema in public metadata yet.
get_unreal_project_pathGet the active Unreal project file path from the connected editor session
Get the active Unreal project file path from the connected editor session
No parameter schema in public metadata yet.
get_unreal_versionGet the active Unreal Engine version string from the connected editor session
Get the active Unreal Engine version string from the connected editor session
No parameter schema in public metadata yet.
editor_create_objectCreate a new object/actor in the world
Create a new object/actor in the world
No parameter schema in public metadata yet.
editor_update_objectUpdate an existing object/actor in the world
Update an existing object/actor in the world
No parameter schema in public metadata yet.
editor_delete_objectDelete an object/actor from the world
Delete an object/actor from the world
No parameter schema in public metadata yet.
manage_assetAsset tool namespace for listing, searching, inspecting, exporting, validating, duplicating, renaming, moving, deleting, saving, and folder-management actions.
Asset tool namespace for listing, searching, inspecting, exporting, validating, duplicating, renaming, moving, deleting, saving, and folder-management actions.
No parameter schema in public metadata yet.
manage_actorActor tool namespace for listing, searching, spawning, deleting, transforming, and inspecting level actors.
Actor tool namespace for listing, searching, spawning, deleting, transforming, and inspecting level actors.
No parameter schema in public metadata yet.
manage_editorEditor tool namespace for run_python, console_command, project_info, map_info, world_outliner, is_pie_running, start_pie, stop_pie, screenshot, and move_camera actions.
Editor tool namespace for run_python, console_command, project_info, map_info, world_outliner, is_pie_running, start_pie, stop_pie, screenshot, and move_camera actions.
No parameter schema in public metadata yet.
manage_levelLevel tool namespace for map inspection, actor listing, world outliner inspection, and preset structure creation actions.
Level tool namespace for map inspection, actor listing, world outliner inspection, and preset structure creation actions.
No parameter schema in public metadata yet.
manage_systemSystem tool namespace for console commands and asset validation actions.
System tool namespace for console commands and asset validation actions.
No parameter schema in public metadata yet.
manage_inspectionInspection tool namespace for asset, actor, map, and basic Blueprint summary actions.
Inspection tool namespace for asset, actor, map, and basic Blueprint summary actions.
No parameter schema in public metadata yet.
manage_toolsTool-namespace registry for listing registered tool namespaces and describing supported actions.
Tool-namespace registry for listing registered tool namespaces and describing supported actions.
No parameter schema in public metadata yet.
manage_source_controlSource-control tool namespace for provider inspection and file or package source-control operations.
Source-control tool namespace for provider inspection and file or package source-control operations.
No parameter schema in public metadata yet.
manage_lightingLighting tool namespace for spawning common light actors, transforming them, and inspecting level lighting state.
Lighting tool namespace for spawning common light actors, transforming them, and inspecting level lighting state.
No parameter schema in public metadata yet.
manage_level_structureLevel-structure tool namespace for preset town, house, mansion, tower, wall, bridge, and fortress construction actions.
Level-structure tool namespace for preset town, house, mansion, tower, wall, bridge, and fortress construction actions.
No parameter schema in public metadata yet.
manage_volumesVolume tool namespace for spawning common engine volumes and applying delete or transform actions.
Volume tool namespace for spawning common engine volumes and applying delete or transform actions.
No parameter schema in public metadata yet.
manage_navigationNavigation tool namespace for spawning navigation volumes and proxies plus basic map inspection actions.
Navigation tool namespace for spawning navigation volumes and proxies plus basic map inspection actions.
No parameter schema in public metadata yet.
manage_environmentEnvironment-building tool namespace for preset town, arch, staircase, pyramid, and maze generation actions.
Environment-building tool namespace for preset town, arch, staircase, pyramid, and maze generation actions.
No parameter schema in public metadata yet.
manage_splinesSpline tool namespace for spawning a spline-host actor or Blueprint and then transforming or deleting it.
Spline tool namespace for spawning a spline-host actor or Blueprint and then transforming or deleting it.
No parameter schema in public metadata yet.
manage_geometryGeometry tool namespace for wall, arch, staircase, and pyramid preset construction actions.
Geometry tool namespace for wall, arch, staircase, and pyramid preset construction actions.
No parameter schema in public metadata yet.
manage_effectEffects tool namespace for spawning debug-shape actors, assigning materials, tinting them, and deleting them.
Effects tool namespace for spawning debug-shape actors, assigning materials, tinting them, and deleting them.
No parameter schema in public metadata yet.
manage_skeletonSkeleton tool namespace for searching Skeleton and SkeletalMesh assets and inspecting their metadata.
Skeleton tool namespace for searching Skeleton and SkeletalMesh assets and inspecting their metadata.
No parameter schema in public metadata yet.
manage_materialMaterial tool namespace for listing materials, applying them to actors or Blueprints, and tinting them with material instances.
Material tool namespace for listing materials, applying them to actors or Blueprints, and tinting them with material instances.
No parameter schema in public metadata yet.
manage_textureTexture tool namespace for searching texture assets, importing image files as textures, and reading their asset metadata.
Texture tool namespace for searching texture assets, importing image files as textures, and reading their asset metadata.
No parameter schema in public metadata yet.
manage_dataData tool namespace for searching data assets, creating common data containers, and inspecting their asset metadata.
Data tool namespace for searching data assets, creating common data containers, and inspecting their asset metadata.
No parameter schema in public metadata yet.
manage_blueprintBlueprint tool namespace for Blueprint creation, component editing, compilation, and basic Blueprint summary actions.
Blueprint tool namespace for Blueprint creation, component editing, compilation, and basic Blueprint summary actions.
No parameter schema in public metadata yet.
manage_sequenceSequence tool namespace for creating, searching, inspecting, and editing LevelSequence assets, including bindings, tracks, sections, keys, camera cuts, playback ranges, and speed-track time calculations.
Sequence tool namespace for creating, searching, inspecting, and editing LevelSequence assets, including bindings, tracks, sections, keys, camera cuts, playback ranges, and speed-track time calculations.
No parameter schema in public metadata yet.
manage_audioAudio tool namespace for importing audio files, searching audio assets, and inspecting their asset metadata.
Audio tool namespace for importing audio files, searching audio assets, and inspecting their asset metadata.
No parameter schema in public metadata yet.
manage_widgetWidget tool namespace for UMG Blueprint creation, widget-tree inspection, widget-tree edits, CanvasPanel root normalization, and viewport spawning actions.
Widget tool namespace for UMG Blueprint creation, widget-tree inspection, widget-tree edits, CanvasPanel root normalization, and viewport spawning actions.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
unreal-mcp-ue4
UE4.27.2-focused MCP server for Unreal Engine using Unreal Python Remote Execution
unreal-mcp-ue4 started from the core idea and early workflow shape of runreal/unreal-mcp, but it has since been heavily refactored for Unreal Engine 4.27.2 and expanded with many new tools, UE4-specific compatibility layers, documentation, and smoke coverage. At this point, the original inspiration remains, but the public surface and day-to-day behavior are substantially different and UE4-first.
This port and the follow-up tool, documentation, and smoke-test work were developed with assistance from OpenAI Codex.
Details
- Repository
- github.com/conaman/unreal-mcp-ue4
- Website
- github.com/conaman/unreal-mcp-ue4
- Package
unreal-mcp-ue4- Transport
- STDIO
- Registry
- MCP registry, active