Unreal Engine
Connects to Unreal Engine projects to execute Python scripts, query assets, and run console commands directly from AI assistants. Uses Unreal's built-in Python remote execution without requiring custom plugins.
Integrates with Unreal Engine to assist with game development workflows.
What it does
- Execute Python scripts in Unreal Editor
- List and query project assets
- Export assets to text format
- Get asset information and references
- Run console commands in Unreal
- Configure engine and project paths
Best for
About Unreal Engine
Unreal Engine is a community-built MCP server published by runreal that provides AI assistants with tools and capabilities via the Model Context Protocol. Integrate Unreal Engine with your workflow. Streamline game development using Unreal Engine 5 and UE Engine tools for ma It is categorized under developer tools. This server exposes 20 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install Unreal Engine in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
Unreal Engine is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (20)
Set the Unreal Engine path
Set the Project path
Get the current Unreal Engine path
Get the current Unreal Project path
Execute any python within the Unreal Editor. All python must have `import unreal` at the top. CHECK THE UNREAL PYTHON DOCUMENTATION BEFORE USING THIS TOOL. NEVER EVER ADD COMMENTS
unreal-mcp
MCP server for Unreal Engine that uses Unreal Python Remote Execution
⚡ Differences
This server does not require installing a new UE plugin as it uses the built-in Python remote execution protocol.
Adding new tools/features is much faster to develop since it does not require any C++ code.
It can support the full Unreal Engine Python API
⚠️ Note
- This is not an official Unreal Engine project.
- Your AI agents or tools will have full access to your Editor.
- Review any changes your Client suggests before you approve them.
📦 Installation
📋 Requirements
- 🔧 Unreal Engine 5.4+ (verified, may work with earlier versions)
- 🟢 Node.js with npx
- 🤖 MCP Client (Claude, Cursor, etc.)
- Setting up your Editor:
- Open your Unreal Engine project
- Go to
Edit->Plugins - Search for "Python Editor Script Plugin" and enable it
- Restart the editor if prompted
- Go to
Edit->Project Settings - Search for "Python" and enable the "Enable Remote Execution" option
- Set up your Client:
- Edit your Claude (or Cursor) config
{
"mcpServers": {
"unreal": {
"command": "npx",
"args": [
"-y",
"@runreal/unreal-mcp"
]
}
}
}
🔧 Troubleshooting
If you get an error similar to MCP Unreal: Unexpected token 'C', Connection... it means that the mcp-server was not able to connect to the Unreal Editor.
- Make sure that the Python Editor Script Plugin is enabled and that the Remote Execution option is checked in your project settings.
- Try also changing your bind address from
127.0.0.1to0.0.0.0but note that this will allow connections from your local network. - Restart your Unreal Editor fully.
- Fully close/open your client (Claude, Cursor, etc.) to ensure it reconnects to the MCP server. (
File -> Exiton windows). - Check your running processes and kill any zombie unreal-mcp Node.js processes.
🛠️ Available Tools
| Tool | Description |
|---|---|
set_unreal_engine_path | Set the Unreal Engine path |
set_unreal_project_path | Set the Project path |
get_unreal_engine_path | Get the current Unreal Engine path |
get_unreal_project_path | Get the current Unreal Project path |
editor_run_python | Execute any python within the Unreal Editor |
editor_list_assets | List all Unreal assets |
editor_export_asset | Export an Unreal asset to text |
editor_get_asset_info | Get information about an asset, including LOD levels for StaticMesh and SkeletalMesh assets |
editor_get_asset_references | Get references for an asset |
editor_console_command | Run a console command in Unreal |
editor_project_info | Get detailed information about the current project |
editor_get_map_info | Get detailed information about the current map/level |
editor_search_assets | Search for assets by name or path with optional class filter |
editor_get_world_outliner | Get all actors in the current world with their properties |
editor_validate_assets | Validate assets in the project to check for errors |
editor_create_object | Create a new object/actor in the world |
editor_update_object | Update an existing object/actor in the world |
editor_delete_object | Delete an object/actor from the world |
editor_take_screenshot | Take a screenshot of the Unreal Editor |
editor_move_camera | Move the viewport camera to a specific location and rotation for positioning screenshots |
🤝 Contributing
Please feel free to open issues or pull requests. Contributions are welcome, especially new tools/commands.
License MIT
Alternatives
Related Skills
Browse all skillsThis skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
Comprehensive security engineering skill for application security, penetration testing, security architecture, and compliance auditing. Includes security assessment tools, threat modeling, crypto implementation, and security automation. Use when designing security architecture, conducting penetration tests, implementing cryptography, or performing security audits.
Guide for reverse engineering tools and techniques used in game security research. Use this skill when working with debuggers, disassemblers, memory analysis tools, binary analysis, or decompilers for game security research.
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Includes tech debt analyzer, team scaling calculator, engineering metrics frameworks, technology evaluation tools, and ADR templates. Use when assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics, or when user mentions CTO, tech debt, technical debt, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, or technology strategy.
UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.
Expert guide for Unreal Engine 5.x C++ development, covering UObject hygiene, performance patterns, and best practices.