Unity-MCP connects AI coding agents to the Unity game engine through MCP, letting them work with the Unity Editor and running games. It is used by game developers to generate code, automate development and testing, debug projects, and add AI-driven behavior to games. The catalogue entries provide skills, instructions, an MCP integration, and settings for operating this workflow.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add IvanMurzak/Unity-MCP --skill unity-initial-setupgit clone --depth 1 https://github.com/IvanMurzak/Unity-MCPWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ivanmurzak/unity-mcp/unity-initial-setup)<a href="https://agentmods.dev/skills/ivanmurzak/unity-mcp/unity-initial-setup"><img src="https://agentmods.dev/badge/skills/ivanmurzak/unity-mcp/unity-initial-setup/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/ivanmurzak/unity-mcp/unity-initial-setup"><img src="https://agentmods.dev/badge/skills/ivanmurzak/unity-mcp/unity-initial-setup.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 3 findings, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium Excessive Agency · line 49 Skill grants unrestricted tool access without appropriate constraints. An agent with unfettered tool access can perform arbitrary actions including file modification, network requests, and code execution.Fix: Restrict tool access to only the tools required for the skill's stated purpose. Use an explicit allowlist rather than granting blanket access.
- medium MCP Rug Pull · line 51 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium Excessive Agency · line 67 Skill grants unrestricted tool access without appropriate constraints. An agent with unfettered tool access can perform arbitrary actions including file modification, network requests, and code execution.Fix: Restrict tool access to only the tools required for the skill's stated purpose. Use an explicit allowlist rather than granting blanket access.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00048 | $0.00861 |
| Opus 5 | $0.00024 | $0.00430 |
| Sonnet 5 | $0.00010 | $0.00172 |
| Haiku 4.5 | $0.00005 | $0.00086 |
Grade B, and why
unity-initial-setup scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Unrestricted tool accessmediumExcessive agency
A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.
Enable all tools, prompts, and resources: How it starts
The opening of the file, as written. The whole thing — 125 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AI Game Developer — Initial Setup
This guide walks through installing the unity-mcp-cli command-line tool and using it to set
up a Unity project with AI Skills and MCP integration.
Prerequisites
Install Node.js
unity-mcp-cli requires Node.js ^20.19.0 || >=22.12.0 (Node 21.x is not supported). If you don't have Node.js installed:
Download the installer from https://nodejs.org/ and run it, or use a package manager:
winget install OpenJS.NodeJS.LTS
After installation, verify both node and npm are available:
node --version
npm --version
Install unity-mcp-cli Globally
Install the CLI globally so the unity-mcp-cli command is available system-wide:
npm install -g unity-mcp-cli
Verify installation:
unity-mcp-cli --version
Alternative: Run any command without installing globally using
npx:npx unity-mcp-cli --help
Quick Start — Full Project Setup
1. Install the Unity-MCP Plugin
Add the plugin to an existing Unity project:
unity-mcp-cli install-plugin /path/to/unity/project
2. Configure MCP Tools
Enable all tools, prompts, and resources:
unity-mcp-cli configure /path/to/unity/project \
--enable-all-tools \
--enable-all-prompts \
--enable-all-resources
3. Set Up MCP for Your AI Agent
Configure MCP integration for your AI agent (e.g., Claude Code, Cursor, Copilot):
unity-mcp-cli setup-mcp claude-code /path/to/unity/project
List all supported agents:
unity-mcp-cli setup-mcp --list
4. Generate AI Skills
Generate skill files for your AI agent (requires Unity Editor to be running with the plugin):
unity-mcp-cli setup-skills claude-code /path/to/unity/project
5. Open Unity with MCP Connection
unity-mcp-cli open /path/to/unity/project
Common Commands Reference
| Command | Description |
|---|---|
unity-mcp-cli install-plugin <path> |
Install Unity-MCP plugin into a project |
unity-mcp-cli remove-plugin <path> |
Remove Unity-MCP plugin from a project |
unity-mcp-cli configure <path> --list |
List current MCP configuration |
unity-mcp-cli setup-mcp <agent> <path> |
Write MCP config for an AI agent |
unity-mcp-cli setup-skills <agent> <path> |
Generate skill files for an AI agent |
unity-mcp-cli create-project <path> |
Create a new Unity project |
unity-mcp-cli install-unity <version> |
Install a Unity Editor version |
unity-mcp-cli open <path> |
Open a Unity project in the Editor |
unity-mcp-cli run-tool <tool> <path> |
Execute an MCP tool via HTTP API |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 125 lines · 48 tokens per session scan B bee5bcdb5f9a
unity-initial-setup is a skill published in the GitHub repository IvanMurzak/Unity-MCP (4,223 stars, last pushed 5d ago), licensed Apache-2.0. It adds 48 tokens to every session and 861 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (unrestricted tool access). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
gaming-expert
Build comprehensive game systems including gameplay mechanics, multiplayer infrastructure, analytics tracking, and monetization features. Use when the user mentions game development, Unity or Unreal, gameplay mechanics, multiplayer netcode, game analytics, or in-game monetization.
professional-game-developer
Universal production game engineering skill — design, build, profile, test, and ship games across Unreal Engine 5, Unity 6 (DOTS), Godot 4.3+, Roblox (Luau), and Web/Custom engines with senior studio-grade architectural discipline. Encompasses all 42 specialized game studio job roles across 6 departments: Game Design…
steam-mcp
Steam-MCP exposes Valve Steam data through FastMCP 3.2 portmanteau tools on ports 11020 (backend) and 11021 (frontend).
unity-engineer
!cat skills/shared/protocols/3d-spatial-foundations.md 2>/dev/null || true !cat skills/shared/game-visual-foundations.md 2>/dev/null || echo "=== Visual Foundations not loaded ===" !cat skills/shared/protocols/ux-protocol.md 2>/dev/null || true !cat skills/shared/protocols/input-validation.md 2>/dev/null || true !cat…
uw-ui-toolkit-binder
Generate Unity 6+ UI Toolkit Runtime Data Binding code using MVVM pattern with [CreateProperty], DataBinding, and PropertyPath. Use when creating UI screens, HUDs, menus, inventories, settings panels, or any data-bound UI elements with UI Toolkit. Triggers on requests like "create a health bar", "build the HUD", "make…
uw-unity-test-runner
Generates EditMode and PlayMode tests using NUnit, mapped from GDD Gherkin scenarios. Use when writing tests, validating features, ensuring code quality, or verifying behavior after changes. Triggers on requests like "write tests for this", "test the health system", "add unit tests", "verify this works", "add PlayMode…