Core Plugins (Required)

\n\n| Plugin | Required For |\n|--------|--------------|\n| **MCP Automation Bridge** | All automation operations |\n| **Python Editor Script Plugin** | Python-backed editor automation helpers |\n| **Editor Scripting Utilities** | Asset/Actor subsystem operations |\n| **Niagara** | Visual effects and particle systems |\n| **Gameplay Abilities** | `manage_gas` operations |\n| **Smart Objects** | AI smart object operations |\n\n

\n\n

Optional Plugins (Auto-enabled)

\n\n| Plugin | Required For |\n|--------|--------------|\n| **Level Sequence Editor** | `manage_sequence` operations |\n| **Control Rig** | `animation_physics` operations |\n| **GeometryScripting** | `manage_geometry` operations |\n| **Behavior Tree Editor** | `manage_ai` Behavior Tree operations |\n| **Niagara Editor** | Niagara authoring |\n| **Environment Query Editor** | AI/EQS operations |\n| **MetaSound** | `manage_audio` MetaSound authoring |\n| **StateTree** | `manage_ai` State Tree operations |\n| **Enhanced Input** | `manage_networking` input mapping operations |\n| **Chaos Cloth** | Cloth simulation |\n| **Interchange** | Asset import/export |\n| **Data Validation** | Data validation |\n| **PCG** | `manage_pcg` graph authoring and execution when enabled for the build |\n| **Procedural Mesh Component** | Procedural geometry |\n| **OnlineSubsystem** | Session/networking operations |\n| **OnlineSubsystemUtils** | Session/networking operations |\n\n

