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 agentmods add skills/ivanmurzak/unity-mcp/package-addnpx skills add IvanMurzak/Unity-MCP --skill package-addgit 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/package-add)<a href="https://agentmods.dev/skills/ivanmurzak/unity-mcp/package-add"><img src="https://agentmods.dev/badge/skills/ivanmurzak/unity-mcp/package-add.svg" alt="Measured on agentmods" height="20"></a>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 | $0.00068 | $0.00659 |
| Opus 5 | $0.00034 | $0.00329 |
| Sonnet 5 | $0.00014 | $0.00132 |
| Haiku 4.5 | $0.00007 | $0.00066 |
Grade A, and why
package-add scanned grade A with 0 findings 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 4d 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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 74 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Package Manager / Add
Install a package from the Unity Package Manager registry, Git URL, or local path. This operation modifies the project's manifest.json and triggers package resolution. Note: Package installation may trigger a domain reload. The result will be sent after the reload completes. Use 'package-search' tool to search for packages and 'package-list' to list installed packages.
packageId formats
- Plain package ID:
com.unity.textmeshpro(installs latest compatible version). - Pinned version:
[email protected]. - Git URL:
https://github.com/user/repo.git. - Git URL with branch/tag:
https://github.com/user/repo.git#v1.0.0. - Local path:
file:../MyPackage.
Processing model
Returns Processing immediately with the supplied requestId. Once Client.Add completes, a follow-up result is delivered: success → SchedulePostDomainReloadNotification (delivers after the reload finishes), failure → an immediate error notification with the underlying Unity error message.
How to Call
unity-mcp-cli run-tool package-add --input '{
"packageId": "string_value"
}'
For complex input (multi-line strings, code), save the JSON to a file and use:
unity-mcp-cli run-tool package-add --input-file args.jsonOr pipe via stdin (recommended):
unity-mcp-cli run-tool package-add --input-file - <<'EOF' {"param": "value"} EOF
Troubleshooting
If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead.
Read the /unity-initial-setup skill for detailed installation instructions.
Input
| Name | Type | Required | Description |
|---|---|---|---|
packageId |
string |
Yes | The package ID to install. Formats: Package ID 'com.unity.textmeshpro' (installs latest compatible version), Package ID with version '[email protected]', Git URL 'https://github.com/user/repo.git', Git URL with branch/tag 'https://github.com/user/repo.git#v1.0.0', Local path 'file:../MyPackage'. |
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.
- 4d ago First seen · 74 lines · 68 tokens per session scan A c848efc4f33e
package-add is a skill published in the GitHub repository IvanMurzak/Unity-MCP (4,079 stars, last pushed 10d ago), licensed Apache-2.0. It adds 68 tokens to every session and 659 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
unity-mcp-orchestrator
Orchestrate Unity Editor via MCP (Model Context Protocol) tools and resources. Use when working with Unity projects through MCP for Unity - creating/modifying GameObjects, editing scripts, managing scenes, running tests, or any Unity Editor automation. Provides best practices, tool schemas, and workflow patterns for…
blender-to-unity
Hand off a model from Blender (via BlenderMCP) into Unity (via MCP for Unity) — export the current Blender model, import it through importmodelfile, and place it in the open scene. Use when the user has BlenderMCP and MCP for Unity both connected and wants to bring a Blender model into Unity. Does NOT drive Blender's…
mcp-source
Switch MCP for Unity package source in connected Unity projects. Use /mcp-source [main|beta|branch|local] to swap between upstream releases, your remote branch, or local dev checkout.
play
Start or resume an RPG adventure. Creates worlds, characters, and runs the game.
augment-world
Add new content to an existing world pack. Batch add monsters, NPCs, items, locations, and encounters.
combat-mode
Enter focused combat mode with only combat-relevant tools available. Optimized for fast, decisive tactical play.