How to add Unity MCP (AI Game Developer) to Cursor

Connect Claude, Cursor & Windsurf to the Unity Engine for AI-driven game development in Editor and Runtime. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor config for Unity MCP (AI Game Developer)

npm install -g unity-mcp-cli

{
  "mcpServers": {
    "unity-mcp-ai-game-developer": {
      "command": "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe",
      "args": [
        "--port=8080",
        "--plugin-timeout=10000",
        "--client-transport=stdio"
      ]
    }
  }
}

Setup steps

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

Before you start

Unity Editor (project path must not contain spaces)
An MCP client / AI agent (Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini, etc.)
Node.js / npm if using the unity-mcp-cli for setup
Docker (optional) for the streamableHttp containerized server

What Unity MCP (AI Game Developer) can do in Cursor

gameobject-create

Create a new GameObject in the opened Prefab or in a Scene.

gameobject-modify

Modify GameObjects and/or attached components' fields and properties.

gameobject-component-add

Add a Component to a GameObject.

assets-prefab-create

Create a prefab from a GameObject in the current active scene.

assets-material-create

Create a new material asset with default parameters.

scene-create

Create a new scene in the project assets.

scene-open

Open a scene from the project asset file.

script-update-or-create

Update or create a script file with the provided C# code.

Security

The MCP server is unauthenticated by default (MCP_AUTHORIZATION=none). For remote/cloud (streamableHttp) deployments set --authorization=required and provide a bearer token via --token / MCP_PLUGIN_TOKEN. The server can compile and execute arbitrary C# (script-execute via Roslyn) and call any project method via reflection, so it grants the AI broad control over the Unity project and machine — run it only against trusted projects and clients.

Unity MCP (AI Game Developer) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Unity MCP (AI Game Developer) config there under the "mcpServers" key and restart the client.

Is Unity MCP (AI Game Developer) safe to use with Cursor?

Which AI agents / MCP clients are supported?

Claude Code (recommended), Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini, Antigravity, Cline, Kilo Code, Codex, Rider, Visual Studio, and any other client that supports Skills or dynamic MCP tool updates.

What transports does the server support?

Both stdio and streamableHttp. Use stdio when the MCP client launches the server binary directly (the most common local setup); use streamableHttp when running the server standalone, in Docker, or in the cloud over HTTP.

How do I configure my AI agent?

Open Window/AI Game Developer in Unity and click Auto-generate Skills or Configure MCP, or paste the shown mcpServers JSON into your client manually, or use a CLI command like 'claude mcp add ai-game-developer <command>' / 'gemini mcp add ai-game-developer <command>'.

View repo Full Unity MCP (AI Game Developer) page