SSyncDev

UEAgent MCP Server

An Unreal Engine 5.7/5.8 editor plugin that is itself the MCP server, with 1,500+ tools and readback checks on every change.

Local server

What is the UEAgent MCP Server?

Asking an AI agent to drive the Unreal Editor has an obvious failure mode: the editor reports success: true and nothing actually changed. UEAgent is built around that problem. The UEAgent MCP server is an Unreal Engine 5.7 and 5.8 editor plugin that serves Streamable HTTP from inside the editor itself, with no Python or Node bridge, and wraps every call in checks before and after it runs.

Preconditions refuse calls known to crash or freeze the editor and suggest an alternative. Readback then re-reads the state, and reports as failed any write that did not stick or that landed in the wrong Play-in-Editor world.

Scope

More than 1,500 tools span Blueprints and their graphs, materials, animation, Niagara, landscapes and foliage, World Partition, PCG, Sequencer, UMG, GAS, Behavior Trees and StateTree, MetaSounds, USD and PIE control. To keep a client's context manageable, the default list holds 11 core tools plus four that search, describe and run the rest. Append ?tools=all to the URL for everything, or ?tools=compact for three.

Typical requests and the tools behind them:

Request Tools involved
Build a door Blueprint with a trigger create_blueprint, add_component_to_blueprint, build_blueprint_graph, compile_blueprint
Find Blueprints that fail to compile find_erroring_blueprints, lint_blueprint_graph
Play the level and grab a screenshot start_play_in_editor, capture_pie_screenshot, stop_play_in_editor

Installing and connecting

Download the release zip matching your engine and unzip it into your project's Plugins folder, or build from source with Visual Studio 2022. When the project opens, the status bar shows MCP · 55561 with a green dot. That menu can write the .mcp.json entry for Claude Code, or set up Cursor, VS Code and others. The command below does the same for Claude Code in your own user scope.

Safety controls you should actually set

The tools act with the editor's full rights. They can run Python, write files, delete assets and launch processes. Connecting an agent effectively hands it the editor, so the guard rails matter:

  • Each tool call is a single undo step, so Ctrl+Z reverts it.
  • Read Only Content Roots protect vendored packs from being saved, renamed, moved or deleted.
  • Read-only mode limits an agent to reading and image capture.
  • Turning off code execution hides the seven tools that run code or processes.
  • An auth token, read from UEAGENT_TOKEN, stops other local processes calling the server.

The server binds to 127.0.0.1 only and sends no telemetry.

Caveats

The UEAgent MCP server is Windows (Win64) only, and a few tools need 5.8. Game Features tools work only once your project enables that plugin. If you would rather query engine documentation than operate the editor, look at Unreal Engine API Documentation or the wider games category.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
create_blueprintCreates a new Blueprint asset.
add_component_to_blueprintAdds a component, such as a mesh or trigger, to a Blueprint.
build_blueprint_graphBuilds nodes and connections in a Blueprint graph.
compile_blueprintCompiles a Blueprint and reports the result.
find_erroring_blueprintsFinds Blueprints that do not compile.
lint_blueprint_graphChecks a Blueprint graph for problems.
create_material_instanceCreates a material instance from a parent material.
set_actor_materialAssigns a material to actors in the level.
start_play_in_editorStarts a Play-in-Editor session.
capture_pie_screenshotCaptures a screenshot of the running PIE session.
create_level_sequenceCreates a Sequencer level sequence.
audit_asset_referencesReports which assets reference a given package or content root.

How to install the UEAgent MCP Server

claude mcp add --transport http unreal http://127.0.0.1:55561/mcp

Configuration

VariableDescriptionRequired
UEAGENT_TOKENAuth token read by the generated .mcp.json entry. Needed only when an Auth token is set in the plugin's Editor Preferences.Optional
UEAGENT_READONLYSet to 1 to start the server in read-only mode, where only reading and image-capture tools are listed and run.Optional

Frequently asked questions

Unreal Engine 5.7 and 5.8 on Windows (Win64). Each release ships a zip per engine version, and a few tools require 5.8.