Unity MCP Tools
Expert knowledge for coordinating Unity MCP operations, including tool enablement, agent orchestration, and direct MCP tool usage.
Quick Start: MCP Workflow
1. Inspect First (Always Available)
The MCP Resource is always enabled - no tool enablement needed:
- Command:
/unity-mcp-scene-info {path}
- Returns: components, properties, children, transform data
- Example:
/unity-mcp-scene-info GameplayScene/TileManager
2. Enable Tools When Modification Needed
Run /unity-mcp-enable [groups] before spawning agents that need MCP.
3. Spawn Agent with Skills
Include unity-mcp-tools skill for agents doing MCP work:
| Task |
Enable Groups |
Spawn Agent |
| Create/modify GameObjects |
gameobject, component |
scene-builder |
| Add UI elements |
gameobject, component |
ui-ux-developer |
| Run tests |
testing |
test-engineer |
| Work with scripts |
script |
code-architect |
| Create prefabs |
prefab, gameobject |
scene-builder |
| Deploy build |
(none) |
deployment-specialist |
4. Cleanup After MCP Work
Run /unity-mcp-reset to disable tools and save context.
When to Consult mcp-advisor
Spawn the mcp-advisor advisory agent when:
- Unsure which tool groups are needed
- MCP tools returning errors
- Complex multi-step Unity operations
- Need troubleshooting help
Example prompt: "What MCP tool groups do I need to add a health bar UI?"
The mcp-advisor returns recommendations - it does not execute commands.
Agent Skill Assignments
When spawning agents, include these skills:
| Agent |
Skills to Include |
| scene-builder |
unity-mcp-tools, layout-sizing, visual-style-guide |
| test-engineer |
unity-mcp-tools, unity-testing |
| ui-ux-developer |
layout-sizing, visual-style-guide |
| input-developer |
board-sdk, unity-mcp-tools |
| code-architect |
project-architecture |
| game-designer |
zero-day-rules |
| deployment-specialist |
(none - uses Bash) |
| project-producer |
documentation |
| mcp-advisor |
unity-mcp-tools |
Subagent MCP Access
Subagents can use MCP tools directly when:
- Tools are enabled in
AI-Game-Developer-Config.json
- Agent inherits tools (omit
tools: field in frontmatter)
To give MCP access, omit the tools field:
---
name: scene-builder
skills: unity-mcp-tools, layout-sizing
# No tools field = inherits ALL including MCP
---
Tool Groups Reference
Use /unity-mcp-enable [group] to enable. Multiple: /unity-mcp-enable gameobject component
Core Groups (11 total)
| Group |
Tools |
Use Case |
| scene-read |
scene-get-data, scene-list-opened, console-get-logs |
Inspect scene hierarchy |
| scene-write |
scene-create, scene-save, scene-open, scene-set-active, scene-unload, console-get-logs |
Modify scenes |
| gameobject |
gameobject-create, gameobject-find, gameobject-modify, gameobject-destroy, gameobject-duplicate, gameobject-set-parent, scene-save, console-get-logs |
GameObject operations |
| component |
gameobject-component-add, gameobject-component-get, gameobject-component-modify, gameobject-component-destroy, component-list, scene-save, console-get-logs |
Component operations |
| script |
script-read, script-update-or-create, script-delete, script-execute, assets-refresh, editor-application-get-state, console-get-logs |
Script operations |
| prefab |
assets-prefab-create, assets-prefab-instantiate, assets-prefab-open, assets-prefab-save, assets-prefab-close, assets-refresh, editor-application-get-state, console-get-logs |
Prefab operations |
| assets |
assets-find, assets-create-folder, assets-copy, assets-move, assets-delete, assets-get-data, assets-modify, assets-refresh, assets-material-create, assets-shader-list-all, console-get-logs |
Asset management |
| testing |
tests-run, editor-application-get-state, console-get-logs |
Run Unity tests |
| editor |
editor-application-get-state, editor-application-set-state, console-get-logs, editor-selection-get, editor-selection-set |
Full editor control |
| packages |
package-list, package-add, package-remove, package-search, console-get-logs |
Package management |
| reflection |
reflection-method-find, reflection-method-call, console-get-logs |
Advanced operations |
Cross-cutting Utilities (Auto-included)
| Tool |
Auto-included with |
| console-get-logs |
ALL groups |
| editor-application-get-state |
script, testing, prefab |
| assets-refresh |
script, prefab |
| scene-save |
gameobject, component |
Common Patterns
Create GameObject with Components
- Enable:
/unity-mcp-enable gameobject component
- Use
gameobject-create to create object
- Use
gameobject-component-add to add components
- Use
gameobject-component-modify to configure
Run Tests After Code Changes
- Enable:
/unity-mcp-enable testing
- Use
tests-run with testMode: "EditMode" or "PlayMode"
- Check results, fix failures
Inspect Before Modifying
Always use MCP Resource first (no enablement):
/unity-mcp-scene-info {path} to understand structure- Then enable tools only if modification needed
Configuration
Config file: Assets/Resources/AI-Game-Developer-Config.json
Structure:
{
"tools": [{ "name": "tool-name", "enabled": true/false }],
"resources": [{ "name": "GameObject from Current Scene by Path", "enabled": true }]
}
The MCP Resource is always enabled. Tools default to disabled.
Commands Reference
| Command |
Purpose |
/unity-mcp-status |
Show enabled groups |
/unity-mcp-enable [groups] |
Enable tool groups |
/unity-mcp-enable-all |
Enable all tools |
/unity-mcp-reset |
Disable all tools |
/unity-mcp-scene-info [path] |
Query scene via Resource |
Additional Resources
Reference Files
For complete tool documentation:
references/tool-reference.md - All 50 tools with parameters and examplesreferences/tool-groups.md - Tool group definitions with JSON arrays for each groupreferences/troubleshooting.md - Common issues and solutions
Related Documentation
- Documentation/Unity-MCP-Documentation.md - Full MCP setup guide
- .mcp.json - Connection configuration
1---2name: unity-mcp-tools-23description: This skill should be used when the user asks about "MCP tools", "Unity MCP", "enable tool groups", "which MCP tools", "create GameObject", "add component", "run Unity tests", "check scene hierarchy", "spawn agent for Unity", "MCP not working", or needs to coordinate Unity Editor operations via MCP.4---56# Unity MCP Tools78Expert knowledge for coordinating Unity MCP operations, including tool enablement, agent orchestration, and direct MCP tool usage.910## Quick Start: MCP Workflow1112### 1. Inspect First (Always Available)1314The MCP Resource is always enabled - no tool enablement needed:1516- Command: `/unity-mcp-scene-info {path}`17- Returns: components, properties, children, transform data18- Example: `/unity-mcp-scene-info GameplayScene/TileManager`1920### 2. Enable Tools When Modification Needed2122Run `/unity-mcp-enable [groups]` before spawning agents that need MCP.2324### 3. Spawn Agent with Skills2526Include `unity-mcp-tools` skill for agents doing MCP work:2728| Task | Enable Groups | Spawn Agent |29| ------------------------- | --------------------- | --------------------- |30| Create/modify GameObjects | gameobject, component | scene-builder |31| Add UI elements | gameobject, component | ui-ux-developer |32| Run tests | testing | test-engineer |33| Work with scripts | script | code-architect |34| Create prefabs | prefab, gameobject | scene-builder |35| Deploy build | (none) | deployment-specialist |3637### 4. Cleanup After MCP Work3839Run `/unity-mcp-reset` to disable tools and save context.4041## When to Consult mcp-advisor4243Spawn the mcp-advisor advisory agent when:4445- Unsure which tool groups are needed46- MCP tools returning errors47- Complex multi-step Unity operations48- Need troubleshooting help4950Example prompt: "What MCP tool groups do I need to add a health bar UI?"5152The mcp-advisor returns recommendations - it does not execute commands.5354## Agent Skill Assignments5556When spawning agents, include these skills:5758| Agent | Skills to Include |59| --------------------- | -------------------------------------------------- |60| scene-builder | unity-mcp-tools, layout-sizing, visual-style-guide |61| test-engineer | unity-mcp-tools, unity-testing |62| ui-ux-developer | layout-sizing, visual-style-guide |63| input-developer | board-sdk, unity-mcp-tools |64| code-architect | project-architecture |65| game-designer | zero-day-rules |66| deployment-specialist | (none - uses Bash) |67| project-producer | documentation |68| mcp-advisor | unity-mcp-tools |6970## Subagent MCP Access7172Subagents can use MCP tools directly when:73741. Tools are enabled in `AI-Game-Developer-Config.json`752. Agent inherits tools (omit `tools:` field in frontmatter)7677To give MCP access, omit the tools field:7879```yaml80---81name: scene-builder82skills: unity-mcp-tools, layout-sizing83# No tools field = inherits ALL including MCP84---85```8687## Tool Groups Reference8889Use `/unity-mcp-enable [group]` to enable. Multiple: `/unity-mcp-enable gameobject component`9091### Core Groups (11 total)9293| Group | Tools | Use Case |94| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |95| scene-read | scene-get-data, scene-list-opened, console-get-logs | Inspect scene hierarchy |96| scene-write | scene-create, scene-save, scene-open, scene-set-active, scene-unload, console-get-logs | Modify scenes |97| gameobject | gameobject-create, gameobject-find, gameobject-modify, gameobject-destroy, gameobject-duplicate, gameobject-set-parent, scene-save, console-get-logs | GameObject operations |98| component | gameobject-component-add, gameobject-component-get, gameobject-component-modify, gameobject-component-destroy, component-list, scene-save, console-get-logs | Component operations |99| script | script-read, script-update-or-create, script-delete, script-execute, assets-refresh, editor-application-get-state, console-get-logs | Script operations |100| prefab | assets-prefab-create, assets-prefab-instantiate, assets-prefab-open, assets-prefab-save, assets-prefab-close, assets-refresh, editor-application-get-state, console-get-logs | Prefab operations |101| assets | assets-find, assets-create-folder, assets-copy, assets-move, assets-delete, assets-get-data, assets-modify, assets-refresh, assets-material-create, assets-shader-list-all, console-get-logs | Asset management |102| testing | tests-run, editor-application-get-state, console-get-logs | Run Unity tests |103| editor | editor-application-get-state, editor-application-set-state, console-get-logs, editor-selection-get, editor-selection-set | Full editor control |104| packages | package-list, package-add, package-remove, package-search, console-get-logs | Package management |105| reflection | reflection-method-find, reflection-method-call, console-get-logs | Advanced operations |106107### Cross-cutting Utilities (Auto-included)108109| Tool | Auto-included with |110| ---------------------------- | ----------------------- |111| console-get-logs | ALL groups |112| editor-application-get-state | script, testing, prefab |113| assets-refresh | script, prefab |114| scene-save | gameobject, component |115116## Common Patterns117118### Create GameObject with Components1191201. Enable: `/unity-mcp-enable gameobject component`1212. Use `gameobject-create` to create object1223. Use `gameobject-component-add` to add components1234. Use `gameobject-component-modify` to configure124125### Run Tests After Code Changes1261271. Enable: `/unity-mcp-enable testing`1282. Use `tests-run` with testMode: "EditMode" or "PlayMode"1293. Check results, fix failures130131### Inspect Before Modifying132133Always use MCP Resource first (no enablement):134135- `/unity-mcp-scene-info {path}` to understand structure136- Then enable tools only if modification needed137138## Configuration139140Config file: `Assets/Resources/AI-Game-Developer-Config.json`141142Structure:143144```json145{146 "tools": [{ "name": "tool-name", "enabled": true/false }],147 "resources": [{ "name": "GameObject from Current Scene by Path", "enabled": true }]148}149```150151The MCP Resource is always enabled. Tools default to disabled.152153## Commands Reference154155| Command | Purpose |156| ------------------------------ | ------------------------ |157| `/unity-mcp-status` | Show enabled groups |158| `/unity-mcp-enable [groups]` | Enable tool groups |159| `/unity-mcp-enable-all` | Enable all tools |160| `/unity-mcp-reset` | Disable all tools |161| `/unity-mcp-scene-info [path]` | Query scene via Resource |162163## Additional Resources164165### Reference Files166167For complete tool documentation:168169- **`references/tool-reference.md`** - All 50 tools with parameters and examples170- **`references/tool-groups.md`** - Tool group definitions with JSON arrays for each group171- **`references/troubleshooting.md`** - Common issues and solutions172173### Related Documentation174175- **Documentation/Unity-MCP-Documentation.md** - Full MCP setup guide176- **.mcp.json** - Connection configuration
majiayu000