List running Unity Editor instances (name, port, version, clone flag, pluginVersion). With multiple instances, select one with unity_select_instance next.

Select the Unity Editor instance this session targets; subsequent unity_* calls route there. Identify it by projectName (stable) or port (dynamic — can change across editor restarts). PARALLEL SAFETY: after selecting, include port on every unity_* call when multiple agents share this MCP process.

List all Unity Editor versions currently installed via Unity Hub, including their installation paths.

List Unity Editor versions available for download from Unity Hub.

Install a specific Unity Editor version. Optionally include platform modules (android, ios, webgl, linux, macos, windows-il2cpp).

Install additional platform modules to an already-installed Unity Editor version.

Get the current default installation path for Unity Editors.

Set the default installation directory for Unity Editors.

Check if the Unity Editor bridge is running and responsive. Returns editor version, project name, and connection status.

Get the current Unity Editor state: play mode, compilation status, active scene, project path.

Get information about the currently open scene(s), including name, path, dirty state, and root game objects.

Open a scene by its asset path (relative to Assets/). Refuses if any loaded scene has unsaved changes — pass saveFirst or discardUnsavedChanges.

Save the current scene. A never-saved scene requires path (saving without one would open Unity's interactive Save dialog).

Create a new empty scene (REPLACES the current one). Refuses if any loaded scene has unsaved changes — pass saveFirst or discardUnsavedChanges.

Get the hierarchy tree of all GameObjects in the active scene, including their components and children. Dense by default: per-node fields at their default value (active=true, tag=Untagged, layer=Default, origin position, Transform) are omitted — an absent field means the default.

Create a new GameObject in the scene. Can specify primitive type (Cube, Sphere, Capsule, Cylinder, Plane, Quad), parent, and initial transform.

Delete a GameObject by path or name. Refuses if its runtime mesh is shared by other objects (ProBuilder clones) — reports sharedWith; pass force:true to override.

Get detailed info about a specific GameObject: transform, components, children, active state, tags, layer.

Set the transform (position, rotation, scale) of a GameObject.

Add a component to a GameObject. Supports built-in types (Rigidbody, BoxCollider, AudioSource, Light, Camera, etc.) and custom scripts.

Remove a component from a GameObject.

Get all serialized properties of a component on a GameObject.

Set a property value on a component. Supports floats, ints, strings, bools, vectors, colors, and object references. For ObjectReference properties, pass value as: an asset path string, a scene object name string, null to clear, or an object with {assetPath}, {instanceId}, or {gameObject, componentType}.

Wire an object reference on a component property. Resolves by asset path, scene GameObject name, component type, or instance ID (richer than set_property for ObjectReference fields).

Wire multiple object references in one call (e.g. a manager to all its panels). Each entry: target GameObject, property, reference to assign.

Discover what objects can be assigned to an ObjectReference property. Returns matching scene objects and project assets filtered by the expected type. Useful before wiring references to know what's available.

List assets in the project. Can filter by path, type, and search term.

Import an external file into the Unity project as an asset.

Delete an asset — to the OS trash by default (NOT undoable via unity_undo_last). Deleting a FOLDER is recursive and refuses without recursive:true.

Create a prefab from an existing GameObject in the scene.

Instantiate a prefab into the current scene.

Create a new C# script file in the project with the given content.

Read the contents of a C# script file from the project.

Update the contents of an existing C# script file.

Execute arbitrary C# code inside the Unity Editor. The code runs in the editor context with access to all Unity APIs. Useful for one-off operations, queries, and automation. Return values are serialized to JSON.

Create a new material asset with a specified shader and properties.

Assign a material to a GameObject's renderer.

Start a build of the Unity project for a target platform.

Get recent Unity console log messages (errors, warnings, info).

Clear the Unity console log.

Get C# compilation errors/warnings via CompilationPipeline — independent of the console buffer (survives console clear and log flooding). Prefer this over unity_console_log for compile issues.

Control Unity Editor play mode: enter play, pause, or stop.

Execute a Unity Editor menu command by its path (e.g. 'File/Save', 'GameObject/3D Object/Cube', 'Window/General/Console').

Get project information: name, path, Unity version, render pipeline, packages, build settings.

Get detailed prefab information: overrides, variant status, added/removed components. Works on both prefab assets and scene instances.

[LEGACY] Set an object reference on a component. Prefer unity_component_set_reference (richer resolution).

Duplicate a GameObject with all its children and components.

Set a GameObject active or inactive.

Move a GameObject under a new parent in the hierarchy.

Get the currently selected GameObjects in the Unity Editor.

Set the editor selection to specific GameObjects.

Control the Scene View camera: frame a GameObject, set pivot/rotation/zoom, toggle orthographic.

Find all GameObjects in the scene that have a specific component type (e.g. 'Rigidbody', 'Camera', 'Light', 'AudioSource', or custom scripts).

Find all GameObjects in the scene that have a specific component type. Returns their paths and instance IDs.

Find all GameObjects with a specific tag.

Find all GameObjects on a specific layer.

Find all GameObjects whose name contains a pattern. Supports substring matching or regex.

Search for assets in the project by name, type, and folder. Uses Unity's AssetDatabase search.

Find all missing/broken object references and missing scripts in the scene. Essential for cleanup and debugging.

Get comprehensive scene statistics: total objects, vertices, triangles, lights, cameras, colliders, and top component types.

Undo the single most recent step on Unity's global undo stack (Ctrl+Z). To revert a specific MCP action, prefer unity_undo_last.

Revert the most recent undoable MCP action as a whole (create/edit/boolean, not one internal step — each write runs in its own named undo group). With agentId, targets that agent's most recent action. Unity's undo is LINEAR: reverting an action also reverts anything newer stacked on it, so this refuses to cascade and lists what would be affected unless force:true. (execute-code and reads are never targets.)

Redo the last undone operation in Unity Editor.

List recent MCP actions with undo state: per-agent attribution, whether each is still undoable, target, and the current undo group. Use it to decide what unity_undo_last reverts or to pick an agentId.

Capture a screenshot of the Game View. The screenshot is saved on the next frame render.

Capture a screenshot of the Scene View camera. Returns immediately with the saved file path.

Capture a specific Editor window (Inspector, Project, Console, custom) to a PNG file via Win32 PrintWindow — works even when occluded, no focus steal. USE ONLY ON EXPLICIT USER REQUEST — never proactively or for your own inspection. WINDOWS EDITOR ONLY: on macOS/Linux it returns { success:false, platform } — do not retry, tell the user it's unavailable there. For game/scene views use unity_screenshot_game / unity_screenshot_scene (cross-platform).

Capture the current Scene View as an inline image. Returns base64 PNG that Claude can see directly. Use to visually inspect the scene layout.

Capture the Game View camera as an inline image. Returns base64 PNG that Claude can see directly. Use to see what the player sees.

List all installed Unity packages with their name, version, source, and status.

Add/install a Unity package by identifier (e.g. 'com.unity.cinemachine' or 'com.unity.cinemachine@3.0.0').

Remove/uninstall a Unity package by name.

Search for Unity packages in the registry.

Get detailed info about an installed package including versions and dependencies.

Get the current state of the multi-agent request queue: total queued requests, active agents, per-agent queue depths, and completed cache size. Useful for monitoring when multiple agents are working on the same Unity project.

List all active agent sessions connected to the AB Unity MCP bridge. Shows each agent's ID, connection time, last activity, current action, total actions count, queued/completed request counts, and average response time.

Get the action log for a specific agent, showing the last 100 actions with timestamps.

Discover advanced Unity tools (execute them via unity_advanced_tool) without loading full schemas: search=keywords → matching tools; category=name → its tools with parameter names; tool=name → that tool's full parameter schema; no args → all category names with counts (e.g. animation, terrain, shadergraph, probuilder, uma, physics, lighting, ui, …).

Execute an advanced Unity tool by name (269 cached + plugin lazy-loaded; discover names via unity_list_advanced_tools search=/category=, parameters via tool=).

Get the project docs/guidelines the team prepared for AI agents (from Assets/MCP/Context/). No args = all context; pass a category for one document. Call early in a session.