unity-mcp-server

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: <number>' as a parameter in ALL subsequent unity_* tool calls to guarantee routing to this instance even when multiple agents share the same MCP process.

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

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.

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

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

List Unity Editor versions available for download from Unity Hub.

Set the default installation directory for Unity Editors.

Open a scene by its asset path (relative to Assets/).

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

Get the current default installation path for Unity Editors.

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

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

Save the current scene.

Delete a GameObject from the scene by path or name.

Remove a component from a GameObject.

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.

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

Get all serialized properties of a component on a GameObject.

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.

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.

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.

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

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

Delete an asset from the project.

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

Instantiate a prefab into the current scene.

Create a prefab from an existing GameObject in the scene.

Update the contents of an existing C# script file.

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

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

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.

Clear the Unity console log.

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

Assign a material to a GameObject's renderer.

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.

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

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

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

Duplicate a GameObject with all its children and components.

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

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

Get the currently selected GameObjects in the Unity Editor.

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

Move a GameObject under a new parent in the hierarchy.

Set a GameObject active or inactive.

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

Find all GameObjects on a specific layer.

Set the editor selection to specific GameObjects.

Find all GameObjects with a specific tag.

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

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

Undo the last operation in Unity Editor.

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

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

Redo the last undone operation in Unity Editor.

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.

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

Get information about the current undo group.

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

Remove/uninstall a Unity package by name.

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

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

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

Capture a screenshot of a specific Editor window (Inspector, Project, Console, custom editor windows) to a PNG file, via the Win32 PrintWindow API — occlusion-proof (grabs the real editor UI even when the window is hidden behind others, without raising it or stealing focus). USE ONLY ON EXPLICIT USER REQUEST: call this tool ONLY when the user specifically asks to take a screenshot / screen capture of an editor window. Do NOT call it proactively, to visually inspect the editor for your own reasoning, or as an implicit step toward another task — if you merely think a capture might help, do not call it unless the user asked. WINDOWS EDITOR ONLY: it relies on a Win32 API with no macOS/Linux equivalent. On macOS/Linux it returns { success:false, error, platform }; when that happens (or if you already know the user is not on the Windows editor), do NOT retry — tell the user this feature is unavailable on their operating system. For the game or scene view use unity_screenshot_game / unity_screenshot_scene instead (camera-based, cross-platform).

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

Search for Unity packages in the registry.

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

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.

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.

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

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.