IvanMurzak/Unity-MCP

Asset Data Reader retrieves serializable fields and properties from a Unity asset file. Use it when an agent needs to inspect a Material, ScriptableObject, Prefab, or other asset in a Unity project.

Asset Finder queries the Unity asset database using filters for name, type, label, asset bundle, area, and glob patterns. Use it to locate assets in a Unity project before modifying or referencing them.

Asset Modification edits a Unity asset file in place using full content replacement, path-scoped patches, or JSON Merge Patch. Use it after assets-get-data to inspect structure; modifications to Packages/ are not allowed.

Assets Copy copies assets at given paths and stores them at new paths, refreshing the AssetDatabase afterwards. Use it after locating source assets with assets-find.

Assets Create Folder creates a new folder under a specified parent inside Unity's Assets directory, validates paths, refreshes the AssetDatabase, and returns created folder GUIDs. Use it when an AI agent needs to organize scripts or assets in a Unity project.

Assets Delete removes assets at the given project paths in Unity and refreshes the AssetDatabase. Use it after finding assets with assets-find to delete files from disk.

Assets Move moves or renames assets at given Unity project paths and refreshes the AssetDatabase. Use it to relocate or rename assets after finding them with assets-find.

Assets Prefab Open opens the prefab edit stage for a Unity prefab instance or prefab asset GameObject. Modifications inside the stage propagate to all instances; pair it with assets-prefab-close when done.

Assets Refresh triggers Unity's AssetDatabase.Refresh to import new or updated assets and recompile scripts when .cs files change. Use it after files are added or modified outside the Unity API, or to request processing-mode feedback while Unity compiles.

Build CLI compiles the unity-mcp-cli TypeScript project and links it globally for terminal use. Use it after changes or first-time setup to make the CLI command available anywhere.

Close Prefab closes the currently opened Unity prefab edit stage, optionally saving changes back to the prefab asset before exiting.

Console Clear Logs clears the MCP log cache and the Unity Editor Console window, so subsequent log reads only show new entries. Use it before running a specific action to isolate errors or messages from that action.

Console Get Logs retrieves logs from the Unity Editor via the MCP plugin's LogCollector, optionally filtered by log type or time window. Use it to debug and monitor Editor activity.

Create Material Asset creates a new Unity material asset at a given Assets/-rooted .mat path, using a specified shader and creating intermediate folders if needed. Use it to programmatically add materials to a Unity project, such as when an AI agent needs to generate assets.

Editor Application Set State starts, stops, or pauses Unity Editor play mode. Use it to control the editor state after checking the current state with editor-application-get-state and when there are no compilation errors.

Editor Application State reports the current play mode, pause, compilation, and update flags from UnityEditor.EditorApplication. Use it to check the Unity Editor's runtime condition before running other tools.

Editor Selection Get retrieves the current selection in the Unity Editor, including active object, active transform, selected GameObjects, transforms, instance IDs, and asset GUIDs. Use it when an agent needs to know what is currently selected in Unity before acting on it.

Find Built-in Assets searches the built-in assets of the Unity Editor (Resources/unity_builtin_extra), filtering by name and type. Use it when an agent needs to reference built-in materials, textures, or other assets without requiring a GUID.

List All Shaders enumerates all shaders available in a Unity project's assets and packages, returning their names sorted alphabetically. Use it to discover a valid shaderName for the assets-material-create tool.

PR Review Fix reviews unresolved comments on the GitHub pull request associated with the current branch, validates each comment, and fixes legitimate issues. Use it when you need to automatically triage and resolve PR review feedback.

Prefab Creator creates a Unity prefab or prefab variant at a project asset path from a scene GameObject or an existing prefab asset. Use it to save scene objects as reusable prefabs or create prefab variants, with intermediate folders created automatically.

Prefab Instantiate instantiates a prefab into the currently active Unity scene at an optional position, rotation, and scale, optionally parented under a scene GameObject path. Use it after finding a prefab asset with assets-find to place objects in a scene during automation.

Prefab Save saves the currently opened prefab edit stage back to its prefab asset without exiting the stage. Use it after opening a prefab with assets-prefab-open to persist edits in Unity Editor.

Shader Data Inspector retrieves detailed information from a Unity shader asset, including properties, subshaders, passes, and compilation messages. Use it after locating shaders with assets-find or assets-shader-list-all to inspect shader internals or debug compilation errors.

Unity Editor Selection Set assigns the provided objects to the active selection in the Unity Editor. Use it after inspecting the current selection with editor-selection-get to change which objects are active in Hierarchy and Inspector.