MCP bridge that connects AI coding assistants to the Unreal Engine 5 editor. Create materials, blueprints, spawn actors, manage data tables, profile performance, and 100+ more tools — all through natural language. Works with Claude Code, Cursor, VS Code, Gemini, Windsurf, JetBrains, Zed, and Amazon Q. Install with: pip install unrealmcp
Overview
UnrealMCP
MCP bridge for Unreal Engine 5 that lets AI assistants control the editor through 100+ tools.
Install
pip install unrealmcp
Then add to your AI tool's MCP config:
{
"mcpServers": {
"unreal": {
"command": "unrealmcp",
"args": [],
"env": {}
}
}
}
Features
- 100+ editor tools: materials, blueprints, actors, data tables, widgets, enhanced input, profiling
- 8 AI tools supported: Claude Code, Cursor, VS Code/Copilot, Gemini CLI, Windsurf, JetBrains/Rider, Zed, Amazon Q
- Zero config: just
"command": "unrealmcp"— no paths, no tokens, no Docker - Auto-discovers the running UE5 editor via port file
- Tested on UE 5.7, may work on earlier 5.x versions
How It Works
- A C++ plugin runs inside the UE5 editor as a TCP server
- The Python MCP server (
unrealmcp) translates AI tool calls into TCP commands - The editor executes commands and returns results
- No manual port configuration — the server auto-discovers the editor
Tool Categories
| Category | Examples |
|---|---|
| Assets | find, list, import, duplicate, rename, delete |
| Blueprints | create, compile, add components, variables, functions, graph nodes |
| Materials | create, build node graphs, apply to actors, create instances |
| Data Tables | schema, add/update/delete rows |
| Data Assets | create, read/write properties |
| Actors | spawn, transform, delete, get properties |
| Enhanced Input | actions, mapping contexts, triggers, modifiers |
| Widgets (UMG) | add, remove, move, get/set properties |
| Profiling | start/stop traces, diagnose bottlenecks, flame charts, frame analysis |
Links
Server Config
{
"mcpServers": {
"unreal": {
"command": "unrealmcp",
"args": [],
"env": {}
}
}
}