Hera Agent Unity MCP server

hera-agent-unity

Give your AI coding agent hands, eyes, and a checklist inside Unity.

Codex, Claude, Cursor, Copilot, AntiGravity, and other shell-capable agents can inspect your live Unity Editor, change it, run it, test it, see the result, and keep fixing until the evidence says it is done.

Start in 3 steps · What can it do? · Why Hera? · How good is it? · Examples · Commands

English · 한국어

Hera in one minute

An AI can write Unity C# without Hera, but it cannot reliably know what your live Editor looks like after the code is written.

Normally the loop looks like this:

You ask the AI
   ↓
AI writes code
   ↓
You open Unity and wait for compile
   ↓
You copy the error back to the AI
   ↓
AI fixes it
   ↓
You press Play and explain what happened
   ↓
repeat...

Hera closes that loop:

You ask the AI
   ↓
AI uses Hera
   ↓
Unity compiles, runs, tests, clicks UI, captures the result
   ↓
Hera gives the real result back to the AI
   ↓
AI fixes what failed and checks again
   ↓
verified result

A simple way to think about it:

The AI is the brain. Hera gives that brain hands to operate Unity, eyes to inspect the result, and a checklist so it does not stop while the project is still broken.

Hera does not replace Unity and it does not replace the coding agent. It connects the two so the agent can work with facts from your actual project instead of guessing from source code alone.

What problem does it solve?

Unity development has a feedback loop that lives outside the source files.

A change can look correct in code and still fail because:

• Unity did not compile it;
• the wrong Scene is open;
• a GameObject or Component is missing;
• the Inspector has a different serialized value;
• a Unity API changed in your Editor version;
• the Console contains an exception;
• Play Mode behaves differently from Edit Mode;
• a button is visually present but cannot receive input;
• a UI layout is technically valid but looks wrong;
• the AI says "done" before it has actually checked any of those things.

Hera lets the agent ask the real Editor instead.

hera-agent-unity status
hera-agent-unity console --type error
hera-agent-unity scene info
hera-agent-unity editor play --wait
hera-agent-unity test --mode PlayMode

If the selected Editor is not running, Hera can bootstrap the exact project before Connector discovery:

hera-agent-unity --project C:/Projects/Game editor launch
hera-agent-unity --project C:/Projects/Game editor restart

Shortened. The full README is on GitHub.