Unreal Engine MCP Server

by chir24ai.smithery/ChiR24-unreal_mcpv0.4.6

A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via native automation bridge. Built with TypeScript and designed for game development automation.

910Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Unreal Engine MCP server

claude mcp add unreal -e UE_PROJECT_PATH='<ue-project-path>' -e MCP_AUTOMATION_CAPABILITY_TOKEN='<mcp-automation-capability-token>' -- npx -y unreal-engine-mcp-server

{
  "mcpServers": {
    "unreal": {
      "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<ue-project-path>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<mcp-automation-capability-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "unreal": {
      "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "unreal": {
      "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.

Configuration

Variable	Required	Secret	Description
UE_PROJECT_PATH	yes	—	Your Unreal project folder or its .uproject file. The server reads the capability token from <project>/Saved/MCP/capability-token and the WebSocket port from the project settings.
MCP_AUTOMATION_CAPABILITY_TOKEN	—	yes	Capability token to present to the editor. Only needed when the server cannot read the project folder, for example over LAN.
MCP_AUTOMATION_PORT	—	—	Editor WebSocket port. Default: the first Listen Ports entry in the project settings, else 8090.
MCP_AUTOMATION_HOST	—	—	Editor host to connect to. A LAN address also needs MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true and Allow Non Loopback in the plugin settings.
MCP_AUTOMATION_ALLOW_NON_LOOPBACK	—	—	SECURITY: allow a non-loopback MCP_AUTOMATION_HOST. Enable only on a trusted network.
MCP_AUTOMATION_USE_TLS	—	—	Connect with wss:// instead of ws://.
MCP_ADDITIONAL_PATH_PREFIXES	—	—	Extra content roots to allow besides /Game, /Engine, /Script, /Temp and /Niagara, comma-separated. Example: /MyPluginContent/
MCP_CONNECTION_TIMEOUT_MS	—	—	How long to wait for the editor connection, in milliseconds.
MCP_REQUEST_TIMEOUT_MS	—	—	Overrides every per-capability request timeout, in milliseconds. Leave unset: each capability gets a budget that fits its cost.
MCP_AUTOMATION_MAX_MESSAGES_PER_MINUTE	—	—	Inbound messages per minute from the editor before the server disconnects.
LOG_LEVEL	—	—	Log level. Logs go to stderr.

Remote endpoints

streamable-httphttps://server.smithery.ai/@ChiR24/unreal_mcp/mcp
streamable-httphttps://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-06-05 · 4mo ago · GitHub · v0.5.30
Package published
no data · npm/PyPI
Registry entry updated
2025-10-05 · 12mo ago · official registry · v0.4.6

FAQ

›How do I install the Unreal Engine MCP server in Claude Code?

Run: claude mcp add unreal -e UE_PROJECT_PATH='<ue-project-path>' -e MCP_AUTOMATION_CAPABILITY_TOKEN='<mcp-automation-capability-token>' -- npx -y unreal-engine-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Unreal Engine require an API key?

Yes. It expects UE_PROJECT_PATH, MCP_AUTOMATION_CAPABILITY_TOKEN, of which 1 is a secret.

›Can I use Unreal Engine as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Unreal Engine in the official MCP registry?

Yes, as ai.smithery/ChiR24-unreal_mcp.