# Unity MCP — MCP server card for AI agents

Unity Editor automation for AI agents: scenes, prefabs, assets, shaders, Timeline, tests, builds.

Registry name: `dev.shiranui-isuzu/unity-mcp` · category: Developer tools · version 4.4.2 · updated 2026-09-17

## Connect
- NuGet: `dnx IsuzuUnityCli`

## Facts
- Repository: https://github.com/isuzu-shiranui/UnityMCP (344 stars)
- Website: https://unity-mcp.shiranui-isuzu.dev/en/

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/dev-shiranui-isuzu-unity-mcp/


## Unity MCP: an AI assistant inside the Unity Editor

Unity MCP is a free add-on for the Unity game editor, made by an independent developer, not by Unity. With your project open, your AI assistant can read the errors, look through scenes, create and change objects, materials and animations, run tests and make builds. Each change it makes can be undone in one step.

### Where to use it
- Fix errors after a script change: After the assistant edits a script, it recompiles, collects the errors and reads the Console in one step, then fixes what broke.
- Build a scene by asking: Ask for a room with a floor, lights and a few props, and the assistant creates the objects, places them and saves the scene.
- Find out why a button does not react: The assistant checks what a click at that spot actually hits and what is in the way, then presses the button in play mode to confirm.
- See what slows a frame down: Get draw calls, triangles, memory by object and where frame time goes, so the assistant can suggest what to trim.
- Keep the assistant's tool list small: Load only the tool groups a task needs, such as checks and editing, so each request costs fewer tokens.
- A nightly test build: At the end of the day, have the assistant run the tests and make a player build, then report what failed and how big the build is. (idea, not from the official pages)

### How to start
- In Unity, open Window > Package Manager, choose Add package from git URL and paste the package address.

```
https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp
```

- Check Preferences > Unity MCP; the first Setup row reads Listening on port when the Editor accepts connections.
- Register your assistant, from the Preferences page or with the command tool, and start the assistant in the Unity project folder.

```
isuzu-unity-cli setup --mcp --agent claude-code
```


### License
Free and open source under the MIT license, also for paid games. Nothing from it ends up in your shipped game.

### Good to know
- The assistant can run any C# code and any menu item with full Editor rights. Only allow it on projects you trust it with.
- The connection token on your computer works like a password. Anything that can read it can run code in your Editor.
- The full tool list costs about 43,000 tokens on every request. Load only the groups you need.
- Scene edits made while the game runs in the Editor look applied but are undone when play mode stops.
- Deleted assets go to the system trash and deleted objects can be undone; applying a prefab, pressing a dialog button and package resolving cannot, so they ask first.

Checked 2026-11-10 against: https://unity-mcp.shiranui-isuzu.dev/en/, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/README.en.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/LICENSE, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/server.json, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/tools.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/mcp-clients.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/cli.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/security.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/defined-tools.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/input-tools.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/docs/en/architecture.md, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/jp.shiranui-isuzu.unity-mcp/package.json, https://github.com/isuzu-shiranui/UnityMCP/blob/7647bcab0ef8af53aff4c8f76cda502343d501ce/jp.shiranui-isuzu.unity-mcp/CHANGELOG.md, https://api.nuget.org/v3-flatcontainer/isuzuunitycli/index.json

### Mistakes to avoid
- Don't: Starting Claude Code in another folder or a subfolder after setup --mcp → Do: Start Claude Code in the Unity project folder, or register with --scope project. (The user-scope entry is filed under the Unity project's path, so a session elsewhere sees no server.)
- Don't: Putting using directives at the top of an execute_code snippet → Do: Write the snippet as a method body and name other types in full, as in UnityEngine.Rendering.Volume. (The snippet is placed in a method body, where a using directive is a compile error.)
- Don't: Editing the scene during play mode and keeping the result → Do: Stop play mode before scene edits; check the playModeWarning in the reply. (Scene edits made during play mode are reverted when it stops.)
- Don't: Polling job_status in a loop against the endpoint → Do: Wait with isuzu-unity-cli jobs <id> --wait. (Agents that only polled job_status waited for an answer that never came.)
- Don't: Exposing the Editor endpoint with ngrok or cloudflared so a web chat can reach it → Do: Use the stdio bridge, or OpenAI's Secure MCP Tunnel, and never expose the endpoint without authentication in front. (The endpoint executes C# inside Unity.)

### Questions
- Is this made by Unity? No. It is a community project by an independent developer, released under the MIT license.
- Does it need a separate server program? No. The Unity Editor itself serves the connection while the project is open; there is no second process to run.
- Can other computers or web pages reach my Editor? The server listens only on your own computer and every request needs the token. Web pages in your browser cannot call it.
- Will it end up in my game build? No. It is limited to the Editor and is never compiled into a player build, Development Builds included.
- Which Unity versions work? Unity 2022.3 or newer; the test suite runs on Unity 6000.0.35f1.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
