Ultimateunrealenginemcp

jeebus874stars

MCP server giving AI assistants full access to Unreal Engine 5.7 projects — 65+ tools, C++ editor plugin, visual review loop

Game Development

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Ultimateunrealenginemcp

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Last checked: 2026-10-28

Stars: 4
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Ultimateunrealenginemcp?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Ultimateunrealenginemcp need an API key?

No required environment variable is listed on this record.

What transport does Ultimateunrealenginemcp use?

Ultimateunrealenginemcp runs locally over stdio.

When was Ultimateunrealenginemcp last checked?

Last checked 2026-10-28. MCP server giving AI assistants full access to Unreal Engine 5.7 projects — 65+ tools, C++ editor plugin, visual review loop

From the publisher

Documentation

Ultimate Unreal Engine MCP

133 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.

MCP (Model Context Protocol) is a standard that lets AI assistants call tools on external systems — this server exposes Unreal Engine as those tools.

npx ultimate-unreal-engine-mcp setup

Quick Start
What You Can Do
Architecture
Tool Catalog
Visual Review Loop
Automatic Self-Verification
Headless vs Live
Installation
C++ Plugin Setup
Configuration
Development
Requirements
License

Quick Start

# Claude Desktop (default)
npx ultimate-unreal-engine-mcp setup

# Claude Code CLI
npx ultimate-unreal-engine-mcp setup --client claude-code

# Cursor
npx ultimate-unreal-engine-mcp setup --client cursor

# With a UE project (also installs the C++ plugin)
npx ultimate-unreal-engine-mcp setup --project "C:/MyGame"

This command writes the correct config for your client. The C++ plugin is optional — file-system tools (C++ parsing, code gen, configs, builds, docs) work without it. Install the plugin for live editor tools (Blueprints, actors, viewport, screenshots).

Zero optional dependencies. The C++ plugin compiles on any UE 5.7 install — binary or source. All 133 tools use runtime reflection for optional UE modules (MetaSound, LiveLink, GAS, etc.), so the plugin loads regardless of which plugins your project has enabled. Handlers gracefully report when their target module isn't available.

What You Can Do

The following walkthrough shows AI autonomously setting up a point light, doing a visual review loop, and correcting an intensity problem — all without leaving the conversation.

Prompt: "Spawn a point light named MainLight at the center of the level, set its intensity to 5000, then take a screenshot so I can review it."

Step 1 — Spawn the actor

ue_spawn_actor(class="PointLight", label="MainLight", location={x:0, y:0, z:300})

Claude: Actor MainLight spawned at (0, 0, 300). UE returned actor_id: "PointLight_0".

Step 2 — Navigate camera to the actor

ue_look_at(target="MainLight", angle="45deg", screenshot=true)

Claude: Camera positioned. [Screenshot returned inline — shows a bright white sphere flooding the scene with overexposed light.]

Step 3 — Visual review — something is wrong

ue_visual_review(focus="check if the lighting looks blown out")

Claude: The scene is severely overexposed. The intensity of 5000 lm is too high for this room scale. Reducing to 800 lm.

Step 4 — Adjust the property

ue_transform_actor(label="MainLight", properties={"Intensity": 800})

Claude: Property Intensity updated to 800 on MainLight.

Step 5 — Verify the fix

ue_orbit_review(target="MainLight", angles=[0, 90, 180, 270])

Claude: [Four screenshots returned — front, right, back, left.] Lighting is balanced. No blown-out surfaces visible from any angle. The area is well-lit without overexposure.

Step 6 — Cleanup

ue_cleanup_screenshots(confirm=true)

Claude: 5 MCP-generated screenshots removed from disk.

This loop — spawn, navigate, inspect, adjust, verify — runs entirely from the AI conversation. No manual editor interaction required.

Architecture

graph TD
    A["AI Client\n(Claude / Cursor / VS Code)"]
    B["MCP Protocol\n(stdio JSON-RPC)"]
    C["TypeScript Server\nNode.js 22+"]
    D["TCP Port 55557"]
    E["C++ Plugin\nMCPBridge"]
    F["UE 5.7 Editor APIs"]

    A -->|tool calls| B
    B --> C
    C -->|file system ops\nC++ parsing\nconfig r/w\ndocs lookup\nbuild trigger| C
    C -->|actor CRUD\nBlueprint graphs\nviewport screenshots\nPIE control\nasset registry| D
    D --> E
    E --> F

    classDef ts fill:#3178c6,color:#fff,stroke:#2563eb
    classDef cpp fill:#f97316,color:#fff,stroke:#ea580c
    classDef ue fill:#76b900,color:#fff,stroke:#65a000
    classDef proto fill:#6b7280,color:#fff,stroke:#4b5563

    class C ts
    class E cpp
    class F ue
    class B,D proto

TypeScript layer handles all file system operations without requiring the editor to be open: C++ header parsing (tree-sitter-unreal-cpp), INI config read/write, code generation, documentation lookup, and build triggering via UnrealBuildTool.

C++ plugin layer (MCPBridge) provides live editor access: actor CRUD, Blueprint graph read/write, viewport screenshots with inline base64 images, PIE session control, asset registry queries, and all other operations that require the UE Editor process.

Tool Catalog

Tool	Description
`ue_inspect_behavior_tree`	Inspect a Behavior Tree asset — tasks, decorators, services, and composite nodes
`ue_inspect_state_tree`	Inspect a State Tree asset — states, transitions, and evaluators
`ue_inspect_blackboard`	Read Blackboard asset key definitions and their types
`ue_inspect_eqs`	Inspect an Environment Query System asset — tests and generators
`ue_query_navmesh`	Query NavMesh coverage for a location or actor

