Skip to main content
Version: Reality 5.8

Unreal MCP

Reality Editor includes Unreal MCP which a Model Context Protocol (MCP) server inside the editor.

An AI agent on the same computer can connect to that server and work in the editor. For example, the agent can spawn actors, change lights, or create materials.

Setup​

Enabling Plugins​

Enable these plugins:

  • Unreal MCP
  • AI Assistant
  • AI Module Toolset
  • All Toolsets

To enable them:

  1. Click Edit > Plugins.
  2. Search for each plugin and enable it.
  3. Restart Reality Editor when you see the restart message.

Unreal MCP is the server. All Toolsets loads the tools the agent can call. Enabling Unreal MCP and All Toolsets also enables Toolset Registry.

Configure Auto Start​

  • Click Edit > Editor Preferences.
  • Under General, select Model Context Protocol.
  • Enable Auto Start Server.

The server starts each time Reality Editor opens. The address is http://127.0.0.1:8000/mcp.

The Output Log shows this address when the server starts.

If another program already uses port 8000, change Server Port Number on the same page. The default URL path is /mcp.

Generate a client config​

Your AI agent needs a config file before it can find the server. Reality Editor can write that file.

  • Open the editor console. Press the backtick key (`).
  • Enter a generate command.

For one agent, use its name. This example is for Cursor:

ModelContextProtocol.GenerateClientConfig Cursor

To write a config for every supported agent:

ModelContextProtocol.GenerateClientConfig All

Supported names are ClaudeCode, Cursor, VSCode, Gemini, Codex, and All.

The command writes .mcp.json in the project folder. A Claude Code file looks like this:

{
"mcpServers": {
"unreal-mcp": {
"type": "http",
"url": "http://127.0.0.1:8000/mcp"
}
}
}

You can run the command again. It updates the unreal-mcp entry and keeps other entries in the JSON file.

Codex uses .codex/config.toml. If that file already exists, the command does not change it. Edit the Codex file yourself.

Connect from your AI Agent​

  • Start Reality Editor and wait until Unreal MCP is running.
  • Start your AI agent from the project folder that contains .mcp.json.

If the agent does not find Unreal MCP, start it again from that folder, or reconnect MCP in the agent.

Editor Preferences: Model Context Protocol​

Open Edit > Editor Preferences > General > Model Context Protocol.

SettingDefaultDescription
Auto Start ServerOffStarts the MCP server when the editor opens.
Server Port Number8000Port on this computer (127.0.0.1).
Server URL Path/mcpPath at the end of the server address.
Enable Tool SearchOnThe agent looks up tools when it needs them.

For more details such as Console Commandsplease visit Epic Games page:

dev.epicgames.com
Unreal MCP in Unreal Editor | Unreal Engine 5.8 Documentation | Epic Developer Community

Overview of using MCP-compatible workflows to drive editor functionality in Unreal Engine.