Unity MCP

✨ AI Game Developer — Unity SKILLS, MCP

[](https://modelcontextprotocol.io/introduction) [](https://openupm.com/packages/com.ivanmurzak.unity.mcp/) [](https://hub.docker.com/r/aigamedeveloper/mcp-server) [](https://unity.com/releases/editor/archive) [](https://unity.com/releases/editor/archive) [](https://github.com/IvanMurzak/Unity-MCP/actions/workflows/release.yml) [](https://discord.gg/cfbdMZX99G) [](https://openupm.com/packages/com.ivanmurzak.unity.mcp/) [](https://github.com/IvanMurzak/Unity-MCP/stargazers) [](https://github.com/IvanMurzak/Unity-MCP/blob/main/LICENSE) [](https://stand-with-ukraine.pp.ua)

                                

中文 | 日本語 | Español

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](#add-custom-tool)

[](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

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. Login to cloud server
unity-mcp-cli login ./MyUnityProject

# 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](#step-1-install-unity-mcp-plugin) — download the .unitypackage installer or run openupm add com.ivanmurzak.unity.mcp

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

1. [Pick an AI agent](#step-2-install-ai-agent) — Claude Code, Claude Desktop, GitHub Copilot, Cursor, or any other
2. [Setup AI agent](#step-3-configure-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](docs/default-mcp-tools.md) for the full reference with detailed descriptions.

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

Project & Assets

• 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

Scene & Hierarchy

• 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
• scene-unload - Unload scene from the opened scenes in Unity Editor
• screenshot-camera - Captures a screenshot from a camera and returns it as an image
• screenshot-game-view - Captures a screenshot from the Unity Editor Game View
• screenshot-isolated - Render a GameObject in isolation from a chosen angle (optional composite 2x2 view)
• screenshot-scene-view - Captures a screenshot from the Unity Editor Scene View

Scripting & Editor

• console-clear-logs - Clears the MCP log cache and the Unity Editor Console window
• console-get-logs - Retrieves Unity Editor logs with filtering options
• editor-application-get-state - Returns information about the Unity Editor application state (playmode, paused, compilation)
• editor-application-set-state - Control the Unity Editor application state (start/stop/pause playmode)
• editor-selection-get - Get information about the current Selection in the Unity Editor
• editor-selection-set - Set the current Selection in the Unity Editor
• reflection-method-call - Call any C# method with input parameters and return results
• reflection-method-find - Find method in the project using C# Reflection (even private methods)
• script-delete - Delete the script file(s)
• script-execute - Compiles and executes C# code dynamically using Roslyn
• script-read - Reads the content of a script file
• script-update-or-create - Updates or creates script file with the provided C# code
• tests-run - Execute Unity tests (EditMode/PlayMode) with filtering and detailed results
• type-get-json-schema - Generate a JSON Schema for a C# type via reflection

Profiling & Diagnostics

• profiler-capture-frame - Capture the current frame's timing info (delta time, FPS, frame counts)
• profiler-clear-data - Discard all frames currently held by the Editor Profiler
• profiler-enable-module - Toggle the local enabled flag for a named profiler module
• profiler-get-memory-stats - Return a memory statistics snapshot (reserved, allocated, mono heap, graphics)
• profiler-get-rendering-stats - Return frame timing, FPS, vsync, target frame rate, graphics device type
• profiler-get-script-stats - Return script execution timing plus Mono / GC memory usage
• profiler-get-status - Return the profiler's enabled state, active modules, and platform support
• profiler-list-modules - List all known profiler module names with their enabled flag
• profiler-load-data - Read back a previously-saved profiler JSON snapshot
• profiler-save-data - Save a snapshot of profiler-derived stats to a JSON file
• profiler-start - Enable Unity's runtime profiler and open the Profiler window
• profiler-stop - Disable Unity's runtime profiler

Install Additional Skills and Tools

Install extensions when need more tools or [create your own tools](#add-custom-tool).

| Extension | Description | | --- | --- | | AI Animation | Set of additional tools for Unity Animations | | AI Cinemachine | MCP Tools for Cinemachine | | AI InputSystem | MCP Tools for the Unity Input System | | AI Navigation | MCP Tools for AI Navigation (NavMesh surfaces, baking, agents, links) | | AI ParticleSystem | Set of additional tools for Unity Particle System | | AI ProBuilder | Set of additional tools for Unity ProBuilder | | AI Splines | MCP Tools for Unity Splines | | AI Terrain | Set of additional tools for Unity Terrain | | AI Tilemap | MCP Tools for Unity 2D Tilemaps | | AI Timeline | MCP Tools for Unity Timeline cutscenes and sequences |

Contents

• [Quick Start](#quick-start)
• [Skills and Tools Reference](#skills-and-tools-reference)
• [Install Additional Skills and Tools](#install-additional-skills-and-tools)
• [Contents](#contents)
• [More Documentation](#more-documentation)
• [Installation](#installation)
• [Step 1: Install Unity MCP Plugin](#step-1-install-unity-mcp-plugin)
• [Option 1 - Installer](#option-1---installer)
• [Option 2 - CLI (recommended)](#option-2---cli-recommended)
• [Step 2: Install AI agent](#step-2-install-ai-agent)
• [Step 3: Configure AI agent](#step-3-configure-ai-agent)
• [Automatic configuration](#automatic-configuration)
• [Manual configuration](#manual-configuration)
• [Command line configuration](#command-line-configuration)
• [AI Workflow Examples](#ai-workflow-examples)
• [Advanced Features for LLM](#advanced-features-for-llm)
• [Core Capabilities](#core-capabilities)
• [Reflection-Powered Features](#reflection-powered-features)
• [Customize Tools](#customize-tools)
• [Add custom Tool](#add-custom-tool)
• [Add custom MCP Prompt](#add-custom-mcp-prompt)
• [Runtime usage (in-game)](#runtime-usage-in-game)
• [Sample: AI powered Chess game bot](#sample-ai-powered-chess-game-bot)
• [Why runtime usage is needed?](#why-runtime-usage-is-needed)
• [Unity MCP Server setup](#unity-mcp-server-setup)
• [Variables](#variables)
• [Plugin Variables](#plugin-variables)
• [Docker 📦](#docker-)
• [streamableHttp Transport](#streamablehttp-transport)
• [stdio Transport](#stdio-transport)
• [Custom port](#custom-port)
• [Binary executable](#binary-executable)
• [How Unity MCP Architecture Works](#how-unity-mcp-architecture-works)
• [What is MCP](#what-is-mcp)
• [What is AI agent](#what-is-ai-agent)
• [What is MCP Server](#what-is-mcp-server)
• [What is MCP Tool](#what-is-mcp-tool)
• [When to use Tool](#when-to-use-tool)
• [What is MCP Resource](#what-is-mcp-resource)
• [When to use MCP Resource](#when-to-use-mcp-resource)
• [What is MCP Prompt](#what-is-mcp-prompt)
• [When to use MCP Prompt](#when-to-use-mcp-prompt)
• [Contribution 💙💛](#contribution-)

More Documentation

| Document | Description | | -------- | ----------- | | [Default MCP Tools](docs/default-mcp-tools.md) | Full reference of all built-in tools with descriptions | | [MCP Server Setup](docs/mcp-server.md) | Server configuration, environment variables, remote hosting | | [Docker Deployment](docs/DOCKERDEPLOYMENT.md) | Step-by-step Docker deployment guide | | [Development Guide](docs/dev/Development.md) | Architecture, code style, CI/CD — for contributors | | Wiki | Getting started, tutorials, API reference, FAQ | | CLI Tool | Install plugins, configure, and connect via command line |

# 1.1 Install unity-mcp-cli                                #  ┌────────────────────┐
npm install -g unity-mcp-cli                               #  │ Available AI agent │
                                                           #  ├────────────────────┤
# 1.2 (Optional) Install Unity                             #  │ antigravity        │
unity-mcp-cli install-unity                                #  │ claude-code        │
                                                           #  │ claude-desktop     │
# 1.3 (Optional) Create Unity project                      #  │ cline              │
unity-mcp-cli create-project ./MyUnityProject              #  │ codex              │

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [IvanMurzak](https://github.com/IvanMurzak)
- **Source:** [IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
- **License:** Apache-2.0
- **Homepage:** https://ai-game.dev

Install and usage instructions live in the source repository linked above.