Tool	Description
`ue_list_animation_assets`	List animation assets in the project, optionally filtered by type
`ue_inspect_anim_blueprint`	Inspect AnimBP state machines, states, and transitions
`ue_inspect_montage`	Read montage sections, notifies, and slot assignments
`ue_inspect_blend_space`	Inspect blend space axes, samples, and grid configuration
`ue_read_retarget_mappings`	Read IK Retargeter source/target rig and chain mappings

Tool	Description
`ue_list_sound_assets`	List all sound assets in the project
`ue_inspect_metasound`	Inspect a MetaSound asset — nodes, inputs, outputs, and patches
`ue_inspect_sound_cue`	Inspect a Sound Cue asset — nodes and audio connections
`ue_query_audio_insights`	Query Audio Insights data for active sounds and buses

Tool	Description
`ue_read_blueprint`	Read a Blueprint asset — class defaults, components, and interfaces
`ue_list_blueprints`	List Blueprint assets matching a class filter
`ue_read_blueprint_graph`	Read Blueprint graph nodes, pins, and connections
`ue_create_blueprint`	Create a new Blueprint class with a specified parent
`ue_add_blueprint_node`	Add a function call or event node to a Blueprint graph
`ue_connect_blueprint_pins`	Connect two pins in a Blueprint graph
`ue_add_blueprint_variable`	Add a new variable to a Blueprint class
`ue_set_blueprint_default`	Set a Blueprint class default property value
`ue_cpp_exposed_members`	List C++ properties and functions exposed to Blueprint in a class
`ue_find_blueprint_subclasses`	Find all Blueprints that subclass a given C++ or Blueprint class
`ue_trace_cpp_in_blueprints`	Find all Blueprints referencing a specific C++ class

Tool	Description
`ue_build`	Trigger a UnrealBuildTool build for a target and configuration
`ue_get_build_errors`	Read the latest build output and parse compiler errors

Tool	Description
`ue_inspect_geometry_collection`	Inspect a Geometry Collection asset — fracture levels and clusters
`ue_reset_destruction`	Reset a destructible actor to its initial un-fractured state
`ue_read_cloth_params`	Read Chaos Cloth asset simulation parameters
`ue_manage_physics_cache`	Manage Chaos physics cache recording and playback

Tool	Description
`ue_read_collision`	Read collision profile, channels, and response matrix for an actor or component
`ue_set_collision`	Set collision preset or individual channel responses
`ue_manage_physical_material`	Read or update Physical Material properties
`ue_inspect_physics_asset`	Inspect a Physics Asset — bodies, constraints, and welded bones

Tool	Description
`ue_read_config`	Read a UE INI config file section or key
`ue_write_config`	Write or update a key in a UE INI config file
`ue_read_uproject`	Read .uproject metadata — engine version, plugins, target platforms
`ue_list_plugins`	List all plugins enabled in the project with their versions

Tool	Description
`ue_read_cpp_class`	Parse a C++ header and return UCLASS, UPROPERTY, and UFUNCTION metadata
`ue_get_class_hierarchy`	Walk the class hierarchy from a UClass up to UObject
`ue_trace_includes`	List all #include dependencies for a header file
`ue_find_class_file`	Locate the header file for a UClass by name
`ue_generate_class`	Generate a new C++ class scaffold with UClass boilerplate
`ue_add_property`	Add a UPROPERTY declaration to an existing C++ class
`ue_add_function`	Add a UFUNCTION declaration to an existing C++ class
`ue_add_include`	Add an #include to a C++ source or header file

Tool	Description
`ue_search_api`	Full-text search over the local UE API documentation index
`ue_lookup_class`	Look up a UClass reference page — methods, properties, hierarchy
`ue_get_include_path`	Get the correct #include path for a UE class
`ue_check_deprecation`	Check if a class, function, or macro is deprecated in UE 5.7

Tool	Description
`ue_list_actors`	List actors in the current level with transforms and class info
`ue_spawn_actor`	Spawn an actor by class with optional label
`ue_transform_actor`	Move, rotate, scale, or set properties on an actor
`ue_delete_actor`	Delete an actor from the current level
`ue_set_actor_property`	Set any UPROPERTY on an actor or component by label (bool, int, float, string, name, actor ref, asset ref)
`ue_create_data_asset`	Create a UPrimaryDataAsset with reflection-set properties
`ue_create_curve`	Create a UCurveFloat asset with keyframes
`ue_query_assets`	Query the asset registry — search by class, path, or name
`ue_trace_references`	Trace all assets that reference or are referenced by an asset
`ue_read_level_layout`	Read the current level's actor graph and spatial layout

Tool	Description
`ue_list_abilities`	List all Gameplay Ability assets in the project
`ue_inspect_gameplay_effect`	Inspect a Gameplay Effect — modifiers, duration policy, and tags
`ue_read_attribute_set`	Read an Attribute Set class — attribute names and base values
`ue_query_gameplay_tags`	Query the Gameplay Tag hierarchy and registered tags

Tool	Description
`ue_import_fbx`	Import an FBX file as a Static Mesh or Skeletal Mesh asset
`ue_import_usd`	Import a USD file into the project
`ue_export_mesh`	Export a Static Mesh or Skeletal Mesh asset to FBX
`ue_batch_import`	Import multiple assets from a directory in a single operation

Tool	Description
`ue_list_input_actions`	List all Input Action assets in the project
`ue_create_input_action`	Create a new Input Action asset with a specified value type
`ue_list_input_contexts`	List all Input Mapping Context assets in the project
`ue_add_input_binding`	Add a key binding to an Input Mapping Context

Tool	Description
`ue_list_known_issues`	List all logged known issues for the current project session
`ue_add_known_issue`	Log a new known issue with severity and context for later resolution

Tool	Description
`ue_list_livelink_sources`	List all active Live Link sources and their connection status
`ue_list_livelink_subjects`	List all Live Link subjects from active sources
`ue_control_livelink_subject`	Enable, disable, or configure a Live Link subject
`ue_preview_livelink_data`	Preview current frame data for a Live Link subject

