# unitymcptest-mcp

Connects AI agents to Unity Play Mode checks over Streamable HTTP and outputs structured test receipts. Requires a paid account and bearer token.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: clauxel
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clauxel/unity-mcp-test-loop-mcp
- Updated: 2026-05-27
- HTML: https://affpapa.org/en/nevibecode/mcp/unitymcptest-mcp

## What it does

This remote service exposes four primary tools to MCP clients: `run_unity_playmode_check`, `invoke_unity_method`, `summarize_unity_failure`, and `export_unity_receipt`. Through these endpoints, an agent runs Play Mode inspections inside Unity, triggers engine methods, and formats failure diagnostics into JSON receipts.

The service runs remotely at `https://unitymcptest.clauxel.com/mcp` using Streamable HTTP. Because it operates as a paid hosted endpoint, unauthenticated requests are rejected with a JSON error. Production calls require a valid bearer token generated via the provider platform.

## Requirements
- Remote server: `https://unitymcptest.clauxel.com/mcp`
- Works with: Unity

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http unitymcptest-mcp https://unitymcptest.clauxel.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add unitymcptest-mcp --url https://unitymcptest.clauxel.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unitymcptest-mcp": {
            "url": "https://unitymcptest.clauxel.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unitymcptest-mcp": {
            "type": "http",
            "url": "https://unitymcptest.clauxel.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http unitymcptest-mcp https://unitymcptest.clauxel.com/mcp
```

## When to use it
- execute Unity Play Mode checks through agent tool calls
- invoke specific Unity engine methods remotely
- generate failure summaries after a failed scene run
- export machine-readable JSON receipts for test audits

## Example prompts
- Run a Unity Play Mode check on the current scene using `run_unity_playmode_check`
- Inspect the test error and summarize what broke with `summarize_unity_failure`
- Generate a test receipt with `export_unity_receipt`

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25137
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4534
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 982
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 732

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md