List all running Unity Editor instances that the MCP can connect to. Returns each instance's project name, port, Unity version, and whether it's a ParrelSync clone. Use this to see which Unity projects are currently open before selecting one to work with. IMPORTANT: When multiple instances are detected, always call this first and then use unity_select_instance to choose which project to target.

Select which Unity Editor instance to work with for this session. All subsequent unity_* commands will be routed to the selected instance. You must provide the port number of the instance (get it from unity_list_instances). IMPORTANT: Call unity_list_instances first to see available instances and their ports. PARALLEL SAFETY: After selecting, include 'port: ' as a parameter in ALL subsequent unity_* tool calls to guarantee routing to this instance even when multiple agents share the same 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/).

Save the current scene.

Create a new empty scene.

Get the full hierarchy tree of all GameObjects in the active scene, including their components and children.

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

Delete a GameObject from the scene by path or name.

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}.

Set an object reference on a component property. Dedicated tool for wiring references between GameObjects, components, and assets. More powerful than set_property for ObjectReference fields — supports resolution by asset path, scene GameObject name, component type, or instance ID.

Wire multiple object references in a single call. Efficient for setting up many references at once (e.g. wiring a UI manager to all its panels, connecting enemy AI to patrol waypoints). Each entry specifies a target GameObject, property, and 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 from the project.

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). Useful for debugging.

Clear the Unity console log.

Get C# compilation errors and warnings from the Unity Editor. Uses CompilationPipeline directly — independent of the console log buffer. Not affected by console clear or Play Mode log flooding. Returns errors from the last compilation cycle. Use this instead of unity_console_log when diagnosing script compilation 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 — prefer unity_component_set_reference] Set an object reference property on a component via the prefab system. Use unity_component_set_reference instead for richer resolution options.

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 last operation in Unity Editor.

Redo the last undone operation in Unity Editor.

Get information about the current undo group.

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

List all available advanced/specialized Unity tools organized by category. These tools are not directly exposed but can be called via unity_advanced_tool. Categories include: uma, animation, prefab, physics, lighting, audio, shadergraph, amplify, terrain, particle, navmesh, ui, texture, profiler, memory, settings, input, asmdef, scriptableobject, constraint, lod, editorprefs, playerprefs, vfx, graphics, sceneview, and more.

Execute an advanced/specialized Unity tool by name. Use unity_list_advanced_tools to discover available tools and their parameters. This provides access to 200+ specialized tools for animation, prefabs, physics, shaders, terrain, particles, UI, profiling, and more.

Get project-specific context and documentation that the team has prepared for AI agents. This includes project guidelines, architecture docs, game design documents, networking rules, and any other project knowledge stored in Assets/MCP/Context/. Call this without arguments to get ALL context, or specify a category for a specific document. IMPORTANT: Call this early in your session to understand the project's conventions and architecture.