Tool	Description
`ue_material_params`	Read all scalar, vector, and texture parameters from a material
`ue_create_material_instance`	Create a Material Instance from a parent material
`ue_set_material_param`	Set a scalar, vector, or texture parameter on a Material Instance
`ue_actor_materials`	List all materials assigned to components on an actor

Tool	Description
`ue_list_scene_states`	List all Motion Design scene states
`ue_trigger_scene_transition`	Trigger a scene state transition
`ue_inspect_transition_logic`	Inspect the logic for a Motion Design scene transition
`ue_manage_remote_control`	Manage Motion Design remote control presets and bindings

Tool	Description
`ue_list_render_queue`	List all jobs in the Movie Render Queue
`ue_add_render_job`	Add a render job to the Movie Render Queue
`ue_control_render_queue`	Start, pause, or cancel the render queue
`ue_configure_render_output`	Configure output format, resolution, and path for a render job

Tool	Description
`ue_inspect_replication`	Inspect replication settings for an actor or component
`ue_list_replicated_properties`	List all UPROPERTY members with replication conditions
`ue_read_net_driver`	Read Net Driver configuration — tick rate, max clients, bandwidth
`ue_inspect_session`	Inspect the current network session state during PIE

Tool	Description
`ue_list_pcg_graphs`	List all PCG Graph assets in the project
`ue_inspect_pcg_graph`	Inspect a PCG Graph — nodes, connections, and parameters
`ue_execute_pcg_graph`	Execute a PCG Graph on a target actor
`ue_query_pcg_results`	Query the output data from the last PCG Graph execution

Tool	Description
`ue_select_actors`	Select actors in the editor by label, class, or spatial query
`ue_get_selection`	Get the current editor selection — actor labels and transforms
`ue_duplicate_actors`	Duplicate selected actors with optional offset
`ue_convert_actor`	Convert an actor to a different class in place

Tool	Description
`ue_create_sequence`	Create a new Level Sequence asset
`ue_list_sequence_tracks`	List all tracks in a Level Sequence
`ue_add_sequence_track`	Add a track (Transform, Property, Event, etc.) to a Level Sequence
`ue_add_keyframe`	Add a keyframe to a Sequencer track at a specific time
`ue_sequence_playback`	Control Sequencer playback — play, pause, stop, set time

Tool	Description
`ue_validate_asset`	Run Editor Validation on a single asset and return issues
`ue_validate_folder`	Validate all assets in a content folder
`ue_validate_project`	Run full project validation and return a summary report
`ue_check_blueprint`	Check a Blueprint for compilation errors without compiling

Tool	Description
`ue_editor_state`	Query selected actors, open assets, and viewport camera position
`ue_pie_start`	Start a Play In Editor (PIE) session
`ue_pie_stop`	Stop the active PIE session
`ue_pie_logs`	Read PIE output log lines since session start
`ue_pie_game_state`	Query runtime game state — actor positions, active GameMode
`ue_viewport_screenshot`	Capture the active viewport as an inline base64 image
`ue_viewport_camera`	Set camera position, rotation, FOV, or look-at target
`ue_viewport_render_mode`	Switch render mode: lit, unlit, wireframe, collision, detail_lighting
`ue_viewport_hires_screenshot`	High-resolution screenshot with configurable resolution multiplier
`ue_visual_review`	Quick screenshot for iterative visual review loops
`ue_look_at`	Navigate camera to an actor or world position with optional screenshot
`ue_orbit_review`	Multi-angle screenshots orbiting a target
`ue_iterate_scene`	Screenshot + nearby actor data in a single call
`ue_fly_through`	Camera waypoint walkthrough with a screenshot at each stop
`ue_focus_actor`	Auto-frame an actor by label with bounds-aware distance
`ue_cleanup_screenshots`	Delete MCP-generated screenshots to free disk space

Tool	Description
`ue_read_world_partition`	Read World Partition grid configuration and cell layout
`ue_manage_data_layers`	List, enable, or disable World Partition Data Layers
`ue_inspect_streaming_sources`	Inspect streaming source locations and activation radii
`ue_trigger_hlod_generation`	Trigger HLOD generation for a World Partition level

Visual Review Loop

The Viewport & Visual Review domain enables an AI to navigate, see, judge, and act — autonomously.

navigate → screenshot → inspect → adjust → verify → cleanup

Core tools:

Tool	Role in the loop
`ue_look_at`	Navigate camera to any actor or world position, auto-frame, screenshot
`ue_visual_review`	Quick screenshot with optional focus hint ("check the shadows on the left wall")
`ue_orbit_review`	Capture 2–12 angles around a target in one call
`ue_iterate_scene`	Screenshot + actor data together — orient yourself in one round trip
`ue_fly_through`	Waypoint walkthrough — systematic spatial survey of a level section
`ue_focus_actor`	Auto-frame a specific actor using its bounding box
`ue_cleanup_screenshots`	Delete all MCP screenshots when the session is done

What makes this different: Screenshots are returned as inline base64 images in the MCP response. The AI receives and interprets the image in the same tool call — no file paths to resolve, no secondary reads. The AI can see the scene, evaluate it, and call the next tool in the same turn.

Typical loop:

ue_look_at("TargetActor", angle="45deg")
  → [image inline] AI sees overexposed area
ue_transform_actor("TargetActor", {"Intensity": 500})
  → property updated
ue_orbit_review("TargetActor", angles=[0, 90, 180, 270])
  → [4 images inline] all clear from every angle
ue_cleanup_screenshots(confirm=true)
  → disk cleaned

Automatic Self-Verification

Verification isn't a suggestion. It's server-side enforced. Every mutating tool automatically queries actor.componentBounds after the mutation completes and appends the verification data to the response. The AI sees bounds, positions, and component state in the same tool call result, whether it asked for it or not. If something is wrong, the data is right there and impossible to miss.

