unity-mcp-orchestrator

Orchestrates Unity Editor automation through MCP tools for scenes, scripts, and verification.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill unity-mcp-orchestrator-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-mcp-orchestrator
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/unity-mcp-skill
Command: npx skills add https://github.com/Chau165/local_skill --skill unity-mcp-orchestrator-chau165

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Unity through MCP tools can lead to wasted effort when the editor is compiling, objects are assumed to exist, or changes go unverified. This Skill provides a disciplined operating guide so AI-driven Unity edits are safe, minimal, and verified. ## Core Features & Use Cases - Editor State Awareness: Read mcpforunity://editor/state before acting and wait while Unity is compiling, reloading the domain, or reconnecting. - Verify-Before-Edit Workflow: Inspect GameObjects, components, and hierarchies before modifying scenes, then confirm results with console checks and screenshots. - Structured Task Loops: Follow proven patterns for script fixes, scene repair, visual verification, compile errors, and asset reference reassignment. - Use Case: A C# script change breaks a scene reference. Use this Skill to edit the script, wait for compilation, read console errors, reassign the missing asset, and capture a screenshot to confirm the fix. ## Quick Start Use the Unity MCP skill to inspect the active scene, fix the missing component reference, and verify the result with a screenshot.

Frequently Asked Questions about unity-mcp-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Unity Editor tasks with MCP tools?

Use a resource-first loop: read `mcpforunity://editor/state`, inspect the scene and target GameObjects, make the smallest necessary change, then verify with console checks and screenshots. Batch similar operations to reduce latency and token usage.

How to verify Unity script changes after editing C# files?

After editing a script, wait for Unity compilation to finish, then read the console for errors and warnings. Only continue once the edited types compile and are usable, then validate in play mode or through object inspection.

Can MCP tools take screenshots of the Unity Editor?

Yes, Unity MCP supports screenshot capture for visual verification of scenes, UI, cameras, and prefabs. Prefer lower-resolution shots for quick checks and scene-view capture when editor framing matters.

Why do Unity MCP tool calls fail while Unity is connected?

Failures usually occur when Unity is compiling, reloading the domain, or the session was reloaded. Re-check the editor state, wait for compilation to finish, and retry after reconnecting if needed.

When should I avoid large scene rebuilds with Unity MCP?

Avoid rebuilding whole scenes when the task only needs a single component fix, prefab reference correction, asset assignment, or transform adjustment. Minimal edits reduce risk and keep verification fast.