\n\n> 💡 Optional plugins are auto-enabled by the MCP Automation Bridge plugin when needed.\n> PCG support is compiled for source projects when the project explicitly enables PCG. Versioned release packages for UE 5.2+ include PCG support.\n\n### Step 4: Configure MCP Client\n\n#### Option A: Native MCP Transport (Direct HTTP — no bridge needed)\n\nThe plugin includes a built-in MCP Streamable HTTP server. AI clients connect directly to the plugin over HTTP — no TypeScript bridge, no Node.js, no npm.\n\n**Enable in Unreal:**\n1. **Edit > Project Settings > Plugins > MCP Automation Bridge**\n2. Check **Enable Native MCP**\n3. Set port (default: `3000`)\n4. Optionally set **Native MCP Instructions** for project-specific guidance\n5. Restart the editor\n\n**Configure your MCP client** to use Streamable HTTP transport at:\n```\nhttp://localhost:3000/mcp\n```\n\n**Claude Code:**\n```bash\nclaude mcp add unreal-engine --transport http http://localhost:3000/mcp\n```\n\nOr manually in `~/.claude/settings.json` or project `.mcp.json`:\n```json\n{\n \"mcpServers\": {\n \"unreal-engine\": {\n \"type\": \"url\",\n \"url\": \"http://localhost:3000/mcp\"\n }\n }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`):\n```json\n{\n \"mcpServers\": {\n \"unreal-engine\": {\n \"url\": \"http://localhost:3000/mcp\"\n }\n }\n}\n```\n\n**Verify it works:**\n- **Status bar** — look for `● MCP :3000 (2)` in the bottom-right of the editor. Green dot = server running, number in parens = active sessions. Click it to open settings.\n- **Output Log** — filter by `LogMcpNativeTransport` to see connections, tool calls, and session activity:\n ```\n LogMcpNativeTransport: Native MCP server started on http://localhost:3000/mcp\n LogMcpNativeTransport: MCP session initialized: ... (client: claude-code 2.1.92, active sessions: 1)\n LogMcpNativeTransport: tools/call: inspect (RequestId=...)\n LogMcpNativeTransport: tools/call completed: ... (tool=inspect, success=true)\n ```\n\nFeatures:\n- SSE streaming for real-time progress during long operations\n- Multiple concurrent sessions (Cursor + Claude Code + others simultaneously)\n- Dynamic tool management — core tools load by default, enable more via `manage_tools`\n- Python execution via `execute_python` action (inline code or .py files)\n- Capability token authentication — enable in project settings for network security\n\n#### Option B: TypeScript Bridge (stdio — classic setup)\n\nAdd to your Claude Desktop / Cursor config file:\n\n**Using Clone/Build:**\n```json\n{\n \"mcpServers\": {\n \"unreal-engine\": {\n \"command\": \"node\",\n \"args\": [\"path/to/Unreal_mcp/dist/cli.js\"],\n \"env\": {\n \"UE_PROJECT_PATH\": \"C:/Path/To/YourProject\",\n \"MCP_AUTOMATION_PORT\": \"8091\"\n }\n }\n }\n}\n```\n\n**Using NPX:**\n```json\n{\n \"mcpServers\": {\n \"unreal-engine\": {\n \"command\": \"npx\",\n \"args\": [\"unreal-engine-mcp-server\"],\n \"env\": {\n \"UE_PROJECT_PATH\": \"C:/Path/To/YourProject\"\n }\n }\n }\n}\n```\n\n---\n\n## Configuration\n\n### Environment Variables\n\n```env\n# Required\nUE_PROJECT_PATH=\"C:/Path/To/YourProject\"\n\n# Automation Bridge\nMCP_AUTOMATION_HOST=127.0.0.1\nMCP_AUTOMATION_PORT=8091\n\n# LAN Access (optional)\n# SECURITY: Set to true to allow binding to non-loopback addresses (e.g., 0.0.0.0)\n# Only enable if you understand the security implications.\nMCP_AUTOMATION_ALLOW_NON_LOOPBACK=false\n\n# Logging\nLOG_LEVEL=info # debug | info | warn | error\n\n# Optional\nMCP_CONNECTION_TIMEOUT_MS=5000\nMCP_REQUEST_TIMEOUT_MS=120000\nASSET_LIST_TTL_MS=10000\n\n# Optional Prometheus metrics endpoint\n# Loopback-only by default. Non-loopback metrics requires both explicit opt-in and a token.\n# MCP_METRICS_PORT=9100\n# MCP_METRICS_HOST=127.0.0.1\n# MCP_METRICS_ALLOW_NON_LOOPBACK=false\n# MCP_METRICS_TOKEN=change-me\n\n# Custom content mount points (comma-separated)\n# Plugins with CanContainContent register mount points beyond /Game/.\n# MCP_ADDITIONAL_PATH_PREFIXES=/ProjectObject/,/ProjectAnimation/\n```\n\n### LAN Access Configuration\n\nBy default, the automation bridge only binds to loopback addresses (127.0.0.1) for security. To enable access from other machines on your network:\n\n**TypeScript (MCP Server):**\n```env\nMCP_AUTOMATION_ALLOW_NON_LOOPBACK=true\nMCP_AUTOMATION_HOST=0.0.0.0\n```\n\n**Unreal Engine Plugin:**\n1. Go to **Edit → Project Settings → Plugins → MCP Automation Bridge**\n2. Under **Security**, enable **\"Allow Non Loopback\"**\n3. Under **Connection**, set **\"Listen Host\"** to `0.0.0.0`\n4. Restart the editor\n\n⚠️ **Security Warning:** Enabling LAN access exposes the automation bridge to your local network. Only use on trusted networks with appropriate firewall rules. **Enable capability token authentication** (`Require Capability Token` in project settings) to prevent unauthorized access when using LAN mode.\n\n---\n\n## Available Tools\n\n**23 exposed MCP tools** in broad all-tools mode. Related actions live directly on their parent tools so clients load less context without losing capabilities.\n\n

Core Tools

\n\n| Tool | Description |\n|------|-------------|\n| `manage_asset` | Assets, Materials, Render Targets, Behavior Trees |\n| `manage_blueprint` | Blueprints, SCS components, graph editing, UMG widgets, layout, bindings, animations |\n| `control_actor` | Spawn, delete, transform, physics, tags |\n| `control_editor` | PIE, Camera, viewport, screenshots |\n| `manage_level` | Load/save, streaming, lighting |\n| `system_control` | UBT, Tests, Logs, Project Settings, CVars, Python Execution |\n| `inspect` | Object Introspection |\n| `manage_tools` | Dynamic tool management (enable/disable at runtime) |\n\n

