Ue MCP

UE-MCP

Let an AI agent work inside your Unreal Editor. Ask in plain English, and it builds levels, Blueprints, materials, VFX, landscapes and more in your open project.

<img width="1354" height="586" alt="ue-mcp contains Epic's MCP and its 2,190 actions. Around it, ue-mcp adds 1,524 actions of its own, and dialog handling, retries and rollback, guardrails, spatial control, workflow automation, plugins, multi-editor control and auto-reported tool gaps. Supports UE 5.4 to 5.9." src="docs/assets/ue-mcp-overview.png" />

UE-MCP is a free, open-source Model Context Protocol server for Unreal Engine 5. It connects AI assistants like Claude, Cursor and Codex to the editor through <!-- count:actions -->3714+<!-- /count --> actions, including every one of Epic's native Unreal tools (UE 5.8 and later).

"Place a point light 300 units above the player start, warm white, intensity 5000."
"Create a pulsing emissive material and apply it to every cube in the level."
"Build the project in Development and tell me about any compile errors."

Two ways to use it

1. UE-MCP Studio: a chat agent in the editor

https://github.com/user-attachments/assets/24d4fc16-e6b4-4dc7-98ea-eaf4798923b1

Studio is a free desktop client with the agent built in. Dock it in the editor or run it in its own window. Sign in with your Claude or ChatGPT account, or use an API key. Every turn is checkpointed so you can review and revert changes, and shell commands and file edits wait for your approval.

Install it with the UE-MCP app, or run npx ue-mcp install studio in your project folder, then open Studio from the toolbar. See Install. Windows, UE 5.7, 5.8 and 5.9.

2. Bring your own AI client

Already using Claude Code, Claude Desktop, Cursor or Codex? From your project folder:

npx ue-mcp init

The wizard installs the bridge plugin into your project and configures your AI client. Open the editor (the bridge compiles on first launch), then ask your AI to run project(action="get_status") to confirm it is connected.

Full walkthrough: Getting Started.

What can it do?

Almost anything you do by hand in the editor: levels and actors, Blueprints, materials, assets and imports, animation and Control Rig, Niagara, landscape, foliage, PCG, audio, UMG, gameplay systems, GAS, StateTree, networking, Sequencer, builds and PIE.

Beyond single actions, it can chain steps into reusable flows with rollback, handle editor dialogs, drive several editors at once, and be extended with ue-mcp plugins.

To see it build a full scene from nothing, run the built-in Neon Shrine demo.

FAQ

What is "MCP"?

Model Context Protocol is an open standard that lets AI assistants call external tools. UE-MCP is the tool server that gives them the Unreal Editor.

Does it cost anything?

No. UE-MCP and Studio are MIT-licensed and free for personal and commercial use. You pay only for your AI model, through your existing plan or API key.

Which Unreal versions and platforms?

UE <!-- count:engineRange -->5.4 to 5.9<!-- /count --> on Windows, 5.6+ on macOS and Linux. Studio is Windows-only for now, on UE 5.7, 5.8 and 5.9. You also need Node.js 20+. With a C++ toolchain the bridge plugin compiles in your project; without one, init installs prebuilt bridge binaries for your engine and platform when the release has them. See Getting Started.

Is it safe to let an AI edit my project?

Write guards can block or require confirmation for changes, source-controlled assets can be protected, and flows roll back on failure. Studio adds per-turn checkpoints and approval prompts. Use source control regardless.

Does it work without the editor open?

Partly. Config, C++ headers and asset listings can be read with the editor closed. Anything that changes the project needs the editor running.

How is this different from Epic's built-in AI tools?

UE-MCP wraps all <!-- count:nativeToolActions -->2190<!-- /count --> of Epic's native Unreal tools and adds <!-- count:ownActions -->1524+<!-- /count --> actions of its own, plus flows, guards and plugins. See the comparison against Epic and other Unreal MCP servers.

It won't connect / something isn't working.

Run npx ue-mcp doctor, check out the Troubleshooting Guide, or come give me a shout in the official ue-mcp discord!!!

Learn more

• Documentation and Tool Reference
• Studio source
• Discord
• Custom tooling, air-gapped installs or managed relay: hello@ue-mcp.com

Contributing

Issues and pull requests are welcome. Start with Development. Install git-lfs before cloning, because the test project stores assets through LFS.

If UE-MCP helps your work, sponsorship is appreciated.

License

MIT. Contributions are accepted under the same license.