Log inSubmit server
Unreal MCP Ue4 logo

Unreal MCP Ue4

Controls an open Unreal Engine 4.27.2 editor through Python Remote Execution and MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Unreal MCP Ue4

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "unreal-mcp-ue4": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-mcp-ue4"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 34 tools correctly (3d ago).

Overview

The unreal-mcp-ue4 MCP server exposes an open Unreal Engine 4.27.2 editor through Unreal’s built-in Python Remote Execution. It provides namespace-based tools for project, map, level, asset, actor, Blueprint, UMG, and sequence workflows, plus direct actor operations and Python execution. Use it when an MCP client needs to inspect or modify a UE4.27.2 project without installing a custom C++ plugin. The editor must remain open with the required scripting plugins and remote execution enabled.

Use cases

  • Inspect the current UE4 project and level
  • Spawn and transform actors in an open level
  • Search assets and inspect their metadata
  • Create supported data assets and Blueprint content
  • Prototype unsupported editor operations with Python

Key features

  • UE4.27.2 Python Remote Execution
  • Namespace-based MCP tools
  • Actor lifecycle and transform operations
  • Asset and project inspection
  • Blueprint and UMG editing
  • Editor Python escape hatch

Tools34

What Unreal MCP Ue4 lets your agent do. Expand a tool for its parameters.

Verified live~20.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 36d

What it can do

From the 34 tools this server returned when we ran it.

Can delete or modify data · 2Read-only tools · 32
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age203 days
Maintainers1

Observed 2026-10-21 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16h ago via OSV.dev · unreal-mcp-ue4 (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars27Stargazers on the source repository.
npm downloads807Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed34Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Unreal MCP Ue4 works

What unreal-mcp-ue4 MCP server does

The unreal-mcp-ue4 MCP server lets an MCP client work with a running Unreal Engine 4.27.2 editor. It is designed for UE4.27.2 rather than UE5, and its supported operations follow the Python APIs and editor scripting capabilities available in that release.

The server can read project and map details, inspect the current level, search assets, examine metadata and references, and manage actors. It also supports creating common data assets, editing supported Blueprint assets, and building or modifying Widget Blueprint trees with UE4-compatible UMG helpers. Some sequence operations are available when SequencerScripting is enabled.

How it works

Communication uses Unreal Engine’s built-in Python Remote Execution path. The repository does not provide a separate Unreal C++ plugin. The MCP process runs through stdio, while commands are sent to the open editor session.

Most functionality is grouped into manage_* namespace tools. Each namespace dispatches an action with a corresponding params object, allowing MCP clients to discover action-specific input schemas. Recommended read entry points include manage_editor with project_info or map_info, and manage_level with world_outliner. manage_editor.run_python provides a lower-level option for debugging, prototyping, or API areas that do not yet have stable wrappers.

Setup and configuration

Install Node.js 18 or newer and npm. The published package can be installed globally with npm install -g unreal-mcp-ue4, or started with npx unreal-mcp-ue4. A source checkout can be installed, built with npm run build, and launched through its generated dist/bin.js file.

In the target UE4.27.2 project, enable Python Editor Script Plugin and Editor Scripting Utilities. Enable SequencerScripting for the documented sequence actions, including actor bindings, track and key edits, camera cuts, playback ranges, and speed-track analysis. In Project Settings under Python, enable Enable Remote Execution, then restart the editor when requested.

Register the command or the built dist/bin.js path in the MCP client configuration. Keep the target project open while using the server. A small read-only request such as project information, map information, or the current world outliner is a suitable first check.

Tools and capabilities

The unreal-mcp-ue4 MCP server includes capabilities for:

  • Reading project, map, asset, and actor information.
  • Listing and inspecting actors in the current level.
  • Creating, transforming, inspecting, and deleting actors.
  • Searching assets and reviewing references or metadata.
  • Creating DataAsset and StringTable assets.
  • Creating and editing supported Blueprint assets.
  • Creating and editing Widget Blueprint trees through UE4-safe UMG helpers.
  • Managing supported sequence, track, binding, camera-cut, playback, and speed-track operations.
  • Running arbitrary editor Python through the editor management namespace.

Direct tools are intended mainly for lower-level primitives such as Unreal session path discovery and actor lifecycle operations. Namespace tools are the preferred general interface.

Limitations and notes

The target is UE4.27.2, and UE5-only editor scripting behavior is not added back into the server. Operations that are unreliable or unavailable in UE4.27 may be omitted or return an explicit message rather than silently failing.

Any connected MCP client can inspect and modify the open Unreal Editor session. Test with a disposable project before using asset or world-generation operations. The project remains under active development, so UE4.27-specific bugs and rough edges may occur.

The no-Unreal smoke test checks startup, discovery, namespace schemas, and validation without opening Unreal. The end-to-end smoke test requires an already running editor and checks representative reads, source-control state reads, and actor create, update, and delete flows.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Unreal MCP Ue4

unreal-mcp-ue4 is an MCP server that connects MCP clients to an open Unreal Engine 4.27.2 editor through Python Remote Execution. Its main tools inspect projects, maps, assets, levels, and actors; create or modify actors and supported assets; edit Blueprint and UMG content; and run editor Python.

Install it with `npm install -g unreal-mcp-ue4`, or run it with `npx unreal-mcp-ue4`. You can also clone the repository, run `npm install` and `npm run build`, then configure your MCP client to launch `dist/bin.js`.

Enable Python Editor Script Plugin, Editor Scripting Utilities, and Python Enable Remote Execution in the UE4.27.2 project. Enable SequencerScripting for sequence workflows, restart the editor as needed, and keep the project open while the configured MCP client launches the server.

Yes. Cursor is listed among the supported MCP clients. Configure it to launch the globally installed `unreal-mcp-ue4` command or the `dist/bin.js` file from a local source build, then use the server while the configured UE4.27.2 project is open.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewUnreal MCP Ue4 AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/unreal-mcp-ue4?style=directory)](https://allmcps.com/mcp/unreal-mcp-ue4)
HTML Embed
<a href="https://allmcps.com/mcp/unreal-mcp-ue4"><img src="https://allmcps.com/api/badge/unreal-mcp-ue4?style=directory" alt="Unreal MCP Ue4 on AllMCPs" /></a>