<div align="center" width="100%"> <h1>✨ AI Game Developer — <i>Unity SKILLS, MCP</i></h1>

</br>

<img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/promo/ai-developer-banner.jpg" alt="AI work" title="Level building" width="100%"> <p> <a href="https://claude.ai/download"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/claude-64.png" alt="Claude" title="Claude" height="36"></a>&nbsp;&nbsp; <a href="https://openai.com/index/introducing-codex/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/codex-64.png" alt="Codex" title="Codex" height="36"></a>&nbsp;&nbsp; <a href="https://www.cursor.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/cursor-64.png" alt="Cursor" title="Cursor" height="36"></a>&nbsp;&nbsp; <a href="https://code.visualstudio.com/docs/copilot/overview"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/github-copilot-64.png" alt="GitHub Copilot" title="GitHub Copilot" height="36"></a>&nbsp;&nbsp; <a href="https://gemini.google.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/gemini-64.png" alt="Gemini" title="Gemini" height="36"></a>&nbsp;&nbsp; <a href="https://antigravity.google/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/antigravity-64.png" alt="Antigravity" title="Antigravity" height="36"></a>&nbsp;&nbsp; <a href="https://code.visualstudio.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/vs-code-64.png" alt="VS Code" title="VS Code" height="36"></a>&nbsp;&nbsp; <a href="https://www.jetbrains.com/rider/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/rider-64.png" alt="Rider" title="Rider" height="36"></a>&nbsp;&nbsp; <a href="https://visualstudio.microsoft.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/visual-studio-64.png" alt="Visual Studio" title="Visual Studio" height="36"></a>&nbsp;&nbsp; <a href="https://opencode.ai/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/open-code-64.png" alt="Open Code" title="Open Code" height="36"></a>&nbsp;&nbsp; <a href="https://github.com/cline/cline"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/cline-64.png" alt="Cline" title="Cline" height="36"></a>&nbsp;&nbsp; <a href="https://github.com/Kilo-Org/kilocode"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/kilo-code-64.png" alt="Kilo Code" title="Kilo Code" height="36"></a> </p>

<b>中文 | 日本語 | Español</b>

</div>

Unity MCP is an AI-powered game development assistant for Editor & Runtime. Connect Claude, Cursor, & Windsurf to Unity via MCP. Automate workflows, generate code, and enable AI within your games.

Unlike other tools, this plugin works inside your compiled game, allowing for real-time AI debugging and player-AI interaction.

💬 Join our Discord Server - Ask questions, showcase your work, and connect with other developers!

• ✔️ AI agents - Use the best agents from Anthropic, OpenAI, Microsoft, or any other provider with no vendor lock-in
• ✔️ Tools - A wide range of default MCP Tools for operating in Unity Editor
• ✔️ Skills - Generate skills for AI based on operating system, Unity version, plugins in the project
• ✔️ Code and Tests - Develop game mechanics and test them with AI agents
• ✔️ Runtime (in-game) - Use LLMs directly inside your compiled game for dynamic NPC behavior or debugging
• ✔️ Debug support - Let AI debug and fix the problems in a project
• ✔️ Natural conversation - Chat with AI like you would with a human
• ✔️ Flexible deployment - Works locally (stdio) and remotely (http) via configuration
• ✔️ Extensible - Create custom Tools in your project code

https://github.com/user-attachments/assets/228baf4d-4f00-4dce-939d-fb985ebdd8dd

OR use cli

# 1. Install unity-mcp-cli
npm install -g unity-mcp-cli

# 2. Install "AI Game Developer" in Unity project
unity-mcp-cli install-plugin ./MyUnityProject

# 3. Sign in to ai-game.dev (opens your browser — OAuth device flow)
unity-mcp-cli login

# 4. Open Unity project (auto-connects and generates skills)
unity-mcp-cli open ./MyUnityProject

Quick Start

Get up and running in three steps:

1. Install plugin — download the .unitypackage installer or run openupm add com.ivanmurzak.unity.mcp

   Alternative: npx unity-mcp-cli install-plugin ./MyUnityProject — see CLI documentation

2. Pick an AI agent — Claude Code, Claude Desktop, GitHub Copilot, Cursor, or any other
3. Setup AI agent — open Window/AI Game Developer in Unity and click Auto-generate skills (recommended) or Configure MCP

   Alternative: npx unity-mcp-cli setup-skills claude-code ./MyUnityProject — see CLI documentation

That's it. Ask your AI "Create 3 cubes in a circle with radius 2" and watch it happen. ✨

---

Skills and Tools Reference

The plugin ships with 70+ built-in tools across four categories. Each tool brings AI skill. All tools are available immediately after installation — no extra configuration required. See docs/default-mcp-tools.md for the full reference with detailed descriptions.

🧰 Browse the full MCP tools registry online: ai-game.dev/docs/tools

<details> <summary>Project & Assets</summary>

• assets-copy - Copy the asset at path and stores it at newPath
• assets-create-folder - Creates a new folder in the specified parent folder
• assets-delete - Delete the assets at paths from the project
• assets-find - Search the asset database using the search filter string
• assets-find-built-in - Search the built-in assets of the Unity Editor
• assets-get-data - Get asset data from the asset file including all serializable fields and properties
• assets-material-create - Create new material asset with default parameters
• assets-modify - Modify asset file in the project
• assets-move - Move the assets at paths in the project (also used for rename)
• assets-prefab-close - Close currently opened prefab
• assets-prefab-create - Create a prefab from a GameObject in the current active scene
• assets-prefab-instantiate - Instantiates prefab in the current active scene
• assets-prefab-open - Open prefab edit mode for a specific GameObject
• assets-prefab-save - Save a prefab in prefab editing mode
• assets-refresh - Refreshes the AssetDatabase
• assets-shader-get-data - Get detailed data about a shader asset (properties, subshaders, passes)
• assets-shader-list-all - List all available shaders in the project assets and packages
• package-add - Install a package from the Unity Package Manager registry, Git URL, or local path
• package-list - List all packages installed in the Unity project (UPM packages)
• package-remove - Remove (uninstall) a package from the Unity project
• package-search - Search for packages in both Unity Package Manager registry and installed packages

</details> <details> <summary>Scene & Hierarchy</summary>

• gameobject-component-add - Add Component to GameObject
• gameobject-component-destroy - Destroy one or many components from target GameObject
• gameobject-component-get - Get detailed information about a specific Component on a GameObject
• gameobject-component-list-all - List C# class names extended from UnityEngine.Component
• gameobject-component-modify - Modify a specific Component on a GameObject
• gameobject-create - Create a new GameObject in opened Prefab or in a Scene
• gameobject-destroy - Destroy GameObject and all nested GameObjects recursively
• gameobject-duplicate - Duplicate GameObjects in opened Prefab or in a Scene
• gameobject-find - Finds specific GameObject by provided information
• gameobject-modify - Modify GameObjects and/or attached component's fields and properties
• gameobject-set-parent - Set parent GameObject to list of GameObjects
• object-get-data - Get data of the specified Unity Object
• object-modify - Modify the specified Unity Object
• scene-create - Create new scene in the project assets
• scene-get-data - Retrieves the list of root GameObjects in the specified scene
• scene-list-opened - Returns the list of currently opened scenes in Unity Editor
• scene-open - Open scene from the project asset file
• scene-save - Save opened scene to the asset file
• scene-set-active - Set the specified opened scene as the active scene
• `scen