Skip to content
MCP server

Unreal Engine MCP

Drive a running Unreal Editor from an AI client through a single searchable tool

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
0.6.1-beta-b
Listing updated
3 days ago

About Unreal Engine MCP

Unreal Engine MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Rather than loading hundreds of tool schemas up front, EngineWire exposes one MCP tool named unreal with three operations. The model searches in plain words, asks for the exact contract of the capability it found, and then executes it with checked parameters, receiving a receipt of what changed. An unknown name is refused.

The work runs inside the editor through a native C++ plugin, which serves MCP itself over HTTP on localhost, or via a Node.js stdio wrapper. The site counts 453 capabilities across actors and levels, worlds and lighting, Blueprints and UI, materials, Niagara effects, gameplay systems, cinematics and audio, and play-and-verify steps such as Play In Editor with screenshots the model can see.

It supports Unreal Engine 5.0 to 5.8 on Windows, macOS and Linux, and is MIT licensed. The plugin is local and token-protected by default.

Install

Run in a terminal

claude mcp add unreal-engine-mcp --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' -- npx -y unreal-engine-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "unreal-engine-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "unreal-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>"
      }
    }
  }
}

Configuration

  • UE_PROJECT_PATHYour Unreal project folder or its .uproject file. The server reads the capability token from <project>/Saved/MCP/capability-token.Required
  • MCP_AUTOMATION_CAPABILITY_TOKENCapability token to present to the editor. Only needed when the server cannot read the project folder.
  • UNREAL_MCP_URLThe editor's native MCP endpoint (Project Settings > EngineWire > Native MCP Port).
  • LOG_LEVELLog level. Logs go to stderr.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

unreal
Single tool with search, describe and execute operations over 450+ editor capabilities.

What it does

One search-first tool
A single unreal tool offers search, describe and execute operations.
Level and actor editing
Spawns, places and attaches actors and manages levels.
Blueprint and UI work
Creates Blueprints, event graphs and UMG widgets.
Materials and effects
Handles material graphs, textures and Niagara systems.
Cinematics and audio
Controls Level Sequences, cameras, Sound Cues and MetaSounds.
Play and verify
Runs Play In Editor, takes screenshots, reads logs and packages builds.

Good for

  • Block out a level from a text description
  • Wire up Blueprint event graphs in batches
  • Light a scene and render a cinematic
  • Playtest and capture screenshots to verify changes

Pricing

Open source

MIT licensed, free

Prices change. Check enginewire.dev before you buy.

Unreal Engine MCP FAQ

Which Unreal versions work?

Unreal Engine 5.0 to 5.8.

Is it free?

Yes, the site says free and open source under MIT.

Does it need a plugin?

Yes, a native C++ editor plugin does the work inside the editor.

Is it secure by default?

The README says it is local and token-protected by default.

Is Unreal Engine MCP free?

Yes. Unreal Engine MCP is open source, so you can use and self-host it for free.

How do I add Unreal Engine MCP to Claude Code?

Run this command in your terminal: claude mcp add unreal-engine-mcp --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' -- npx -y unreal-engine-mcp-server

What are the best alternatives to Unreal Engine MCP?

The closest alternatives to Unreal Engine MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Unreal Engine MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools