Unity Open MCP gives AI agents a typed, safety-gated tool surface for Unity projects.
The MCP server exposes 250+ tools across typed editor workflows, gate and validation, asset intelligence, diagnostics, and embedded domain groups.
- Safe mutations with automatic validation, checkpoints, deltas, regression checks, and targeted fixes.
- Structured asset search, inspection, reserialization, and reference analysis.
- Live Unity bridge, batch fallback for supported tools, and offline readers.
- Typed editor and embedded-domain workflows, surfaced through per-session tool groups.
- Unity Hub Pro for guided setup and maintainer workflows.
For the full catalog and contracts, see docs/api/mcp-tools.md.
Requires Unity 2022.3 LTS or newer.
- Easiest (AI agent): paste this prompt into your AI client (Cursor, Claude, …) and let it install for you:
Install Unity Open MCP in this Unity project by following
https://raw.githubusercontent.com/AlexeyPerov/Unity-Open-MCP/master/docs/setup/agent-setup.md
exactly. Do every agent step yourself; stop and tell me only when a human action is required.
If this monorepo is already open locally, read docs/setup/agent-setup.md from disk instead of fetching.
Full procedure: Agent setup.
- Manual: edit the package and MCP client configuration yourself with Manual setup.
- Local checkout: build and run the repository with Development setup.
- Unity Hub Pro: use the UI flow in Wizard setup.
简体中文文档：README.zh-CN.md（Chinese translation of this README and the setup guides).
For users:
- API index — MCP, bridge, resource, routing, and automation contracts.
- Extensions — embedded domains, dependencies, and tool-group activation.
- Troubleshooting — connectivity and recovery guidance.
- Dialog policy — startup modal handling and automation.
- Skills — agent playbooks installed into Unity projects.
- Version compatibility — version matching and mismatch recovery.
For contributors:
- Architecture — repository boundaries and runtime flow.
- Code conventions — non-obvious C# contracts.
Would like to see other MCP options? See the MCP tools for Unity comparison — a side-by-side feature matrix of Unity Open MCP and the other MCP tools / AI assistants in the space.
Unity Hub Pro is the desktop companion app for Unity Open MCP. It helps you manage projects, run the AI Setup wizard, and handle maintainer workflows from one UI. See docs for details.
- Read CONTRIBUTING.md before opening an issue or pull request.
- Contributor troubleshooting covers local test, bridge, and automation failures.
- Validation Suite — app for guided manual validation; ships runnable scenario packs.
- Maintainer versioning and releases — synchronization, tags, and release workflows.
License: MIT — see LICENSE.