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/tests-runnpx skills add IvanMurzak/Unity-MCP --skill tests-rungit 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/tests-run)<a href="https://agentmods.dev/skills/ivanmurzak/unity-mcp/tests-run"><img src="https://agentmods.dev/badge/skills/ivanmurzak/unity-mcp/tests-run.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.1 | $0.00068 | $0.02192 |
| Opus 5 | $0.00034 | $0.01096 |
| Sonnet 5 | $0.00014 | $0.00438 |
| Haiku 4.5 | $0.00007 | $0.00219 |
Grade A, and why
tests-run 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 2d 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 — 280 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Tests / Run
Execute Unity tests and return detailed results. Supports filtering by test mode, assembly, namespace, class, and method. Recommended to use 'EditMode' for faster iteration during development. Precondition: every open scene MUST be saved (no unsaved changes). If any open scene is dirty, this tool throws an InvalidOperationException listing the dirty scenes; save them and retry.
Filters
testMode(defaultEditMode) —EditModeorPlayMode. EditMode is faster; prefer it during iteration.testAssembly/testNamespace/testClass/testMethod— optional, layered filters. Namespace and class filters become regexgroupNamesso the validation count and Unity's execution stay in sync.testMethodmust be fully qualified (Namespace.FixtureName.TestName).
Response toggles
includePassingTests(defaultfalse) — include details for passing tests; otherwise only failing test details are returned.includeMessages(defaulttrue) — include per-test result messages.includeStacktrace(defaultfalse) — include stack traces for failing tests.includeLogs(defaultfalse) — include console logs captured during the run.logType(defaultWarning) — minimum log severity to include.includeLogsStacktrace(defaultfalse) — include log stack traces (large payload; use sparingly).
Domain reloads
If the AssetDatabase refresh triggers compilation, the tool persists the run parameters to SessionState, returns Processing, and resumes the run automatically after the reload completes. Pre-existing compilation errors short-circuit the run and return the error details so the caller can fix the project first.
How to Call
unity-mcp-cli run-tool tests-run --input '{
"testMode": "string_value",
"testAssembly": "string_value",
"testNamespace": "string_value",
"testClass": "string_value",
"testMethod": "string_value",
"includePassingTests": false,
"includeMessages": false,
"includeStacktrace": false,
"includeLogs": false,
"logType": "string_value",
"includeLogsStacktrace": false
}'
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.
- 2d ago First seen · 280 lines · 68 tokens per session scan A 58a002db02de
tests-run is a skill published in the GitHub repository IvanMurzak/Unity-MCP (4,148 stars, last pushed yesterday), licensed Apache-2.0. It adds 68 tokens to every session and 2,192 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-09-03.
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.
uloop-run-tests
Run Unity Test Runner and report detailed results. Use for EditMode/PlayMode tests, change verification, or failure diagnosis.
creating-server-tests
Skill "creating-server-tests" from moorestech/moorestech, covering server test creator, テスト種別の選択, ワークフロー, 1. テスト種別に応じたテンプレートを選択 and 2. 必須ルール.
executing-csharp-scripts-in-unity-editor
Use this skill always when you need to use executecsharpscriptinunityeditor tool to modify scenes, add, remove or modify game objects, components, scriptable objects or perform any other task in Unity Editor using C# scripts. Also covers when and how to use readunityconsolelogs and rununitytests tools as part of the…