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, else Unity opens its 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 serialized component property: numbers, strings, bools, vectors, colors, enums or object references.

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.

Run C# in the Unity Editor with Unity API access. Return a small JSON result. If an error has executionCompleted=true, the code already ran; inspect its effects before retrying.

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

Assign a material to a GameObject's renderer.

Build the 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.

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 latest verified MCP Undo group, optionally by agentId. Newer MCP/native groups require force:true. Only Unity-registered changes are covered; this revert creates no Redo step. Use unity_undo for normal Undo/Redo. Reads and execute-code are not targets.

Redo the last undone operation in Unity Editor.

Show which recorded MCP actions can still be reverted, with agent, target and current Unity Undo state.

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 an existing EditorWindow to PNG (Windows PrintWindow) without requesting keyboard focus. Hidden tabs require activateTab:true; ambiguous names return id: candidates. GPU/minimized windows can refuse capture. USE ONLY ON EXPLICIT USER REQUEST; never proactively or for your own inspection. On macOS/Linux report unsupported, do not retry; use Game/Scene captures there.

Render the Scene View camera to inline PNG. Whole-pixel sizes within device limits, at most 33554432 pixels.

Render one camera to inline PNG, without Game View composition or overlay UI. Whole-pixel sizes within device limits, at most 33554432 pixels.

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.

Queue depths, agents and results. Plugin metrics: http, httpCommands (admission), completedResults (cost/evictions), historyNotifications (backlog), historyPersistence (file limits/failures). Reset on reload. serverAgentState: Node agent/identity limits, leases, evictions. Accounted bytes are not heap usage.

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.