unity-mcp-orchestrator

Orchestrate Unity Editor automation through MCP tools and resources.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/cmitchellVFS/Scrabble --skill unity-mcp-orchestrator-cmitchellvfs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-mcp-orchestrator
Source: https://github.com/cmitchellVFS/Scrabble/tree/main/.claude/skills/unity-mcp-skill
Command: npx skills add https://github.com/cmitchellVFS/Scrabble --skill unity-mcp-orchestrator-cmitchellvfs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Unity Editor through MCP (Model Context Protocol) involves dozens of tools, resources, and version-specific conventions that are easy to misuse, causing compilation errors, stale edits, and failed operations. This Skill provides the operational knowledge to drive Unity Editor automation correctly and efficiently. ## Core Features & Use Cases - Resource-First Workflow: Read editor state, scene, and project info resources before invoking tools to prevent errors and detect installed packages (uGUI, TextMeshPro, Input System, UI Toolkit). - Tool Orchestration: Covers scene management, GameObject creation/modification, C# script creation and structured editing, prefabs, materials, UI (UI Toolkit and uGUI), cameras with Cinemachine, graphics, packages, ProBuilder, and test execution. - Best Practices: Batch operations with batch_execute, compilation-aware script workflows, screenshot-based visual verification, pagination handling, multi-instance routing, and error recovery patterns. - Use Case: Ask the AI to build a game scene in Unity — it creates a fresh scene, batches GameObject creation, writes and compiles C# scripts, wires component references, runs EditMode tests, and verifies the result with screenshots. ## Quick Start Use the unity-mcp-orchestrator skill to create a new Unity scene with a player character, a follow camera, and a movement script, then verify it 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?▼

Read the mcpforunity://editor/state resource first to confirm the editor is ready, then use tools like manage_gameobject, create_script, and manage_scene to perform actions. Batch multiple operations with batch_execute and verify results with read_console and screenshots.

How do I create and attach a C# script in Unity via MCP?▼

Call create_script with the file path and contents, which automatically triggers import and compilation. Wait until is_compiling is false in the editor state resource, check read_console for errors, then attach the script with manage_gameobject components_to_add.

Should I use UI Toolkit or uGUI for Unity UI through MCP?▼

Read the mcpforunity://project/info resource to detect installed packages. UI Toolkit is preferred for new UI using manage_ui with UXML and USS files, while uGUI Canvas-based UI uses batch_execute with manage_gameobject and manage_components.

Why do Unity MCP tools return busy or stale_file errors?▼

Busy responses mean compilation or a domain reload is in progress, so wait and recheck the editor state resource. A stale_file error means the file changed since your last read, so fetch a fresh hash with get_sha and retry the edit.

Can I run Unity tests through MCP tools?▼

Yes, run_tests starts an asynchronous EditMode or PlayMode test job and returns a job_id. Poll the result with get_test_job using a wait timeout, and include failed test details to diagnose failures.

Does Unity MCP support multiple editor instances?▼

Yes, list running editors via the mcpforunity://instances resource, then call set_active_instance with the project name and hash. All subsequent tool calls route to that selected Unity instance.