MCP Directory

How to add Unreal MCP to Cursor

Control Unreal Engine 5.5 from AI clients — spawn actors, build Blueprints, and wire node graphs via natural language. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 2.0k★ · stdio · no auth

Cursor config for Unreal MCP

uv --directory <path/to/unreal-mcp/Python> run unreal_mcp_server.py
{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/unreal-mcp/Python>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Unreal MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Unreal MCP's tools to confirm it's connected.

Before you start

  • Unreal Engine 5.5+
  • Python 3.12+ and the uv package manager
  • The UnrealMCP plugin built into your project (or use the bundled MCPGameProject starter) — requires generating VS project files and building the Development Editor target
  • An MCP client such as Claude Desktop, Cursor, or Windsurf

What Unreal MCP can do in Cursor

get_actors_in_level

List all actors in the current level

find_actors_by_name

Find actors matching a name pattern

spawn_actor

Create actors (cubes, spheres, lights, cameras, etc.)

delete_actor

Remove an actor from the level

set_actor_transform

Set an actor's position, rotation, and scale

get_actor_properties

Query an actor's properties

set_actor_property

Set a property on an actor

spawn_blueprint_actor

Spawn an actor from a Blueprint class

Security

The Python server relays commands to an unauthenticated localhost TCP socket (port 55557) that controls your Unreal Editor — it can spawn and delete actors and rewrite Blueprints, so only use it on projects under version control. The author labels it experimental, and there have been no updates since April 2025; newer UE versions may break it.

Unreal MCP + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Unreal MCP config there under the "mcpServers" key and restart the client.

Is Unreal MCP safe to use with Cursor?

The Python server relays commands to an unauthenticated localhost TCP socket (port 55557) that controls your Unreal Editor — it can spawn and delete actors and rewrite Blueprints, so only use it on projects under version control. The author labels it experimental, and there have been no updates since April 2025; newer UE versions may break it.

Is unreal-mcp safe to run on my game project?

It's free, MIT-licensed, and local-only, but it drives your editor over an unauthenticated localhost TCP port and is officially experimental — commit your project to version control first and expect breaking changes. With no commits since April 2025, newer UE releases may not work without fixes.

Does it work with Unreal Engine 4 or older UE 5 versions?

No — it targets UE 5.5+, and the bundled starter project is a UE 5.5 blank project. Older engine versions aren't supported, and given the repo's inactivity, forward compatibility with newer versions isn't guaranteed either.

Do I have to use the bundled sample project?

No. MCPGameProject just saves setup time; you can copy Plugins/UnrealMCP into any existing project, regenerate project files, build, and enable the plugin. The Python server and client config are identical either way.

View repo Full Unreal MCP page