Tool reference

Auto-generated from the Python tool registry. Do not hand-edit outside <!-- examples:start --><!-- examples:end --> blocks — the generator (tools/generate_docs_reference.py) will overwrite them.

Every tool MCP for Unity exposes, generated directly from the Python @mcp_for_unity_tool registry under Server/src/services/tools/.

animation   (1 tool)

Animator control & AnimationClip creation

• manage_animation — Manage Unity animation: Animator control and AnimationClip creation.

core   (30 tools)

Essential scene, script, asset & editor tools (always on by default)

• apply_text_edits — Apply small text edits to a C# script identified by URI.
• batch_execute — Executes multiple MCP commands in a single batch for dramatically better performance.
• create_script — Create a new C# script at the given project path.
• debug_request_context — Return the current FastMCP request context details (client_id, session_id, and meta dump).
• delete_script — Delete a C# script by URI or Assets-relative path.
• execute_custom_tool — Execute a project-scoped custom tool registered by Unity.
• execute_menu_item — Execute a Unity menu item by path.
• find_gameobjects — Search for GameObjects in the scene by name, tag, layer, component type, or path.
• find_in_file — Searches a file with a regex pattern and returns line numbers and excerpts.
• get_sha — Get SHA256 and basic metadata for a Unity C# script without returning file contents.
• manage_asset — Performs asset operations (import, create, modify, delete, etc.) in Unity.
• manage_build — Manage Unity player builds — trigger builds, switch platforms, configure settings, manage build scenes and profiles, run batch builds across platforms.
• manage_camera — Manage cameras (Unity Camera + Cinemachine).
• manage_components — Add, remove, or set properties on components attached to GameObjects.
• manage_editor — Controls and queries the Unity editor's state and settings.
• manage_gameobject — Performs CRUD operations on GameObjects.
• manage_graphics — Manage rendering graphics: volumes, post-processing, light baking, rendering stats, pipeline settings, and URP renderer features.
• manage_material — Manages Unity materials (set properties, colors, shaders, etc).
• manage_packages — Manage Unity packages: query, install, remove, embed, and configure registries.
• manage_physics — Manage physics settings, collision matrix, materials, joints, queries, and validation.
• manage_prefabs — Manages Unity Prefab assets.
• manage_scene — Performs CRUD operations on Unity scenes.
• manage_script — Compatibility router for legacy script operations.
• manage_script_capabilities — Get manage_script capabilities (supported ops, limits, and guards).
• manage_tools — Manage which tool groups are visible in this session.
• read_console — Gets messages from or clears the Unity Editor console.
• refresh_unity — Request a Unity asset database refresh and optionally a script compilation.
• script_apply_edits — Structured C# edits (methods/classes) with safer boundaries - prefer this over raw text.
• set_active_instance — Set the active Unity instance for this client/session.
• validate_script — Validate a C# script and return diagnostics.

docs   (2 tools)

Unity API reflection and documentation lookup

• unity_docs — Fetch official Unity documentation from docs.unity3d.com.
• unity_reflect — Inspect Unity's live C# API via reflection.

probuilder   (1 tool)

ProBuilder 3D modeling – requires com.unity.probuilder package

• manage_probuilder — Manage ProBuilder meshes for in-editor 3D modeling.

profiling   (1 tool)

Unity Profiler session control, counters, memory snapshots & Frame Debugger

• manage_profiler — Unity Profiler session control, counter reads, memory snapshots, and Frame Debugger.

scripting_ext   (2 tools)

ScriptableObject management

• execute_code — Execute arbitrary C# code inside the Unity Editor.
• manage_scriptable_object — Creates and modifies ScriptableObject assets using Unity SerializedObject property paths.

testing   (2 tools)

Test runner & async test jobs

• get_test_job — Polls an async Unity test job by job_id.
• run_tests — Starts a Unity test run asynchronously and returns a job_id immediately.

ui   (1 tool)

UI Toolkit (UXML, USS, UIDocument)

• manage_ui — Manages Unity UI Toolkit elements (UXML documents, USS stylesheets, UIDocument components).

vfx   (3 tools)

Visual effects – VFX Graph, shaders, procedural textures

• manage_shader — Manages shader scripts in Unity (create, read, update, delete).
• manage_texture — Procedural texture generation for Unity.
• manage_vfx — Manage Unity VFX components (ParticleSystem, VisualEffect, LineRenderer, TrailRenderer).