\n\n

World Building

\n\n| Tool | Description |\n|------|-------------|\n| `build_environment` | Landscapes, foliage, procedural terrain, lighting, spline roads/rivers/fences |\n| `manage_level_structure` | Levels, sublevels, World Partition, streaming, data layers, HLOD, volumes |\n| `manage_geometry` | Procedural mesh creation and editing with Geometry Script |\n| `manage_pcg` | PCG graph assets, subgraphs, input/sampler/filter/spawner nodes, pin connections, execution, partition grid size, and node settings |\n\n

\n\n

Gameplay Systems

\n\n| Tool | Description |\n|------|-------------|\n| `animation_physics` | Animation BPs, skeletons, sockets, physics assets, cloth, vehicles, ragdolls, Control Rig, IK |\n| `manage_effect` | Niagara, particles, debug shapes, GPU simulations |\n| `manage_gas` | Gameplay Ability System: abilities, effects, attributes |\n| `manage_character` | Character creation, movement, advanced locomotion |\n| `manage_combat` | Weapons, projectiles, damage, melee combat |\n| `manage_ai` | AI controllers, Behavior Trees, EQS, perception, State Trees, Smart Objects, NavMesh/pathfinding |\n| `manage_inventory` | Items, equipment, loot tables, crafting |\n| `manage_interaction` | Interactables, destructibles, triggers |\n\n

\n\n

Utility

\n\n| Tool | Description |\n|------|-------------|\n| `manage_audio` | Audio Assets, Components, Sound Cues, MetaSounds, Attenuation |\n| `manage_sequence` | Sequencer, cinematics, bindings, tracks, playback, keyframes |\n| `manage_networking` | Replication, RPCs, network prediction, sessions, split-screen, LAN/voice, game framework, input mappings |\n\n

\n### Supported Asset Types\n\nBlueprints • Materials • Textures • Static Meshes • Skeletal Meshes • Levels • Sounds • Particles • Niagara Systems • Behavior Trees\n\n---\n\n## Docker\n\n```bash\ndocker build -t unreal-mcp .\ndocker run -it --rm -e UE_PROJECT_PATH=/project unreal-mcp\n```\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Handler Mappings](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/handler-mapping.md) | TypeScript to C++ routing |\n| [Plugin Extension](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/editor-plugin-extension.md) | C++ plugin architecture |\n| [Testing Guide](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/testing-guide.md) | How to run and write tests |\n| [Roadmap](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/Roadmap.md) | Development roadmap |\n\n\n---\n\n## Development\n\n```bash\nnpm run build # Build TypeScript\nnpm run lint # Run ESLint\nnpm run test:unit # Run unit tests\nnpm run test:all # Run all tests\n```\n\n---\n\n## Community\n\n| Resource | Description |\n|----------|-------------|\n| [Project Roadmap](https://github.com/users/ChiR24/projects/3) | Track roadmap progress and priorities |\n| [Discussions](https://github.com/ChiR24/Unreal_mcp/discussions) | Ask questions, share ideas, get help |\n| [Issues](https://github.com/ChiR24/Unreal_mcp/issues) | Report bugs and request features |\n\n---\n\n## Contributing\n\nContributions welcome! Please:\n- Include reproduction steps for bugs\n- Keep PRs focused and small\n- Follow existing code style\n\n---\n\n## License\n\nMIT — See [LICENSE](https://github.com/ChiR24/Unreal_mcp/blob/dev/LICENSE)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Integrations","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[104,105,106,107],"license","MIT","language","C++","registryName","ai.smithery/ChiR24-unreal_mcp","homepage","mcp","mcp-server","unreal-engine","unreal-engine-5","ENV",{"_110":111,"_112":113,"_114":115},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Unreal mcp