Unreal MCP
An MCP server that lets an agent control the Unreal Engine editor in words: actors, blueprints, node graphs, camera
- 2,115 ★ on the repository
- Last commit
Extended access
Why this level
- The server runs locally and controls the open Unreal editor over TCP
- It changes project contents: it creates actors, blueprints and graph nodes
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/unreal-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server runs locally and controls the open Unreal editor over TCP
- It changes project contents: it creates actors, blueprints and graph nodes
This is third-party code. Review the repository files before installing.
What it does
The project connects a coding agent to the Unreal Engine editor over the MCP protocol. It consists of a C++ plugin that runs a TCP server inside the editor and a Python FastMCP server that receives the agent's commands and forwards them to the plugin. In natural language the agent creates and deletes actors, sets their transforms, assembles Blueprint classes with components, adds nodes and variables to the graph and aims the viewport camera. The author marks the project as experimental, and the capability list is in the Docs folder.
Who it is for. For game developers and technical artists on Unreal Engine who want to automate editor routine through an agent.
Good fit when
- You want to create and place actors or assemble blueprints with natural language commands
- You want to automate repetitive actions in the Unreal Engine 5.5 editor
- You need a bridge between a coding agent and an open Unreal project
Not a fit when
- You need production-grade stability rather than an experimental tool
- You cannot build the C++ plugin and set up Unreal Engine 5.5
Example request
Create a cube and a point light in the current level, raise the light by two meters and aim the viewport camera at itMCP
- Transport
- stdio
- Authentication
- not required
Limitations
The project is marked experimental, so breaking changes and documentation gaps are possible. It needs Unreal Engine 5.5 or newer, Python 3.10 or newer and the uv manager, and the C++ plugin must be built in the project. The Unreal editor must be open and running, with communication over the local TCP port 55557. There is no PyPI package; the server runs from source via uv.
How to disable. Remove the server entry from your client's MCP config and disable the UnrealMCP plugin under Edit, Plugins in the Unreal editor.
FAQ
Is this a finished product?
No, the author marks it experimental: the API and features may change without notice.
What is needed to run the server?
The built UnrealMCP plugin in the project, a running Unreal 5.5 editor and the Python server started via uv. Communication goes over a local TCP port.
How is Unreal MCP different from other Unreal Engine agent integrations?
The project has a C++ plugin that starts a TCP server inside the Unreal Engine editor and a Python server on FastMCP. The agent controls actors, blueprints, graph nodes and the camera in words.
What is the Unreal MCP server for and what do I need to run it?
It lets an agent control the Unreal Engine editor with plain phrases. Clone the repository with git clone https://github.com/chongdashu/unreal-mcp.git, install the plugin into your project and run the Python server. It works with Cursor, Windsurf, Claude Desktop and Claude Code.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for Unreal Engine: control assets, actors, the editor, sequencer and blueprints
An MCP server for Unreal Editor: an agent edits levels, Blueprints and materials, then builds the project from plain requests
An Unreal Engine plugin with MCP: the agent drives the editor via RQL, edits Blueprints and C++, captures viewport shots; cloud or own server
Unreal MCP on Python: 253 actions across 21 domains, from actors and Blueprints to materials and cinematics, plus running any Python in the editor
An Unreal Engine plugin with an MCP server: Claude and Cursor create blueprints, spawn objects and run editor commands
A Python CLI and MCP server that lets an agent spawn actors, edit Blueprints and run PIE sessions in Unreal Engine 5
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Unreal MCP (this card) | no | not required | 2,115 | |
| Flopperam Unreal Engine MCP | no | API key | 1,117 | unreal Engine MCP |
| Unreal MCP (GenOrca) | no | not required | 148 | unreal MCP on Python |
| AI Game Developer: Unreal MCP | no | OAuth | 60 | an Unreal Engine plugin with MCP |
README in short
The README presents a bridge between AI clients such as Cursor, Windsurf and Claude Desktop and the Unreal Engine editor over the MCP protocol. The project consists of a sample Unreal project, a C++ plugin with a native TCP server and a Python FastMCP server that loads tool modules for actors, blueprints, nodes and the editor. Installation is described in two parts: building the plugin in Unreal 5.5 and setting up the Python environment via uv, after which the server is added to the MCP client config with a uv run command. The status is explicitly called experimental. MIT licensed.