Unreal Engine 5 MCP

v1.0.0APIsstable

AI bridge for Unreal Engine 5. Control the editor from Claude Code, Cursor, Windsurf, and any MCP client. 238 commands across materials, blueprints, Niagara VFX, StateTree, data tables, Mass Entity, Enhanced Input, UMG widgets, and performance profil

ai-agentai-toolsblueprintsclaudeclaude-code
Share:
28
Stars
0
Downloads
0
Weekly
0/5

What is Unreal Engine 5 MCP?

Unreal Engine 5 MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ai bridge for unreal engine 5. control the editor from claude code, cursor, windsurf, and any mcp client. 238 commands across materials, blueprints, niagara vfx, statetree, data tables, mass entity, e...

AI bridge for Unreal Engine 5. Control the editor from Claude Code, Cursor, Windsurf, and any MCP client. 238 commands across materials, blueprints, Niagara VFX, StateTree, data tables, Mass Entity, Enhanced Input, UMG widgets, and performance profil

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • AI bridge for Unreal Engine 5. Control the editor from Claud

Use Cases

Control Unreal Editor
Blueprint automation
VFX and animation
aadeshrao123

Maintainer

LicenseMPL-2.0
Languagec++
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx unreal-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Unreal Engine 5 MCP

Unreal MCP is an AI bridge for Unreal Engine 5 that exposes over 280 editor commands across 13 categories — including materials, Blueprints, Niagara VFX, StateTree, data tables, Mass Entity, Enhanced Input, UMG widgets, and performance profiling — to any MCP-compatible AI client. It consists of a C++ Unreal plugin that runs a TCP server inside the editor and a Python MCP server that translates MCP tool calls into engine commands. Teams using Claude Code, Cursor, or Windsurf can describe game logic, VFX systems, or UI layouts in natural language and have them built directly in the Unreal Editor.

Prerequisites

  • Unreal Engine 5.7 or later (earlier 5.x builds may work but are not officially supported)
  • Python 3.10 or later
  • npm (for the unrealcli package) or pip (for the unrealmcp MCP server package)
  • Required UE5 plugins enabled: PythonScriptPlugin, EditorScriptingUtilities, EnhancedInput
  • An MCP client such as Claude Code, Cursor, Windsurf, or VS Code
1

Install the UnrealMCP plugin into your project

Clone the Unreal-MCP repository into your project's Plugins directory, then run the platform-specific install script to compile the plugin.

git clone https://github.com/aadeshrao123/Unreal-MCP.git Plugins/UnrealMCP
# macOS/Linux:
bash Plugins/UnrealMCP/install.sh
# Windows:
cmd /c Plugins\UnrealMCP\install.bat
2

Enable required plugins in Unreal Editor

Open your UE5 project, go to Edit > Plugins, and ensure PythonScriptPlugin, EditorScriptingUtilities, and EnhancedInput are all enabled. Restart the editor after enabling them.

3

Install the Python MCP server package

Install the unrealmcp Python package, which acts as the MCP server that bridges AI clients to the Unreal plugin's TCP server.

pip install unrealmcp
4

Install the CLI tool for direct command access

Install unrealcli globally via npm to get the ue-cli command, useful for scripting and verifying the connection to the running Unreal Editor.

npm install -g unrealcli
5

Verify the connection to Unreal Editor

With the Unreal Editor open and the plugin active, run a health check to confirm the MCP server can reach the editor's TCP socket.

ue-cli health_check
6

Configure your MCP client

Add the unrealmcp server to your MCP client config. For Claude Code add it to .mcp.json, for Cursor add it to .cursor/mcp.json. The server connects to the Unreal Editor on port 55557 by default.

Unreal Engine 5 MCP Examples

Client configuration

MCP configuration for Cursor (.cursor/mcp.json) using the unrealmcp Python package.

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "python",
      "args": ["-m", "unrealmcp"],
      "env": {
        "UNREAL_MCP_PORT": "55557"
      }
    }
  }
}

Prompts to try

Example prompts for controlling Unreal Engine 5 through the MCP server.

- "Create a new material called M_RedRock and set it to a dark red metallic look"
- "Spawn a StaticMeshActor called Boulder at location (200, 0, 50)"
- "Create a Blueprint class called BP_Enemy that inherits from Character"
- "Add a new row to the DT_Items data table with name CopperOre and StackSize 100"
- "Start a performance trace capturing CPU and GPU channels, then analyze the results"

Troubleshooting Unreal Engine 5 MCP

health_check fails with connection refused

The Unreal Editor must be open and the UnrealMCP plugin must be enabled and loaded. Check that the plugin compiled successfully by looking in the Unreal Output Log for 'UnrealMCP: TCP server started'. The default port is 55557 — override it with UNREAL_MCP_PORT if there is a conflict.

Plugin fails to compile

Ensure PythonScriptPlugin and EditorScriptingUtilities are enabled in the Unreal Editor plugins panel. Rerun install.sh or install.bat after enabling them. Check that your UE5 version is 5.7 or later.

Commands time out on large operations

Niagara VFX graph operations and large Blueprint compilations can take longer than the default 30-second timeout. Pass --timeout 300 to ue-cli commands, or set a longer timeout in your MCP client configuration.

Frequently Asked Questions about Unreal Engine 5 MCP

What is Unreal Engine 5 MCP?

Unreal Engine 5 MCP is a Model Context Protocol (MCP) server that ai bridge for unreal engine 5. control the editor from claude code, cursor, windsurf, and any mcp client. 238 commands across materials, blueprints, niagara vfx, statetree, data tables, mass entity, enhanced input, umg widgets, and performance profil It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Unreal Engine 5 MCP?

Follow the installation instructions on the Unreal Engine 5 MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Unreal Engine 5 MCP?

Unreal Engine 5 MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Unreal Engine 5 MCP free to use?

Yes, Unreal Engine 5 MCP is open source and available under the MPL-2.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "unreal-mcp": { "command": "npx", "args": ["-y", "unreal-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Unreal Engine 5 MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides