# UnrealMCP — AI Bridge for Unreal Engine 5

Wires an AI client into the Unreal Engine 5 editor: materials, Blueprints, Niagara, actors and data tables. Handy when you would rather stay in the terminal.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Author: aadeshrao123
- License: MPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aadeshrao123/Unreal-MCP
- Updated: 2026-08-06
- HTML: https://affpapa.org/en/nevibecode/mcp/unrealmcp-ai-bridge-for-unreal-engine-5

## What it does

A C++ plugin called `UnrealMCPBridge` runs inside the editor and serves 288 commands across 15 categories over TCP on `localhost:55557`. The Python MCP server is one of two front doors to that plugin; the other is the Go CLI `ue-cli`. Both speak TCP/JSON to the same bridge.

Install the server with `pip install unrealmcp`, but that alone gets you nowhere. You still have to clone the plugin into your project's `Plugins/UnrealMCP`, enable it in the `.uproject`, and compile it in the editor. Python 3.10+ and Unreal Engine 5.3 or newer are the floor.

This is the community build. What it covers works, and issues still get read, but new subsystem work happens in the commercial CodeFizz Editor Agent instead. Control Rig, PCG, Sequencer, MetaSounds, Behavior Trees and EQS are Pro-only, and there are no prebuilt binaries for UE 5.6, 5.7 or 5.8 here — you build the plugin yourself.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Works with: Unreal Engine

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add unreal-mcp -- uvx unrealmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from unrealmcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add unrealmcp-ai-bridge-for-unreal-engine-5 -- uvx unrealmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from unrealmcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unrealmcp-ai-bridge-for-unreal-engine-5": {
            "command": "uvx",
            "args": [
                "unrealmcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from unrealmcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unrealmcp-ai-bridge-for-unreal-engine-5": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "unrealmcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from unrealmcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add unrealmcp-ai-bridge-for-unreal-engine-5 uvx unrealmcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from unrealmcp <command>

## When to use it
- build a material graph without opening the editor
- place a list of actors in the level
- read rows out of a data table
- wire up Blueprint graph nodes
- set up a Niagara system from the terminal

## Example prompts
- Build the material `/Game/M_Test` from the nodes I describe
- Find every material under `/Game` and list them
- Spawn a StaticMeshActor named MyCube at height 100

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md