Why this matters: In spatial work (placing doors, aligning meshes, wiring components), a single transform can have cascading effects — rotating a mesh around a pivot shifts its world position, negative scale flips face normals making geometry invisible, collision volumes don't automatically follow mesh offsets. Without verification, the AI reports "done" while the door is floating 2 meters from the wall.

How it works:

ue_spawn_actor("BP_Door", location={x:1040, y:150, z:0})
  → {actor_label: "BP_Door", _verification: {bounds: {min: {x:806}, max: {x:994}}}}
  ← bounds auto-appended by server — in the doorway ✓

ue_set_actor_property("BP_Door", "DoorMesh.RelativeRotation", ...)
  → {success: true, _verification: {bounds: {min: {x:1040}, max: {x:1228}}}}
  ← bounds shifted! rotation moved mesh out of gap ✗

ue_set_actor_property("BP_Door", "DoorMesh.RelativeLocation", ...)
  → {success: true, _verification: {bounds: {min: {x:806}, max: {x:994}}}}
  ← back in place after offset compensation ✓

ue_look_at("BP_Door", angle="front")
  → [screenshot inline] door visible, handle correct side ✓

The Inspect-Reason-Fix cycle:

Step	What happens	Tool
Act	Spawn, transform, or set property	`ue_spawn_actor`, `ue_transform_actor`, `ue_set_actor_property`
Measure	Get exact numerical positions	`ue_get_component_bounds`
Reason	Do bounds match expectations?	(AI reasoning)
Fix	Adjust offsets to compensate	Same mutation tools
Verify	Confirm fix worked, visually and numerically	`ue_get_component_bounds` + `ue_look_at`

The AI also has access to a ue://best-practices/self-verification MCP resource that documents verification patterns, common spatial pitfalls, and the full verification matrix.

Headless vs Live

Some tools work without the UE Editor running. Others require the MCPBridge plugin connected to a live editor instance.

Headless (no plugin required)	Live Editor Required
Read and write C++ headers	Actor spawn, move, delete
Parse UCLASS/UPROPERTY/UFUNCTION macros	Blueprint graph read/write
Generate C++ class scaffolds	Viewport screenshots
Read and write INI config files	PIE start/stop/logs
Read .uproject and plugin list	Asset registry queries
Trigger UnrealBuildTool builds	Animation Blueprint inspection
Parse build errors	Material parameter get/set
Search and browse API documentation	Level Sequencer control
Look up class include paths	World Partition management
Check deprecation status	GAS, PCG, Physics, Networking

The TypeScript server starts in headless mode by default. Tools that require the plugin return a structured plugin_not_connected error with a clear message — they never silently fail.

When the plugin IS running but an optional UE module isn't enabled (e.g., MetaSound, LiveLink, GAS), the handler returns module_not_available with the module name — no crash, no missing DLL errors. Enable the plugin in your project settings and the handler starts working automatically.

Installation

Option 1: npx (quickest)

npx ultimate-unreal-engine-mcp setup

Detects your MCP client and writes the config automatically.

Option 2: Global install

npm install -g ultimate-unreal-engine-mcp
ultimate-unreal-engine-mcp setup

Option 3: Clone for development

git clone https://github.com/your-org/ultimateunrealenginemcp
cd ultimateunrealenginemcp
npm install
npm run build

Client configuration

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "/path/to/your/UEProject",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

Cursor (.cursor/mcp.json in your project):

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "${workspaceFolder}",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

VS Code (.vscode/settings.json):

