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

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

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Unity MCP (AI Game Developer) config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Unity MCP (AI Game Developer)'s tools become available to Cascade.

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 Windsurf

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) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.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 Windsurf?

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