Skip to main content

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

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