Spring Sale: 30% off bundles with SPRINGBUNDLE or 15% off individual products with SPRING15 — ends Apr 15

StraySparkStraySpark
ProductsFree AssetsDocsBlogGamesAbout
StraySparkStraySpark

Game Studio & UE5 Tool Developers. Building professional-grade tools for the Unreal Engine community.

Products

  • Complete Toolkit (Bundle)
  • Procedural Placement Tool
  • Cinematic Spline Tool
  • Blueprint Template Library
  • DetailForge
  • UltraWire
  • Unreal MCP Server
  • Blender MCP Server
  • Godot MCP Server

Resources

  • Free Assets
  • Documentation
  • Blog
  • Changelog
  • Roadmap
  • FAQ
  • Contact

Legal

  • Privacy Policy
  • Terms of Service

© 2026 StraySpark. All rights reserved.

Back to Blog
tutorial
StraySparkApril 5, 20265 min read
How to Set Up an MCP Server for Unreal Engine 5: AI-Powered Editor Automation 
Unreal EngineMcpAiAi Game DevelopmentAutomationClaude

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

  1. Download the plugin from your StraySpark account
  2. Copy the plugin folder to your project's Plugins/ directory
  3. Restart Unreal Engine
  4. Enable the plugin in Edit → Plugins → search "MCP Server"
  5. 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:

  1. Ask your AI: "List the actors in my current level"
  2. The AI should query the MCP server and return a list of actors from your open level
  3. 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:

PresetToolsBest For
FullAll 305Complete access to everything
Scene Building~80Level design, prop placement, lighting
Gameplay~60Blueprints, gameplay logic, AI, physics
Minimal~30Basic queries and simple edits
CustomYou chooseProject-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:

  1. Scene Setup: Initialize a new level with standard lighting and post-processing
  2. Prop Scatter: Distribute props across a surface with natural variation
  3. Lighting Pass: Set up three-point lighting for a focal area
  4. Material Batch: Create and apply materials to multiple actors
  5. Blueprint Template: Generate common gameplay Blueprints from descriptions
  6. Camera Rig: Set up cinematic camera configurations
  7. Landscape Setup: Initialize landscape with layers and auto-material
  8. Audio Pass: Place ambient audio sources and attenuation volumes
  9. Physics Setup: Configure collision and physics properties on actors
  10. UI Layout: Create basic UMG widget layouts
  11. Optimization Audit: Analyze scene for common performance issues
  12. 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:

  1. Is the plugin enabled in UE5?
  2. Is bAutoStartServer=True in your config?
  3. 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:

  1. Tell the AI to "refresh the scene context"
  2. 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.

Tags

Unreal EngineMcpAiAi Game DevelopmentAutomationClaude

Continue Reading

tutorial

Getting Started with UE5 PCG Framework: Build Your First Procedural World

Read more
tutorial

Nanite Foliage in UE5: The Complete Guide to High-Performance Vegetation

Read more
tutorial

UE5 Lumen Optimization Guide: Achieving 60fps with Dynamic Global Illumination

Read more
All posts