{
  "mcp.servers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "${workspaceFolder}",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

C++ Plugin Setup

The MCPBridge plugin provides the live editor connection. Without it, all file system and code generation tools still work.

Install:

Copy unreal-plugin/MCPBridge into your project's Plugins/ directory:

YourProject/
  Plugins/
    MCPBridge/
      MCPBridge.uplugin
      Source/
        MCPBridgeRuntime/
        MCPBridgeEditor/

Open your .uproject in a text editor and add the plugin:

{
  "Plugins": [
    {
      "Name": "MCPBridge",
      "Enabled": true
    }
  ]
}

Right-click the .uproject file and select "Generate Visual Studio project files" (or run UnrealBuildTool). Build the project from your IDE.
Open the project in the UE Editor. The MCPBridge plugin initializes automatically and listens on port 55557.

Verify the connection:

curl http://localhost:55557/health
# → {"status":"ok","version":"1.0"}

Change the port:

Set UE_PLUGIN_PORT in your MCP client config and restart the editor. The plugin reads the port from a config ini on startup.

Configuration

Variable	Default	Description
`UE_PROJECT_ROOT`	Current working directory	Absolute path to the root of your Unreal project (the folder containing the `.uproject` file)
`UE_PLUGIN_PORT`	`55557`	TCP port the MCPBridge plugin listens on inside the editor

Both variables are optional. UE_PROJECT_ROOT defaults to process.cwd(), which works correctly when the MCP server is started from inside the project directory.

Development

# Start dev server with hot reload
npm run dev

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Build production output
npm run build

# Lint
npm run lint

Test coverage: 1021 tests across 43 files.

The test suite covers all 26 tool domains, plugin bridge connection/disconnection behavior, INI config parsing edge cases, C++ header parsing with tree-sitter-unreal-cpp, and known-issues middleware.

Tech stack: TypeScript 5.x, Node.js 22+, @modelcontextprotocol/sdk 1.29.0, Zod 3.25+, Vitest 2.x, tree-sitter-unreal-cpp (WASM), MiniSearch, fast-glob, chokidar.

Requirements

Node.js 22+ — the MCP server runtime
MCP-compatible client — Claude Desktop, Cursor, VS Code with MCP extension, or any client implementing the MCP protocol
Unreal Engine 5.7 — required only for tools marked [requires_plugin]; file system tools work with any UE version

License

MIT — see LICENSE.

Ultimateunrealenginemcp

jeebus874stars

MCP server giving AI assistants full access to Unreal Engine 5.7 projects — 65+ tools, C++ editor plugin, visual review loop

Game Development

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Ultimateunrealenginemcp

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Last checked: 2026-10-28

Stars: 4
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Ultimateunrealenginemcp?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Ultimateunrealenginemcp need an API key?

No required environment variable is listed on this record.

What transport does Ultimateunrealenginemcp use?

Ultimateunrealenginemcp runs locally over stdio.

When was Ultimateunrealenginemcp last checked?

Last checked 2026-10-28. MCP server giving AI assistants full access to Unreal Engine 5.7 projects — 65+ tools, C++ editor plugin, visual review loop

From the publisher

Documentation

Ultimate Unreal Engine MCP

133 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.

MCP (Model Context Protocol) is a standard that lets AI assistants call tools on external systems — this server exposes Unreal Engine as those tools.

npx ultimate-unreal-engine-mcp setup

Quick Start
What You Can Do
Architecture
Tool Catalog
Visual Review Loop
Automatic Self-Verification
Headless vs Live
Installation
C++ Plugin Setup
Configuration
Development
Requirements
License

Quick Start

# Claude Desktop (default)
npx ultimate-unreal-engine-mcp setup

# Claude Code CLI
npx ultimate-unreal-engine-mcp setup --client claude-code

# Cursor
npx ultimate-unreal-engine-mcp setup --client cursor

# With a UE project (also installs the C++ plugin)
npx ultimate-unreal-engine-mcp setup --project "C:/MyGame"

Zero optional dependencies. The C++ plugin compiles on any UE 5.7 install — binary or source. All 133 tools use runtime reflection for optional UE modules (MetaSound, LiveLink, GAS, etc.), so the plugin loads regardless of which plugins your project has enabled. Handlers gracefully report when their target module isn't available.

What You Can Do

The following walkthrough shows AI autonomously setting up a point light, doing a visual review loop, and correcting an intensity problem — all without leaving the conversation.

Prompt: "Spawn a point light named MainLight at the center of the level, set its intensity to 5000, then take a screenshot so I can review it."

Step 1 — Spawn the actor

ue_spawn_actor(class="PointLight", label="MainLight", location={x:0, y:0, z:300})

Claude: Actor MainLight spawned at (0, 0, 300). UE returned actor_id: "PointLight_0".

Step 2 — Navigate camera to the actor

ue_look_at(target="MainLight", angle="45deg", screenshot=true)

Claude: Camera positioned. [Screenshot returned inline — shows a bright white sphere flooding the scene with overexposed light.]

Step 3 — Visual review — something is wrong

ue_visual_review(focus="check if the lighting looks blown out")

Claude: The scene is severely overexposed. The intensity of 5000 lm is too high for this room scale. Reducing to 800 lm.

Step 4 — Adjust the property

ue_transform_actor(label="MainLight", properties={"Intensity": 800})

Claude: Property Intensity updated to 800 on MainLight.

Step 5 — Verify the fix

ue_orbit_review(target="MainLight", angles=[0, 90, 180, 270])

Claude: [Four screenshots returned — front, right, back, left.] Lighting is balanced. No blown-out surfaces visible from any angle. The area is well-lit without overexposure.

Step 6 — Cleanup

ue_cleanup_screenshots(confirm=true)

Claude: 5 MCP-generated screenshots removed from disk.

This loop — spawn, navigate, inspect, adjust, verify — runs entirely from the AI conversation. No manual editor interaction required.

Architecture

graph TD
    A["AI Client\n(Claude / Cursor / VS Code)"]
    B["MCP Protocol\n(stdio JSON-RPC)"]
    C["TypeScript Server\nNode.js 22+"]
    D["TCP Port 55557"]
    E["C++ Plugin\nMCPBridge"]
    F["UE 5.7 Editor APIs"]

    A -->|tool calls| B
    B --> C
    C -->|file system ops\nC++ parsing\nconfig r/w\ndocs lookup\nbuild trigger| C
    C -->|actor CRUD\nBlueprint graphs\nviewport screenshots\nPIE control\nasset registry| D
    D --> E
    E --> F

    classDef ts fill:#3178c6,color:#fff,stroke:#2563eb
    classDef cpp fill:#f97316,color:#fff,stroke:#ea580c
    classDef ue fill:#76b900,color:#fff,stroke:#65a000
    classDef proto fill:#6b7280,color:#fff,stroke:#4b5563

    class C ts
    class E cpp
    class F ue
    class B,D proto

Tool Catalog

Tool	Description
`ue_inspect_behavior_tree`	Inspect a Behavior Tree asset — tasks, decorators, services, and composite nodes
`ue_inspect_state_tree`	Inspect a State Tree asset — states, transitions, and evaluators
`ue_inspect_blackboard`	Read Blackboard asset key definitions and their types
`ue_inspect_eqs`	Inspect an Environment Query System asset — tests and generators
`ue_query_navmesh`	Query NavMesh coverage for a location or actor

Tool	Description
`ue_list_animation_assets`	List animation assets in the project, optionally filtered by type
`ue_inspect_anim_blueprint`	Inspect AnimBP state machines, states, and transitions
`ue_inspect_montage`	Read montage sections, notifies, and slot assignments
`ue_inspect_blend_space`	Inspect blend space axes, samples, and grid configuration
`ue_read_retarget_mappings`	Read IK Retargeter source/target rig and chain mappings

Tool	Description
`ue_list_sound_assets`	List all sound assets in the project
`ue_inspect_metasound`	Inspect a MetaSound asset — nodes, inputs, outputs, and patches
`ue_inspect_sound_cue`	Inspect a Sound Cue asset — nodes and audio connections
`ue_query_audio_insights`	Query Audio Insights data for active sounds and buses

Tool	Description
`ue_read_blueprint`	Read a Blueprint asset — class defaults, components, and interfaces
`ue_list_blueprints`	List Blueprint assets matching a class filter
`ue_read_blueprint_graph`	Read Blueprint graph nodes, pins, and connections
`ue_create_blueprint`	Create a new Blueprint class with a specified parent
`ue_add_blueprint_node`	Add a function call or event node to a Blueprint graph
`ue_connect_blueprint_pins`	Connect two pins in a Blueprint graph
`ue_add_blueprint_variable`	Add a new variable to a Blueprint class
`ue_set_blueprint_default`	Set a Blueprint class default property value
`ue_cpp_exposed_members`	List C++ properties and functions exposed to Blueprint in a class
`ue_find_blueprint_subclasses`	Find all Blueprints that subclass a given C++ or Blueprint class
`ue_trace_cpp_in_blueprints`	Find all Blueprints referencing a specific C++ class

Tool	Description
`ue_build`	Trigger a UnrealBuildTool build for a target and configuration
`ue_get_build_errors`	Read the latest build output and parse compiler errors

Tool	Description
`ue_inspect_geometry_collection`	Inspect a Geometry Collection asset — fracture levels and clusters
`ue_reset_destruction`	Reset a destructible actor to its initial un-fractured state
`ue_read_cloth_params`	Read Chaos Cloth asset simulation parameters
`ue_manage_physics_cache`	Manage Chaos physics cache recording and playback

Tool	Description
`ue_read_collision`	Read collision profile, channels, and response matrix for an actor or component
`ue_set_collision`	Set collision preset or individual channel responses
`ue_manage_physical_material`	Read or update Physical Material properties
`ue_inspect_physics_asset`	Inspect a Physics Asset — bodies, constraints, and welded bones

Tool	Description
`ue_read_config`	Read a UE INI config file section or key
`ue_write_config`	Write or update a key in a UE INI config file
`ue_read_uproject`	Read .uproject metadata — engine version, plugins, target platforms
`ue_list_plugins`	List all plugins enabled in the project with their versions

Tool	Description
`ue_read_cpp_class`	Parse a C++ header and return UCLASS, UPROPERTY, and UFUNCTION metadata
`ue_get_class_hierarchy`	Walk the class hierarchy from a UClass up to UObject
`ue_trace_includes`	List all #include dependencies for a header file
`ue_find_class_file`	Locate the header file for a UClass by name
`ue_generate_class`	Generate a new C++ class scaffold with UClass boilerplate
`ue_add_property`	Add a UPROPERTY declaration to an existing C++ class
`ue_add_function`	Add a UFUNCTION declaration to an existing C++ class
`ue_add_include`	Add an #include to a C++ source or header file

Tool	Description
`ue_search_api`	Full-text search over the local UE API documentation index
`ue_lookup_class`	Look up a UClass reference page — methods, properties, hierarchy
`ue_get_include_path`	Get the correct #include path for a UE class
`ue_check_deprecation`	Check if a class, function, or macro is deprecated in UE 5.7

Tool	Description
`ue_list_actors`	List actors in the current level with transforms and class info
`ue_spawn_actor`	Spawn an actor by class with optional label
`ue_transform_actor`	Move, rotate, scale, or set properties on an actor
`ue_delete_actor`	Delete an actor from the current level
`ue_set_actor_property`	Set any UPROPERTY on an actor or component by label (bool, int, float, string, name, actor ref, asset ref)
`ue_create_data_asset`	Create a UPrimaryDataAsset with reflection-set properties
`ue_create_curve`	Create a UCurveFloat asset with keyframes
`ue_query_assets`	Query the asset registry — search by class, path, or name
`ue_trace_references`	Trace all assets that reference or are referenced by an asset
`ue_read_level_layout`	Read the current level's actor graph and spatial layout

Tool	Description
`ue_list_abilities`	List all Gameplay Ability assets in the project
`ue_inspect_gameplay_effect`	Inspect a Gameplay Effect — modifiers, duration policy, and tags
`ue_read_attribute_set`	Read an Attribute Set class — attribute names and base values
`ue_query_gameplay_tags`	Query the Gameplay Tag hierarchy and registered tags

Tool	Description
`ue_import_fbx`	Import an FBX file as a Static Mesh or Skeletal Mesh asset
`ue_import_usd`	Import a USD file into the project
`ue_export_mesh`	Export a Static Mesh or Skeletal Mesh asset to FBX
`ue_batch_import`	Import multiple assets from a directory in a single operation

Tool	Description
`ue_list_input_actions`	List all Input Action assets in the project
`ue_create_input_action`	Create a new Input Action asset with a specified value type
`ue_list_input_contexts`	List all Input Mapping Context assets in the project
`ue_add_input_binding`	Add a key binding to an Input Mapping Context

Tool	Description
`ue_list_known_issues`	List all logged known issues for the current project session
`ue_add_known_issue`	Log a new known issue with severity and context for later resolution

Tool	Description
`ue_list_livelink_sources`	List all active Live Link sources and their connection status
`ue_list_livelink_subjects`	List all Live Link subjects from active sources
`ue_control_livelink_subject`	Enable, disable, or configure a Live Link subject
`ue_preview_livelink_data`	Preview current frame data for a Live Link subject

Tool	Description
`ue_material_params`	Read all scalar, vector, and texture parameters from a material
`ue_create_material_instance`	Create a Material Instance from a parent material
`ue_set_material_param`	Set a scalar, vector, or texture parameter on a Material Instance
`ue_actor_materials`	List all materials assigned to components on an actor

Tool	Description
`ue_list_scene_states`	List all Motion Design scene states
`ue_trigger_scene_transition`	Trigger a scene state transition
`ue_inspect_transition_logic`	Inspect the logic for a Motion Design scene transition
`ue_manage_remote_control`	Manage Motion Design remote control presets and bindings

Tool	Description
`ue_list_render_queue`	List all jobs in the Movie Render Queue
`ue_add_render_job`	Add a render job to the Movie Render Queue
`ue_control_render_queue`	Start, pause, or cancel the render queue
`ue_configure_render_output`	Configure output format, resolution, and path for a render job

Tool	Description
`ue_inspect_replication`	Inspect replication settings for an actor or component
`ue_list_replicated_properties`	List all UPROPERTY members with replication conditions
`ue_read_net_driver`	Read Net Driver configuration — tick rate, max clients, bandwidth
`ue_inspect_session`	Inspect the current network session state during PIE

Tool	Description
`ue_list_pcg_graphs`	List all PCG Graph assets in the project
`ue_inspect_pcg_graph`	Inspect a PCG Graph — nodes, connections, and parameters
`ue_execute_pcg_graph`	Execute a PCG Graph on a target actor
`ue_query_pcg_results`	Query the output data from the last PCG Graph execution

Tool	Description
`ue_select_actors`	Select actors in the editor by label, class, or spatial query
`ue_get_selection`	Get the current editor selection — actor labels and transforms
`ue_duplicate_actors`	Duplicate selected actors with optional offset
`ue_convert_actor`	Convert an actor to a different class in place

Tool	Description
`ue_create_sequence`	Create a new Level Sequence asset
`ue_list_sequence_tracks`	List all tracks in a Level Sequence
`ue_add_sequence_track`	Add a track (Transform, Property, Event, etc.) to a Level Sequence
`ue_add_keyframe`	Add a keyframe to a Sequencer track at a specific time
`ue_sequence_playback`	Control Sequencer playback — play, pause, stop, set time

Tool	Description
`ue_validate_asset`	Run Editor Validation on a single asset and return issues
`ue_validate_folder`	Validate all assets in a content folder
`ue_validate_project`	Run full project validation and return a summary report
`ue_check_blueprint`	Check a Blueprint for compilation errors without compiling

Tool	Description
`ue_editor_state`	Query selected actors, open assets, and viewport camera position
`ue_pie_start`	Start a Play In Editor (PIE) session
`ue_pie_stop`	Stop the active PIE session
`ue_pie_logs`	Read PIE output log lines since session start
`ue_pie_game_state`	Query runtime game state — actor positions, active GameMode
`ue_viewport_screenshot`	Capture the active viewport as an inline base64 image
`ue_viewport_camera`	Set camera position, rotation, FOV, or look-at target
`ue_viewport_render_mode`	Switch render mode: lit, unlit, wireframe, collision, detail_lighting
`ue_viewport_hires_screenshot`	High-resolution screenshot with configurable resolution multiplier
`ue_visual_review`	Quick screenshot for iterative visual review loops
`ue_look_at`	Navigate camera to an actor or world position with optional screenshot
`ue_orbit_review`	Multi-angle screenshots orbiting a target
`ue_iterate_scene`	Screenshot + nearby actor data in a single call
`ue_fly_through`	Camera waypoint walkthrough with a screenshot at each stop
`ue_focus_actor`	Auto-frame an actor by label with bounds-aware distance
`ue_cleanup_screenshots`	Delete MCP-generated screenshots to free disk space

Tool	Description
`ue_read_world_partition`	Read World Partition grid configuration and cell layout
`ue_manage_data_layers`	List, enable, or disable World Partition Data Layers
`ue_inspect_streaming_sources`	Inspect streaming source locations and activation radii
`ue_trigger_hlod_generation`	Trigger HLOD generation for a World Partition level

Visual Review Loop

The Viewport & Visual Review domain enables an AI to navigate, see, judge, and act — autonomously.

navigate → screenshot → inspect → adjust → verify → cleanup

Core tools:

Tool	Role in the loop
`ue_look_at`	Navigate camera to any actor or world position, auto-frame, screenshot
`ue_visual_review`	Quick screenshot with optional focus hint ("check the shadows on the left wall")
`ue_orbit_review`	Capture 2–12 angles around a target in one call
`ue_iterate_scene`	Screenshot + actor data together — orient yourself in one round trip
`ue_fly_through`	Waypoint walkthrough — systematic spatial survey of a level section
`ue_focus_actor`	Auto-frame a specific actor using its bounding box
`ue_cleanup_screenshots`	Delete all MCP screenshots when the session is done

Typical loop:

ue_look_at("TargetActor", angle="45deg")
  → [image inline] AI sees overexposed area
ue_transform_actor("TargetActor", {"Intensity": 500})
  → property updated
ue_orbit_review("TargetActor", angles=[0, 90, 180, 270])
  → [4 images inline] all clear from every angle
ue_cleanup_screenshots(confirm=true)
  → disk cleaned

Automatic Self-Verification

How it works:

ue_spawn_actor("BP_Door", location={x:1040, y:150, z:0})
  → {actor_label: "BP_Door", _verification: {bounds: {min: {x:806}, max: {x:994}}}}
  ← bounds auto-appended by server — in the doorway ✓

ue_set_actor_property("BP_Door", "DoorMesh.RelativeRotation", ...)
  → {success: true, _verification: {bounds: {min: {x:1040}, max: {x:1228}}}}
  ← bounds shifted! rotation moved mesh out of gap ✗

ue_set_actor_property("BP_Door", "DoorMesh.RelativeLocation", ...)
  → {success: true, _verification: {bounds: {min: {x:806}, max: {x:994}}}}
  ← back in place after offset compensation ✓

ue_look_at("BP_Door", angle="front")
  → [screenshot inline] door visible, handle correct side ✓

The Inspect-Reason-Fix cycle:

Step	What happens	Tool
Act	Spawn, transform, or set property	`ue_spawn_actor`, `ue_transform_actor`, `ue_set_actor_property`
Measure	Get exact numerical positions	`ue_get_component_bounds`
Reason	Do bounds match expectations?	(AI reasoning)
Fix	Adjust offsets to compensate	Same mutation tools
Verify	Confirm fix worked, visually and numerically	`ue_get_component_bounds` + `ue_look_at`

The AI also has access to a ue://best-practices/self-verification MCP resource that documents verification patterns, common spatial pitfalls, and the full verification matrix.

Headless vs Live

Some tools work without the UE Editor running. Others require the MCPBridge plugin connected to a live editor instance.

Headless (no plugin required)	Live Editor Required
Read and write C++ headers	Actor spawn, move, delete
Parse UCLASS/UPROPERTY/UFUNCTION macros	Blueprint graph read/write
Generate C++ class scaffolds	Viewport screenshots
Read and write INI config files	PIE start/stop/logs
Read .uproject and plugin list	Asset registry queries
Trigger UnrealBuildTool builds	Animation Blueprint inspection
Parse build errors	Material parameter get/set
Search and browse API documentation	Level Sequencer control
Look up class include paths	World Partition management
Check deprecation status	GAS, PCG, Physics, Networking

The TypeScript server starts in headless mode by default. Tools that require the plugin return a structured plugin_not_connected error with a clear message — they never silently fail.

Installation

Option 1: npx (quickest)

npx ultimate-unreal-engine-mcp setup

Detects your MCP client and writes the config automatically.

Option 2: Global install

npm install -g ultimate-unreal-engine-mcp
ultimate-unreal-engine-mcp setup

Option 3: Clone for development

git clone https://github.com/your-org/ultimateunrealenginemcp
cd ultimateunrealenginemcp
npm install
npm run build

Client configuration

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "/path/to/your/UEProject",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

Cursor (.cursor/mcp.json in your project):

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "${workspaceFolder}",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

VS Code (.vscode/settings.json):

{
  "mcp.servers": {
    "unreal": {
      "command": "npx",
      "args": ["ultimate-unreal-engine-mcp"],
      "env": {
        "UE_PROJECT_ROOT": "${workspaceFolder}",
        "UE_PLUGIN_PORT": "55557"
      }
    }
  }
}

C++ Plugin Setup

The MCPBridge plugin provides the live editor connection. Without it, all file system and code generation tools still work.

Install:

Copy unreal-plugin/MCPBridge into your project's Plugins/ directory:

YourProject/
  Plugins/
    MCPBridge/
      MCPBridge.uplugin
      Source/
        MCPBridgeRuntime/
        MCPBridgeEditor/

Open your .uproject in a text editor and add the plugin:

{
  "Plugins": [
    {
      "Name": "MCPBridge",
      "Enabled": true
    }
  ]
}

Right-click the .uproject file and select "Generate Visual Studio project files" (or run UnrealBuildTool). Build the project from your IDE.
Open the project in the UE Editor. The MCPBridge plugin initializes automatically and listens on port 55557.

Verify the connection:

curl http://localhost:55557/health
# → {"status":"ok","version":"1.0"}

Change the port:

Set UE_PLUGIN_PORT in your MCP client config and restart the editor. The plugin reads the port from a config ini on startup.

Configuration

Variable	Default	Description
`UE_PROJECT_ROOT`	Current working directory	Absolute path to the root of your Unreal project (the folder containing the `.uproject` file)
`UE_PLUGIN_PORT`	`55557`	TCP port the MCPBridge plugin listens on inside the editor

Both variables are optional. UE_PROJECT_ROOT defaults to process.cwd(), which works correctly when the MCP server is started from inside the project directory.

Development

# Start dev server with hot reload
npm run dev

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Build production output
npm run build

# Lint
npm run lint

Test coverage: 1021 tests across 43 files.

The test suite covers all 26 tool domains, plugin bridge connection/disconnection behavior, INI config parsing edge cases, C++ header parsing with tree-sitter-unreal-cpp, and known-issues middleware.

Tech stack: TypeScript 5.x, Node.js 22+, @modelcontextprotocol/sdk 1.29.0, Zod 3.25+, Vitest 2.x, tree-sitter-unreal-cpp (WASM), MiniSearch, fast-glob, chokidar.

Requirements

Node.js 22+ — the MCP server runtime
MCP-compatible client — Claude Desktop, Cursor, VS Code with MCP extension, or any client implementing the MCP protocol
Unreal Engine 5.7 — required only for tools marked [requires_plugin]; file system tools work with any UE version

License

MIT — see LICENSE.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Ultimateunrealenginemcp?

Does Ultimateunrealenginemcp need an API key?

What transport does Ultimateunrealenginemcp use?

When was Ultimateunrealenginemcp last checked?

Documentation

Ultimate Unreal Engine MCP

Table of Contents

Quick Start

What You Can Do

Architecture

Tool Catalog

Visual Review Loop

Automatic Self-Verification

Headless vs Live

Installation

Option 1: npx (quickest)

Option 2: Global install

Option 3: Clone for development

Client configuration

C++ Plugin Setup

Configuration

Development

Requirements

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Ultimateunrealenginemcp?

Does Ultimateunrealenginemcp need an API key?

What transport does Ultimateunrealenginemcp use?

When was Ultimateunrealenginemcp last checked?

Documentation

Ultimate Unreal Engine MCP

Table of Contents

Quick Start

What You Can Do

Architecture

Tool Catalog

Visual Review Loop

Automatic Self-Verification

Headless vs Live

Installation

Option 1: npx (quickest)

Option 2: Global install

Option 3: Clone for development

Client configuration

C++ Plugin Setup

Configuration

Development

Requirements

License