# Unreal Engine MCP

> Unreal Engine MCP is an open-source MCP server for developer tools. Drive a running Unreal Editor from an AI client through a single searchable tool. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, self-hosted
- **Website:** https://enginewire.dev
- **Repository:** https://github.com/chir24/unreal_mcp
- **MCP Registry name:** io.github.ChiR24/unreal-engine-mcp
- **Categories:** developer tools, games and play
- **Listing updated:** 2026-11-14

## About

Rather than loading hundreds of tool schemas up front, EngineWire exposes one MCP tool named unreal with three operations. The model searches in plain words, asks for the exact contract of the capability it found, and then executes it with checked parameters, receiving a receipt of what changed. An unknown name is refused.

The work runs inside the editor through a native C++ plugin, which serves MCP itself over HTTP on localhost, or via a Node.js stdio wrapper. The site counts 453 capabilities across actors and levels, worlds and lighting, Blueprints and UI, materials, Niagara effects, gameplay systems, cinematics and audio, and play-and-verify steps such as Play In Editor with screenshots the model can see.

It supports Unreal Engine 5.0 to 5.8 on Windows, macOS and Linux, and is MIT licensed. The plugin is local and token-protected by default.

## Features

- **One search-first tool:** A single unreal tool offers search, describe and execute operations.
- **Level and actor editing:** Spawns, places and attaches actors and manages levels.
- **Blueprint and UI work:** Creates Blueprints, event graphs and UMG widgets.
- **Materials and effects:** Handles material graphs, textures and Niagara systems.
- **Cinematics and audio:** Controls Level Sequences, cameras, Sound Cues and MetaSounds.
- **Play and verify:** Runs Play In Editor, takes screenshots, reads logs and packages builds.

## Good for

- Block out a level from a text description
- Wire up Blueprint event graphs in batches
- Light a scene and render a cinematic
- Playtest and capture screenshots to verify changes

## Install

### Claude Code (Terminal)

```sh
claude mcp add unreal-engine-mcp --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' -- npx -y unreal-engine-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unreal-engine-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}
```

## Tools

- `unreal`: Single tool with search, describe and execute operations over 450+ editor capabilities.

## FAQ

### Which Unreal versions work?

Unreal Engine 5.0 to 5.8.

### Is it free?

Yes, the site says free and open source under MIT.

### Does it need a plugin?

Yes, a native C++ editor plugin does the work inside the editor.

### Is it secure by default?

The README says it is local and token-protected by default.

### Is Unreal Engine MCP free?

Yes. Unreal Engine MCP is open source, so you can use and self-host it for free.

### How do I add Unreal Engine MCP to Claude Code?

Run this command in your terminal: claude mcp add unreal-engine-mcp --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' -- npx -y unreal-engine-mcp-server

### What are the best alternatives to Unreal Engine MCP?

The closest alternatives to Unreal Engine MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/unreal-engine-mcp
