What Is MCP and Why Should You Care?
The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and data sources. Think of it as a universal adapter between AI models (like Claude) and your development environment.
For Unreal Engine developers, MCP means you can talk to your AI assistant and have it directly manipulate the UE5 editor — creating actors, modifying materials, building Blueprints, adjusting Sequencer timelines, and hundreds of other operations. No copy-pasting code. No manual translation. The AI becomes a co-pilot with hands on the controls.
Since Anthropic donated MCP to the Linux Foundation, the protocol has become an industry standard with thousands of server implementations across every domain. Game development MCP servers are among the fastest-growing categories.
Prerequisites
Before setting up your MCP server, ensure you have:
- Unreal Engine 5.4+ installed
- An MCP-compatible AI client: Claude Desktop, Cursor, Windsurf, VS Code with Continue, or any other MCP client
- StraySpark Unreal MCP Server plugin installed in your UE5 project (or another MCP server implementation)
- Node.js 18+ (for the MCP transport layer)
Installation: StraySpark Unreal MCP Server
The StraySpark Unreal MCP Server provides 305 tools across 42+ categories. Here's how to set it up:
Step 1: Install the Plugin
- Download the plugin from your StraySpark account
- Copy the plugin folder to your project's
Plugins/directory - Restart Unreal Engine
- Enable the plugin in Edit → Plugins → search "MCP Server"
- Restart the editor when prompted
Step 2: Configure the MCP Transport
The plugin runs a local server that bridges your AI client to the UE5 editor. By default, it listens on stdio transport (recommended for most setups).
In your project's Config/DefaultMCPServer.ini:
[/Script/UnrealMCPServer.MCPServerSettings]
bAutoStartServer=True
ServerPort=3000
TransportType=StdIO
LogLevel=Warning
Step 3: Connect Your AI Client
Claude Desktop
Add to your Claude Desktop MCP configuration (claude_desktop_config.json):
{
"mcpServers": {
"unreal": {
"command": "path/to/your/project/Plugins/UnrealMCPServer/Server/start.sh",
"args": ["--project", "path/to/your/project"]
}
}
}
Cursor
In Cursor settings, add the MCP server under the MCP section with the same command and arguments.
VS Code with Continue
Add the server configuration to your .continue/config.json:
{
"mcpServers": [
{
"name": "unreal",
"command": "path/to/your/project/Plugins/UnrealMCPServer/Server/start.sh",
"args": ["--project", "path/to/your/project"]
}
]
}
Step 4: Verify the Connection
With UE5 running and your AI client connected:
- Ask your AI: "List the actors in my current level"
- The AI should query the MCP server and return a list of actors from your open level
- If it works, your connection is live
Understanding Tool Presets
The StraySpark Unreal MCP Server includes 305 tools — but you rarely need all of them active. Tool presets let you expose only the tools relevant to your current workflow:
| Preset | Tools | Best For |
|---|---|---|
| Full | All 305 | Complete access to everything |
| Scene Building | ~80 | Level design, prop placement, lighting |
| Gameplay | ~60 | Blueprints, gameplay logic, AI, physics |
| Minimal | ~30 | Basic queries and simple edits |
| Custom | You choose | Project-specific tool selection |
Start with a focused preset. Fewer tools means faster AI responses (less context to process) and more relevant suggestions.
Practical Workflows
Workflow 1: AI-Assisted Level Design
Tell your AI assistant what you want in natural language:
"Create a medieval village square. Place a stone fountain in the center, surround it with 8 market stall actors evenly spaced in a circle at radius 1500 units. Add point lights above each stall with warm color temperature and 500 unit attenuation radius."
The AI translates this into MCP tool calls that execute directly in the editor. You see actors appearing in your viewport in real-time.
Workflow 2: Material Creation
"Create a PBR material for weathered wood. Use a base color of warm brown, roughness around 0.7, add subtle normal map detail for wood grain texture. Apply it to all actors tagged 'wooden_fence' in the level."
The MCP server creates the material, sets up parameter nodes, and applies it to the specified actors — all without you opening the Material Editor.
Workflow 3: Blueprint Automation
"In the BP_Door Blueprint, add a timeline that opens the door 90 degrees over 0.5 seconds when the player overlaps the trigger box. Add a sound cue play at the start of the animation."
Blueprint operations through MCP can handle variable creation, node placement, connections, and compilation.
Workflow 4: Sequencer Cinematics
"Create a Level Sequence with a camera that does a slow 180-degree orbit around the fountain actor at height 300 units over 10 seconds. Add a fade-in from black in the first 2 seconds."
The AI creates the sequence, adds camera tracks, keyframes the orbit, and sets up the fade — all through MCP tool calls.
Context Resources
Beyond tools, MCP servers provide context resources — read-only data that helps the AI understand your project. The StraySpark server includes 15 context resources:
- Project structure: File hierarchy, asset types, content organization
- Level state: Current actors, their properties, spatial relationships
- Blueprint metadata: Class hierarchies, variable types, function signatures
- Material library: Available materials, textures, parameter ranges
- Plugin configuration: Active features, presets, custom settings
These resources let the AI make informed decisions without you having to explain your project setup every time.
Workflow Prompts
The server includes 12 pre-built workflow prompts for common tasks:
- Scene Setup: Initialize a new level with standard lighting and post-processing
- Prop Scatter: Distribute props across a surface with natural variation
- Lighting Pass: Set up three-point lighting for a focal area
- Material Batch: Create and apply materials to multiple actors
- Blueprint Template: Generate common gameplay Blueprints from descriptions
- Camera Rig: Set up cinematic camera configurations
- Landscape Setup: Initialize landscape with layers and auto-material
- Audio Pass: Place ambient audio sources and attenuation volumes
- Physics Setup: Configure collision and physics properties on actors
- UI Layout: Create basic UMG widget layouts
- Optimization Audit: Analyze scene for common performance issues
- Export Prep: Prepare assets and levels for build or migration
Undo Support
Every operation performed through the MCP server is registered with UE5's undo system. If the AI makes a change you don't like:
- Press Ctrl+Z in the editor to undo the last operation
- Or tell the AI: "Undo the last 3 operations"
- The full undo history is preserved, just like manual edits
This makes AI-assisted editing non-destructive and safe to experiment with.
Performance Tips
Token Optimization
Large tool sets consume AI context tokens. To keep responses fast and costs low:
- Use the Minimal preset for simple queries
- Switch to Scene Building or Gameplay presets for focused work sessions
- Create Custom presets that include only the tools you use regularly
- Batch related operations in single prompts instead of one-at-a-time
Editor Responsiveness
MCP operations execute on the editor's game thread. For large batch operations:
- Break operations into chunks (e.g., "place 50 trees" instead of "place 5000 trees")
- Give the editor time to process between large batches
- Close unnecessary editor windows to free up resources during AI operations
- Save your level before large AI-driven modifications
Troubleshooting
"Connection refused" Error
The MCP server isn't running. Check:
- Is the plugin enabled in UE5?
- Is
bAutoStartServer=Truein your config? - Is the correct port available (no other process using it)?
AI Doesn't See Updated Level State
Context resources cache for performance. Force a refresh:
- Tell the AI to "refresh the scene context"
- Or restart the MCP connection in your AI client
Operations Fail Silently
Check the Output Log in UE5 (Window → Developer Tools → Output Log). Filter for "MCP" to see server-side error messages.
Slow Response Times
- Reduce the active tool count with presets
- Ensure your project isn't running a PIE (Play In Editor) session during MCP operations
- Check network latency if using a remote AI client
What's Next
MCP-powered development is still in its early days, but it's already transforming how teams work with Unreal Engine. As AI models become more capable and MCP tooling matures, expect workflows to become increasingly natural and powerful.
For deeper dives into specific MCP workflows, check out our guides on 5 Real AI Workflows That Speed Up UE5 Development and The MCP Ecosystem for Game Developers.
The future of game development is collaborative — you and AI, working together in the editor.