chore: import upstream snapshot with attribution

website/docs/reference/tools/core/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "core",
+  "link": {
+    "type": "doc",
+    "id": "reference/tools/core/index"
+  },
+  "collapsed": true
+}

website/docs/reference/tools/core/apply_text_edits.md

@@ -0,0 +1,47 @@
+---
+title: apply_text_edits
+sidebar_label: apply_text_edits
+description: "Apply small text edits to a C# script identified by URI."
+---
+
+# `apply_text_edits`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Apply small text edits to a C# script identified by URI.
+    IMPORTANT: This tool replaces EXACT character positions. Always verify content at target lines/columns BEFORE editing!
+    RECOMMENDED WORKFLOW:
+        1. First call resources/read with start_line/line_count to verify exact content
+        2. Count columns carefully (or use find_in_file to locate patterns)
+        3. Apply your edit with precise coordinates
+        4. Consider script_apply_edits with anchors for safer pattern-based replacements
+    Notes:
+        - For method/class operations, use script_apply_edits (safer, structured edits)
+        - For pattern-based replacements, consider anchor operations in script_apply_edits
+        - Lines, columns are 1-indexed
+        - Tabs count as 1 column
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `uri` | `str` | yes | URI of the script to edit under Assets/ directory, mcpforunity://path/Assets/... or file://... or Assets/... |
+| `edits` | `list[dict[str, Any]]` | yes | List of edits to apply to the script, i.e. a list of {startLine,startCol,endLine,endCol,newText} (1-indexed!) |
+| `precondition_sha256` | `str \| None` | — | Optional SHA256 of the script to edit, used to prevent concurrent edits |
+| `strict` | `bool \| None` | — | Optional strict flag, used to enforce strict mode |
+| `options` | `dict[str, Any] \| None` | — | Optional options, used to pass additional options to the script editor |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/batch_execute.md

@@ -0,0 +1,100 @@
+---
+title: batch_execute
+sidebar_label: batch_execute
+description: "Executes multiple MCP commands in a single batch for dramatically better performance."
+---
+
+# `batch_execute`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.batch_execute`
+
+## Description
+
+Executes multiple MCP commands in a single batch for dramatically better performance. STRONGLY RECOMMENDED when creating/modifying multiple objects, adding components to multiple targets, or performing any repetitive operations. Reduces latency and token costs by 10-100x compared to sequential tool calls. The max commands per batch is configurable in the Unity MCP Tools window (default 25, hard max 100). Example: creating 5 cubes → use 1 batch_execute with 5 create commands instead of 5 separate calls.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `commands` | `list[dict[str, Any]]` | yes | List of commands with 'tool' and 'params' keys. |
+| `parallel` | `bool \| None` | — | Attempt to run read-only commands in parallel |
+| `fail_fast` | `bool \| None` | — | Stop processing after the first failure |
+| `max_parallelism` | `int \| None` | — | Hint for the maximum number of parallel workers |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+### Why batch?
+
+A loop of 10 individual `manage_gameobject` calls pays 10 round trips to Unity. `batch_execute` pays one. For multi-object setup, batches are routinely **10–100× faster**. Use them whenever the next call doesn't need the previous call's return value.
+
+### Spawn three colored cubes in one round trip
+
+> Create a red, blue, and yellow cube at x = -1, 0, 1.
+
+```json
+{
+  "commands": [
+    { "tool": "manage_gameobject", "params": {
+        "action": "create", "name": "RedCube",
+        "primitive_type": "Cube", "position": [-1, 0, 0]
+    }},
+    { "tool": "manage_gameobject", "params": {
+        "action": "create", "name": "BlueCube",
+        "primitive_type": "Cube", "position": [0, 0, 0]
+    }},
+    { "tool": "manage_gameobject", "params": {
+        "action": "create", "name": "YellowCube",
+        "primitive_type": "Cube", "position": [1, 0, 0]
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "create", "material_path": "Materials/Red.mat",
+        "shader": "Standard", "properties": { "_Color": [1, 0, 0, 1] }
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "create", "material_path": "Materials/Blue.mat",
+        "shader": "Standard", "properties": { "_Color": [0, 0, 1, 1] }
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "create", "material_path": "Materials/Yellow.mat",
+        "shader": "Standard", "properties": { "_Color": [1, 1, 0, 1] }
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "assign_material_to_renderer", "target": "RedCube",
+        "search_method": "by_name", "material_path": "Materials/Red.mat"
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "assign_material_to_renderer", "target": "BlueCube",
+        "search_method": "by_name", "material_path": "Materials/Blue.mat"
+    }},
+    { "tool": "manage_material", "params": {
+        "action": "assign_material_to_renderer", "target": "YellowCube",
+        "search_method": "by_name", "material_path": "Materials/Yellow.mat"
+    }}
+  ]
+}
+```
+
+### Mix tools freely
+
+A batch can mix any tools, as long as ordering inside the batch doesn't depend on a previous call's *return value*. If you need the response of step N to feed step N+1, split into two batches.
+
+### Stop on first failure vs continue
+
+Set `fail_fast: true` (default) to abort the rest on the first failed step. Pass `fail_fast: false` to attempt every operation and collect per-step results, useful for "best-effort cleanup" patterns.
+
+### Parallel reads
+
+Pass `parallel: true` to let the server run **read-only** commands concurrently. Mutating ops still serialize for safety. Tune with `max_parallelism`.
+
+### Limits
+
+Batch size is configurable in the Unity MCP Tools window (default 25, hard max 100). Past the limit, split into multiple batches — round-trip cost is still amortized.
+<!-- examples:end -->
+

website/docs/reference/tools/core/create_script.md

@@ -0,0 +1,35 @@
+---
+title: create_script
+sidebar_label: create_script
+description: "Create a new C# script at the given project path."
+---
+
+# `create_script`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Create a new C# script at the given project path.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `path` | `str` | yes | Path under Assets/ to create the script at, e.g., 'Assets/Scripts/My.cs' |
+| `contents` | `str` | yes | Contents of the script to create (plain text C# code). The server handles Base64 encoding. |
+| `script_type` | `str \| None` | — | Script type (e.g., 'C#') |
+| `namespace` | `str \| None` | — | Namespace for the script |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/debug_request_context.md

@@ -0,0 +1,30 @@
+---
+title: debug_request_context
+sidebar_label: debug_request_context
+description: "Return the current FastMCP request context details (client_id, session_id, and meta dump)."
+---
+
+# `debug_request_context`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.debug_request_context`
+
+## Description
+
+Return the current FastMCP request context details (client_id, session_id, and meta dump).
+
+## Parameters
+
+_No parameters._
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/delete_script.md

@@ -0,0 +1,32 @@
+---
+title: delete_script
+sidebar_label: delete_script
+description: "Delete a C# script by URI or Assets-relative path."
+---
+
+# `delete_script`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Delete a C# script by URI or Assets-relative path.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `uri` | `str` | yes | URI of the script to delete under Assets/ directory, mcpforunity://path/Assets/... or file://... or Assets/... |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/execute_custom_tool.md

@@ -0,0 +1,33 @@
+---
+title: execute_custom_tool
+sidebar_label: execute_custom_tool
+description: "Execute a project-scoped custom tool registered by Unity."
+---
+
+# `execute_custom_tool`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.execute_custom_tool`
+
+## Description
+
+Execute a project-scoped custom tool registered by Unity.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `tool_name` | `str` | yes |  |
+| `parameters` | `dict[str, Any] \| None` | — |  |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/execute_menu_item.md

@@ -0,0 +1,32 @@
+---
+title: execute_menu_item
+sidebar_label: execute_menu_item
+description: "Execute a Unity menu item by path."
+---
+
+# `execute_menu_item`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.execute_menu_item`
+
+## Description
+
+Execute a Unity menu item by path.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `menu_path` | `str \| None` | — | Menu path for 'execute' or 'exists' (e.g., 'File/Save Project') |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/find_gameobjects.md

@@ -0,0 +1,36 @@
+---
+title: find_gameobjects
+sidebar_label: find_gameobjects
+description: "Search for GameObjects in the scene by name, tag, layer, component type, or path."
+---
+
+# `find_gameobjects`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.find_gameobjects`
+
+## Description
+
+Search for GameObjects in the scene by name, tag, layer, component type, or path. Returns instance IDs only (paginated). Then use mcpforunity://scene/gameobject/{id} resource for full data, or mcpforunity://scene/gameobject/{id}/components for component details. For CRUD operations (create/modify/delete), use manage_gameobject instead.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `search_term` | `str` | yes |  |
+| `search_method` | `Literal['by_name', 'by_tag', 'by_layer', 'by_component', 'by_path', 'by_id']` | — |  |
+| `include_inactive` | `bool \| str \| None` | — |  |
+| `page_size` | `int \| str \| None` | — |  |
+| `cursor` | `int \| str \| None` | — |  |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/find_in_file.md

@@ -0,0 +1,36 @@
+---
+title: find_in_file
+sidebar_label: find_in_file
+description: "Searches a file with a regex pattern and returns line numbers and excerpts."
+---
+
+# `find_in_file`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.find_in_file`
+
+## Description
+
+Searches a file with a regex pattern and returns line numbers and excerpts.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `uri` | `str` | yes | The resource URI to search under Assets/ or file path form supported by read_resource |
+| `pattern` | `str` | yes | The regex pattern to search for |
+| `project_root` | `str \| None` | — | Optional project root path |
+| `max_results` | `int` | — | Cap results to avoid huge payloads |
+| `ignore_case` | `bool \| str \| None` | — | Case insensitive search |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/get_sha.md

@@ -0,0 +1,32 @@
+---
+title: get_sha
+sidebar_label: get_sha
+description: "Get SHA256 and basic metadata for a Unity C# script without returning file contents."
+---
+
+# `get_sha`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Get SHA256 and basic metadata for a Unity C# script without returning file contents. Requires uri (script path under Assets/ or mcpforunity://path/Assets/... or file://...).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `uri` | `str` | yes | URI of the script to edit under Assets/ directory, mcpforunity://path/Assets/... or file://... or Assets/... |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/index.md

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

website/docs/reference/tools/core/manage_asset.md

@@ -0,0 +1,44 @@
+---
+title: manage_asset
+sidebar_label: manage_asset
+description: "Performs asset operations (import, create, modify, delete, etc.) in Unity."
+---
+
+# `manage_asset`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_asset`
+
+## Description
+
+Performs asset operations (import, create, modify, delete, etc.) in Unity.
+
+Tip (payload safety): for `action="search"`, prefer paging (`page_size`, `page_number`) and keep `generate_preview=false` (previews can add large base64 blobs).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['import', 'create', 'modify', 'delete', 'duplicate', 'move', 'rename', 'search', 'get_info', 'create_folder', 'get_components']` | yes | Perform CRUD operations on assets. |
+| `path` | `str` | yes | Asset path (e.g., 'Materials/MyMaterial.mat') or search scope (e.g., 'Assets'). |
+| `asset_type` | `str \| None` | — | Asset type (e.g., 'Material', 'Folder') - required for 'create'. Note: For ScriptableObjects, use manage_scriptable_object. |
+| `properties` | `dict[str, Any] \| str \| None` | — | Dictionary of properties for 'create'/'modify'. Keys are property names, values are property values. |
+| `destination` | `str \| None` | — | Target path for 'duplicate'/'move'. |
+| `generate_preview` | `bool` | — | Generate a preview/thumbnail for the asset when supported. Warning: previews may include large base64 payloads; keep false unless needed. |
+| `search_pattern` | `str \| None` | — | Search pattern (e.g., '*.prefab' or AssetDatabase filters like 't:MonoScript'). Recommended: put queries like 't:MonoScript' here and set path='Assets'. |
+| `filter_type` | `str \| None` | — | Filter type for search |
+| `filter_date_after` | `str \| None` | — | Date after which to filter |
+| `page_size` | `int \| float \| str \| None` | — | Page size for pagination. Recommended: 25 (smaller for LLM-friendly responses). |
+| `page_number` | `int \| float \| str \| None` | — | Page number for pagination (1-based). |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_build.md

@@ -0,0 +1,47 @@
+---
+title: manage_build
+sidebar_label: manage_build
+description: "Manage Unity player builds — trigger builds, switch platforms, configure settings, manage build scenes and profiles, run batch builds across platforms."
+---
+
+# `manage_build`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_build`
+
+## Description
+
+Manage Unity player builds — trigger builds, switch platforms, configure settings, manage build scenes and profiles, run batch builds across platforms. Actions: build, status, platform, settings, scenes, profiles, batch, cancel.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `str` | yes | Action: build, status, platform, settings, scenes, profiles, batch, cancel |
+| `target` | `str \| None` | — | Build target: windows64, osx, linux64, android, ios, webgl, uwp, tvos, visionos |
+| `output_path` | `str \| None` | — | Output path for the build |
+| `scenes` | `str \| None` | — | JSON array of scene paths, or comma-separated paths |
+| `development` | `str \| None` | — | Development build (true/false) |
+| `options` | `str \| None` | — | JSON array of BuildOptions: clean_build, auto_run, deep_profiling, compress_lz4, strict_mode, detailed_report |
+| `subtarget` | `str \| None` | — | Build subtarget: player or server |
+| `scripting_backend` | `str \| None` | — | Scripting backend: mono or il2cpp (persistent change) |
+| `profile` | `str \| None` | — | Build Profile asset path (Unity 6+ only) |
+| `property` | `str \| None` | — | Settings property: product_name, company_name, version, bundle_id, scripting_backend, defines, architecture |
+| `value` | `str \| None` | — | Value to set for the property (omit to read) |
+| `activate` | `str \| None` | — | Activate a build profile (true/false) |
+| `targets` | `str \| None` | — | JSON array of targets for batch build |
+| `profiles` | `str \| None` | — | JSON array of profile paths for batch build (Unity 6+) |
+| `output_dir` | `str \| None` | — | Base output directory for batch builds |
+| `job_id` | `str \| None` | — | Job ID for status/cancel |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_camera.md

@@ -0,0 +1,80 @@
+---
+title: manage_camera
+sidebar_label: manage_camera
+description: "Manage cameras (Unity Camera + Cinemachine)."
+---
+
+# `manage_camera`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_camera`
+
+## Description
+
+Manage cameras (Unity Camera + Cinemachine). Works without Cinemachine using basic Camera; unlocks presets, pipelines, and blending when Cinemachine is installed. Use ping to check Cinemachine availability.
+
+SETUP:
+- ping: Check if Cinemachine is available
+- ensure_brain: Ensure CinemachineBrain exists on main camera
+- get_brain_status: Get Brain state (active camera, blend, etc.)
+
+CAMERA CREATION:
+- create_camera: Create camera with preset (third_person, freelook, follow, dolly, static, top_down, side_scroller). Falls back to basic Camera without Cinemachine.
+
+CAMERA CONFIGURATION:
+- set_target: Set Follow and/or LookAt targets on a camera
+- set_priority: Set camera priority for Brain selection
+- set_lens: Configure lens (fieldOfView, nearClipPlane, farClipPlane, orthographicSize, dutch)
+- set_body: Configure Body component (bodyType to swap, plus component properties)
+- set_aim: Configure Aim component (aimType to swap, plus component properties)
+- set_noise: Configure Noise component (amplitudeGain, frequencyGain)
+
+EXTENSIONS:
+- add_extension: Add extension (extensionType: CinemachineConfiner2D, CinemachineDeoccluder, CinemachineImpulseListener, CinemachineFollowZoom, CinemachineRecomposer, etc.)
+- remove_extension: Remove extension by type
+
+CAMERA CONTROL:
+- set_blend: Configure default blend (style: Cut/EaseInOut/Linear/etc., duration)
+- force_camera: Override Brain to use specific camera
+- release_override: Release camera override
+- list_cameras: List all cameras with status
+
+CAPTURE:
+- screenshot: Capture a screenshot. By default (no camera specified) uses ScreenCapture API, which captures all render layers including Screen Space - Overlay UI canvases. Specifying a camera uses direct camera rendering, which EXCLUDES Screen Space - Overlay canvases (use only when you need a specific viewpoint without UI). Supports include_image=true for inline base64 PNG, batch='surround' for 6-angle contact sheet, batch='orbit' for configurable grid, view_target/view_position for positioned capture, and capture_source='scene_view' to capture the active Unity Scene View viewport.
+- screenshot_multiview: Shorthand for screenshot with batch='surround' and include_image=true.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `str` | yes | The camera action to perform. |
+| `target` | `str \| None` | — | Target camera (name, path, or instance ID). |
+| `search_method` | `Literal['by_id', 'by_name', 'by_path'] \| None` | — | How to find target. |
+| `properties` | `dict[str, Any] \| str \| None` | — | Action-specific parameters (dict or JSON string). |
+| `screenshot_file_name` | `str \| None` | — | Screenshot file name (optional). Defaults to timestamp. |
+| `screenshot_super_size` | `int \| str \| None` | — | Screenshot supersize multiplier (integer >= 1). |
+| `camera` | `str \| None` | — | Camera to capture from (name, path, or instance ID). Omit to use ScreenCapture API (captures all layers including Screen Space Overlay UI). Specify only when you need a particular camera viewpoint; note that Screen Space - Overlay canvases will NOT appear in camera-rendered captures. |
+| `include_image` | `bool \| str \| None` | — | If true, return screenshot as inline base64 PNG. Default false. |
+| `max_resolution` | `int \| str \| None` | — | Max resolution (longest edge px) for inline image. Default 640. |
+| `capture_source` | `Literal['game_view', 'scene_view'] \| None` | — | Screenshot source. 'game_view' (default) captures the game/camera path; 'scene_view' captures the active Unity Scene View viewport. |
+| `batch` | `str \| None` | — | Batch capture mode: 'surround' (6 angles) or 'orbit' (configurable grid). |
+| `view_target` | `str \| int \| list[float] \| None` | — | Target to focus on. GameObject name/path/ID or [x,y,z]. For game_view: aims camera at target. For scene_view: frames the Scene View on the target. |
+| `view_position` | `list[float] \| str \| None` | — | World position [x,y,z] to place camera for positioned capture. |
+| `view_rotation` | `list[float] \| str \| None` | — | Euler rotation [x,y,z] for camera. Overrides view_target if both provided. |
+| `orbit_angles` | `int \| str \| None` | — | Number of azimuth samples for batch='orbit' (default 8, max 36). |
+| `orbit_elevations` | `list[float] \| str \| None` | — | Elevation angles in degrees for batch='orbit' (default [0, 30, -15]). |
+| `orbit_distance` | `float \| str \| None` | — | Camera distance from target for batch='orbit' (default auto). |
+| `orbit_fov` | `float \| str \| None` | — | Camera FOV in degrees for batch='orbit' (default 60). |
+| `output_folder` | `str \| None` | — | Optional folder for screenshot output. Project-relative (e.g. 'Assets/Screenshots' or 'Captures') or absolute path inside the project. Overrides the user's Editor preference. If omitted, falls back to the Editor preference, then to the built-in default (Assets/Screenshots). |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_components.md

@@ -0,0 +1,39 @@
+---
+title: manage_components
+sidebar_label: manage_components
+description: "Add, remove, or set properties on components attached to GameObjects."
+---
+
+# `manage_components`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_components`
+
+## Description
+
+Add, remove, or set properties on components attached to GameObjects. Actions: add, remove, set_property. Requires target (instance ID or name) and component_type. For READING component data, use the mcpforunity://scene/gameobject/{id}/components resource or mcpforunity://scene/gameobject/{id}/component/{name} for a single component. For creating/deleting GameObjects themselves, use manage_gameobject instead.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['add', 'remove', 'set_property']` | yes | Action to perform: add (add component), remove (remove component), set_property (set component property) |
+| `target` | `str \| int` | yes | Target GameObject - instance ID (preferred) or name/path |
+| `component_type` | `str` | yes | Component type name (e.g., 'Rigidbody', 'BoxCollider', 'MyScript') |
+| `search_method` | `Literal['by_id', 'by_name', 'by_path'] \| None` | — | How to find the target GameObject |
+| `property` | `str \| None` | — | Property name to set (for set_property action) |
+| `value` | `str \| int \| float \| bool \| dict[Any] \| list[Any] \| None` | — | Value to set (for set_property action). For object references: instance ID (int), asset path (string), or {"guid": "..."} / {"path": "..."}. For Sprite sub-assets: {"guid": "...", "spriteName": "<name>"} or {"guid": "...", "fileID": <id>}. Single-sprite textures auto-resolve. |
+| `properties` | `dict[str, Any] \| str \| None` | — | Dictionary of property names to values. Example: {"mass": 5.0, "useGravity": false} |
+| `component_index` | `int \| None` | — | Zero-based index to select which component when multiple of the same type exist. Use the components resource to discover indices. If omitted, targets the first instance. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_editor.md

@@ -0,0 +1,35 @@
+---
+title: manage_editor
+sidebar_label: manage_editor
+description: "Controls and queries the Unity editor's state and settings."
+---
+
+# `manage_editor`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_editor`
+
+## Description
+
+Controls and queries the Unity editor's state and settings. Read-only actions: telemetry_status, telemetry_ping. Modifying actions: play, pause, stop, set_active_tool, add_tag, remove_tag, add_layer, remove_layer, deploy_package, restore_package, undo, redo. For prefab editing (open/save/close prefab stage), use manage_prefabs. deploy_package copies the configured MCPForUnity source folder into the project's installed package location (triggers recompile, no confirmation dialog). restore_package reverts to the pre-deployment backup. undo/redo perform Unity editor undo/redo and return the affected group name.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['telemetry_status', 'telemetry_ping', 'play', 'pause', 'stop', 'set_active_tool', 'add_tag', 'remove_tag', 'add_layer', 'remove_layer', 'deploy_package', 'restore_package', 'undo', 'redo']` | yes | Get and update the Unity Editor state. deploy_package copies the configured MCPForUnity source into the project's package location (triggers recompile). restore_package reverts the last deployment from backup. undo/redo perform editor undo/redo. For prefab editing (open/save/close prefab stage), use manage_prefabs. |
+| `tool_name` | `str \| None` | — | Tool name when setting active tool |
+| `tag_name` | `str \| None` | — | Tag name when adding and removing tags |
+| `layer_name` | `str \| None` | — | Layer name when adding and removing layers |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_gameobject.md

@@ -0,0 +1,126 @@
+---
+title: manage_gameobject
+sidebar_label: manage_gameobject
+description: "Performs CRUD operations on GameObjects."
+---
+
+# `manage_gameobject`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_gameobject`
+
+## Description
+
+Performs CRUD operations on GameObjects. Actions: create, modify, delete, duplicate, move_relative, look_at. NOT for searching — use the find_gameobjects tool to search by name/tag/layer/component/path. NOT for component management — use the manage_components tool (add/remove/set_property) or mcpforunity://scene/gameobject/{id}/components resource (read).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['create', 'modify', 'delete', 'duplicate', 'move_relative', 'look_at'] \| None` | — | Action to perform on GameObject. |
+| `target` | `str \| None` | — | GameObject identifier by name, path, or instance ID for modify/delete/duplicate actions |
+| `search_method` | `Literal['by_id', 'by_name', 'by_path', 'by_tag', 'by_layer', 'by_component'] \| None` | — | How to resolve 'target'. If omitted, Unity infers: instance ID -> by_id, path (contains '/') -> by_path, otherwise by_name. |
+| `name` | `str \| None` | — | GameObject name for 'create' (initial name) and 'modify' (rename) actions. |
+| `tag` | `str \| None` | — | Tag name - used for both 'create' (initial tag) and 'modify' (change tag) |
+| `parent` | `str \| None` | — | Parent GameObject reference - used for both 'create' (initial parent) and 'modify' (change parent) |
+| `position` | `list[float] \| dict[str, float] \| str \| None` | — | Position as [x, y, z] array, {x, y, z} object, or JSON string |
+| `rotation` | `list[float] \| dict[str, float] \| str \| None` | — | Rotation as [x, y, z] euler angles array, {x, y, z} object, or JSON string |
+| `scale` | `list[float] \| dict[str, float] \| str \| None` | — | Scale as [x, y, z] array, {x, y, z} object, or JSON string |
+| `components_to_add` | `list[str] \| str \| None` | — | List of component names to add during 'create' or 'modify' |
+| `primitive_type` | `str \| None` | — | Primitive type for 'create' action |
+| `save_as_prefab` | `bool \| str \| None` | — | If True, saves the created GameObject as a prefab (accepts true/false or 'true'/'false') |
+| `prefab_path` | `str \| None` | — | Path for prefab creation |
+| `prefab_folder` | `str \| None` | — | Folder for prefab creation |
+| `set_active` | `bool \| str \| None` | — | If True, sets the GameObject active (accepts true/false or 'true'/'false') |
+| `layer` | `str \| None` | — | Layer name |
+| `is_static` | `bool \| str \| None` | — | Set the GameObject's static flag. true = all StaticEditorFlags, false = none (accepts true/false or 'true'/'false') |
+| `components_to_remove` | `list[str] \| str \| None` | — | List of component names to remove |
+| `component_properties` | `dict[str, dict[str, Any]] \| str \| None` | — | Dictionary of component names to their properties to set. For example:                                     `{"MyScript": {"otherObject": {"find": "Player", "method": "by_name"}}}` assigns GameObject                                     `{"MyScript": {"playerHealth": {"find": "Player", "component": "HealthComponent"}}}` assigns Component                                     Example set nested property:                                     - Access shared material: `{"MeshRenderer": {"sharedMaterial.color": [1, 0, 0, 1]}}` |
+| `new_name` | `str \| None` | — | New name for the duplicated object (default: SourceName_Copy) |
+| `offset` | `list[float] \| str \| None` | — | Offset from original/reference position as [x, y, z] array (list or JSON string) |
+| `reference_object` | `str \| None` | — | Reference object for relative movement (required for move_relative) |
+| `direction` | `Literal['left', 'right', 'up', 'down', 'forward', 'back', 'front', 'backward', 'behind'] \| None` | — | Direction for relative movement (e.g., 'right', 'up', 'forward') |
+| `distance` | `float \| None` | — | Distance to move in the specified direction (default: 1.0) |
+| `world_space` | `bool \| str \| None` | — | If True (default), use world space directions; if False, use reference object's local directions |
+| `look_at_target` | `list[float] \| str \| None` | — | World position [x,y,z] or GameObject name/path/ID to look at (for look_at action). |
+| `look_at_up` | `list[float] \| str \| None` | — | Optional up vector [x,y,z] for look_at. Defaults to [0,1,0]. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+### Create a red cube at the world origin
+
+> Create a cube called `RedCube` at (0, 0, 0).
+
+```json
+{
+  "action": "create",
+  "name": "RedCube",
+  "primitive_type": "Cube",
+  "position": [0, 0, 0]
+}
+```
+
+Pair with [`manage_material`](./manage_material) to make it actually red.
+
+### Find a GameObject by name and move it
+
+> Move the `Player` 5 units up.
+
+```json
+{
+  "action": "modify",
+  "target": "Player",
+  "search_method": "by_name",
+  "position": [0, 5, 0]
+}
+```
+
+`search_method: by_name` matches the first GameObject whose name equals `Player`. Use `by_path` for `Parent/Child/Leaf` lookups or `by_id` for instance IDs.
+
+### Parent one GameObject under another
+
+> Make `Sword` a child of `Player/RightHand`.
+
+```json
+{
+  "action": "modify",
+  "target": "Sword",
+  "search_method": "by_name",
+  "parent": "Player/RightHand"
+}
+```
+
+### Delete every GameObject tagged `Cleanup`
+
+> Delete all objects tagged `Cleanup` in the current scene.
+
+```json
+{
+  "action": "delete",
+  "target": "Cleanup",
+  "search_method": "by_tag"
+}
+```
+
+### Multi-instance routing
+
+> In the `Editor2` instance, duplicate `MainCamera`.
+
+```json
+{
+  "action": "duplicate",
+  "target": "MainCamera",
+  "search_method": "by_name",
+  "unity_instance": "Editor2"
+}
+```
+
+See [Multi-Instance Routing](/guides/multi-instance) for the full routing model.
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_graphics.md

@@ -0,0 +1,101 @@
+---
+title: manage_graphics
+sidebar_label: manage_graphics
+description: "Manage rendering graphics: volumes, post-processing, light baking, rendering stats, pipeline settings, and URP renderer features."
+---
+
+# `manage_graphics`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_graphics`
+
+## Description
+
+Manage rendering graphics: volumes, post-processing, light baking, rendering stats, pipeline settings, and URP renderer features. Use ping to check pipeline and available features.
+
+VOLUME (require URP/HDRP):
+- volume_create, volume_add_effect, volume_set_effect, volume_remove_effect
+- volume_get_info, volume_set_properties, volume_list_effects, volume_create_profile
+
+BAKE (Edit mode only):
+- bake_start, bake_cancel, bake_status, bake_clear, bake_reflection_probe
+- bake_get_settings, bake_set_settings
+- bake_create_light_probe_group, bake_create_reflection_probe, bake_set_probe_positions
+
+STATS:
+- stats_get: Rendering counters (draw calls, batches, triangles, etc.)
+- stats_list_counters, stats_set_scene_debug, stats_get_memory
+
+PIPELINE:
+- pipeline_get_info, pipeline_set_quality, pipeline_get_settings, pipeline_set_settings
+
+FEATURES (URP only):
+- feature_list, feature_add, feature_remove, feature_configure, feature_toggle, feature_reorder
+
+SKYBOX / ENVIRONMENT:
+- skybox_get: Read all environment settings (material, ambient, fog, reflection, sun)
+- skybox_set_material: Set skybox material by asset path
+- skybox_set_properties: Set properties on current skybox material (tint, exposure, rotation)
+- skybox_set_ambient: Set ambient lighting mode and colors
+- skybox_set_fog: Enable/configure fog (mode, color, density, start/end distance)
+- skybox_set_reflection: Set environment reflection settings
+- skybox_set_sun: Set the sun source light
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `str` | yes | The graphics action to perform. |
+| `target` | `str \| None` | — | Target object name or instance ID. |
+| `effect` | `str \| None` | — | Effect type name (e.g., 'Bloom', 'Vignette'). |
+| `parameters` | `dict[str, Any] \| None` | — | Dict of parameter values. |
+| `properties` | `dict[str, Any] \| None` | — | Dict of properties to set. |
+| `settings` | `dict[str, Any] \| None` | — | Dict of settings (bake/pipeline). |
+| `name` | `str \| None` | — | Name for created objects. |
+| `is_global` | `bool \| None` | — | Whether Volume is global (default true). |
+| `weight` | `float \| None` | — | Volume weight (0-1). |
+| `priority` | `float \| None` | — | Volume priority. |
+| `profile_path` | `str \| None` | — | Asset path for VolumeProfile. |
+| `effects` | `list[dict[str, Any]] \| None` | — | Effect definitions for volume_create. |
+| `path` | `str \| None` | — | Asset path for volume_create_profile. |
+| `level` | `str \| None` | — | Quality level name or index. |
+| `position` | `list[float] \| None` | — | Position [x,y,z]. |
+| `grid_size` | `list[int] \| None` | — | Probe grid size [x,y,z]. |
+| `spacing` | `float \| None` | — | Probe grid spacing. |
+| `size` | `list[float] \| None` | — | Probe/volume size [x,y,z]. |
+| `resolution` | `int \| None` | — | Probe resolution. |
+| `mode` | `str \| None` | — | Probe mode or debug mode. |
+| `hdr` | `bool \| None` | — | HDR for reflection probes. |
+| `box_projection` | `bool \| None` | — | Box projection for reflection probes. |
+| `positions` | `list[list[float]] \| None` | — | Probe positions array. |
+| `index` | `int \| None` | — | Feature index. |
+| `active` | `bool \| None` | — | Feature active state. |
+| `order` | `list[int] \| None` | — | Feature reorder indices. |
+| `async_bake` | `bool \| None` | — | Async bake (default true). |
+| `feature_type` | `str \| None` | — | Renderer feature type name. |
+| `material` | `str \| None` | — | Material asset path for feature. |
+| `color` | `list[float] \| None` | — | Color [r,g,b,a] for ambient/fog. |
+| `intensity` | `float \| None` | — | Intensity value (ambient/reflection). |
+| `ambient_mode` | `str \| None` | — | Ambient mode: Skybox, Trilight, Flat, Custom. |
+| `equator_color` | `list[float] \| None` | — | Equator color [r,g,b,a] (Trilight mode). |
+| `ground_color` | `list[float] \| None` | — | Ground color [r,g,b,a] (Trilight mode). |
+| `fog_enabled` | `bool \| None` | — | Enable or disable fog. |
+| `fog_mode` | `str \| None` | — | Fog mode: Linear, Exponential, ExponentialSquared. |
+| `fog_color` | `list[float] \| None` | — | Fog color [r,g,b,a]. |
+| `fog_density` | `float \| None` | — | Fog density (Exponential modes). |
+| `fog_start` | `float \| None` | — | Fog start distance (Linear mode). |
+| `fog_end` | `float \| None` | — | Fog end distance (Linear mode). |
+| `bounces` | `int \| None` | — | Reflection bounces. |
+| `reflection_mode` | `str \| None` | — | Default reflection mode: Skybox, Custom. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_material.md

@@ -0,0 +1,101 @@
+---
+title: manage_material
+sidebar_label: manage_material
+description: "Manages Unity materials (set properties, colors, shaders, etc)."
+---
+
+# `manage_material`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_material`
+
+## Description
+
+Manages Unity materials (set properties, colors, shaders, etc). Read-only actions: ping, get_material_info. Modifying actions: create, set_material_shader_property, set_material_color, assign_material_to_renderer, set_renderer_color.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['ping', 'create', 'set_material_shader_property', 'set_material_color', 'assign_material_to_renderer', 'set_renderer_color', 'get_material_info']` | yes | Action to perform. |
+| `material_path` | `str \| None` | — | Path to material asset (Assets/...) |
+| `property` | `str \| None` | — | Shader property name (e.g., _BaseColor, _MainTex) |
+| `shader` | `str \| None` | — | Shader name (default: Standard) |
+| `properties` | `dict[str, Any] \| str \| None` | — | Initial properties to set as {name: value} dict. |
+| `value` | `list \| float \| int \| str \| bool \| None` | — | Value to set (color array, float, texture path/instruction) |
+| `color` | `list[float] \| dict[str, float] \| str \| None` | — | Color as [r, g, b] or [r, g, b, a] array, {r, g, b, a} object, or JSON string. |
+| `target` | `str \| None` | — | Target GameObject (name, path, or find instruction) |
+| `search_method` | `Literal['by_id', 'by_name', 'by_path', 'by_tag', 'by_layer', 'by_component'] \| None` | — | Search method for target |
+| `slot` | `int \| None` | — | Material slot index (0-based) |
+| `mode` | `Literal['shared', 'instance', 'property_block', 'create_unique'] \| None` | — | Assignment/modification mode; behavior when omitted is action-specific on the Unity side. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+### Create a red material from scratch
+
+> Create `Assets/Materials/Red.mat` using the Standard shader, base color red.
+
+```json
+{
+  "action": "create",
+  "material_path": "Materials/Red.mat",
+  "shader": "Standard",
+  "properties": { "_Color": [1, 0, 0, 1] }
+}
+```
+
+For URP, use `"shader": "Universal Render Pipeline/Lit"` and property `_BaseColor`.
+
+### Assign an existing material to a GameObject
+
+> Apply `Assets/Materials/Red.mat` to the `RedCube`.
+
+```json
+{
+  "action": "assign_material_to_renderer",
+  "target": "RedCube",
+  "search_method": "by_name",
+  "material_path": "Materials/Red.mat",
+  "slot": 0,
+  "mode": "shared"
+}
+```
+
+`mode: shared` reuses the asset. `mode: instance` clones it per-renderer (use sparingly — costs draw call batching).
+
+### Change just one shader property
+
+> Set `_Metallic` on `Materials/Red.mat` to 0.8.
+
+```json
+{
+  "action": "set_material_shader_property",
+  "material_path": "Materials/Red.mat",
+  "property": "_Metallic",
+  "value": 0.8
+}
+```
+
+### Tint a renderer without touching the shared material
+
+> Tint the cube's MeshRenderer blue using a MaterialPropertyBlock.
+
+```json
+{
+  "action": "set_renderer_color",
+  "target": "RedCube",
+  "search_method": "by_name",
+  "color": [0, 0, 1, 1],
+  "mode": "property_block"
+}
+```
+
+`property_block` mode avoids creating a per-instance material clone, preserving batching.
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_packages.md

@@ -0,0 +1,59 @@
+---
+title: manage_packages
+sidebar_label: manage_packages
+description: "Manage Unity packages: query, install, remove, embed, and configure registries."
+---
+
+# `manage_packages`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_packages`
+
+## Description
+
+Manage Unity packages: query, install, remove, embed, and configure registries.
+
+QUERY (read-only):
+- list_packages: List all installed packages
+- search_packages: Search Unity registry by keyword
+- get_package_info: Get details about a specific installed package
+- ping: Check package manager availability
+- status: Poll async job status (job_id required for list/search; optional for add/remove/embed)
+
+INSTALL/REMOVE:
+- add_package: Install a package (name, name@version, git URL, or file: path)
+- remove_package: Remove a package (checks dependents; use force=true to override)
+
+REGISTRIES:
+- list_registries: List all scoped registries
+- add_registry: Add a scoped registry (e.g., OpenUPM)
+- remove_registry: Remove a scoped registry
+
+UTILITY:
+- embed_package: Copy package to local Packages/ for editing
+- resolve_packages: Force re-resolution of all packages
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `str` | yes | The package action to perform. |
+| `package` | `str \| None` | — | Package identifier (name, name@version, git URL, or file: path). |
+| `force` | `bool \| None` | — | Force removal even if other packages depend on it. |
+| `query` | `str \| None` | — | Search query for search_packages. |
+| `job_id` | `str \| None` | — | Job ID for polling status. |
+| `name` | `str \| None` | — | Registry name for add_registry/remove_registry. |
+| `url` | `str \| None` | — | Registry URL for add_registry. |
+| `scopes` | `list[str] \| None` | — | Registry scopes for add_registry. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_physics.md

@@ -0,0 +1,94 @@
+---
+title: manage_physics
+sidebar_label: manage_physics
+description: "Manage physics settings, collision matrix, materials, joints, queries, and validation."
+---
+
+# `manage_physics`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_physics`
+
+## Description
+
+Manage physics settings, collision matrix, materials, joints, queries, and validation.
+
+SETTINGS: ping, get_settings, set_settings
+COLLISION MATRIX: get_collision_matrix, set_collision_matrix
+MATERIALS: create_physics_material, configure_physics_material, assign_physics_material
+JOINTS: add_joint, configure_joint, remove_joint
+QUERIES: raycast, raycast_all, linecast, shapecast, overlap
+FORCES: apply_force
+RIGIDBODY: get_rigidbody, configure_rigidbody
+VALIDATION: validate
+SIMULATION: simulate_step
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['ping', 'get_settings', 'set_settings', 'get_collision_matrix', 'set_collision_matrix', 'create_physics_material', 'configure_physics_material', 'assign_physics_material', 'add_joint', 'configure_joint', 'remove_joint', 'raycast', 'raycast_all', 'linecast', 'shapecast', 'overlap', 'validate', 'simulate_step', 'apply_force', 'get_rigidbody', 'configure_rigidbody']` | yes | The physics action to perform. |
+| `dimension` | `str \| None` | — | Physics dimension: '3d' (default) or '2d'. |
+| `settings` | `dict[str, Any] \| None` | — | Key-value settings for set_settings. |
+| `layer_a` | `str \| None` | — | Layer name or index for collision matrix. |
+| `layer_b` | `str \| None` | — | Layer name or index for collision matrix. |
+| `collide` | `bool \| None` | — | Whether layers should collide (set_collision_matrix). |
+| `name` | `str \| None` | — | Name for new physics material. |
+| `path` | `str \| None` | — | Asset path for materials. |
+| `dynamic_friction` | `float \| None` | — | Dynamic friction (0-1). |
+| `static_friction` | `float \| None` | — | Static friction (0-1). |
+| `bounciness` | `float \| None` | — | Bounciness (0-1). |
+| `friction` | `float \| None` | — | Friction for 2D materials. |
+| `friction_combine` | `str \| None` | — | Friction combine mode: Average, Minimum, Multiply, Maximum. |
+| `bounce_combine` | `str \| None` | — | Bounce combine mode: Average, Minimum, Multiply, Maximum. |
+| `material_path` | `str \| None` | — | Path to physics material asset for assign. |
+| `target` | `str \| None` | — | Target GameObject name or instance ID. |
+| `collider_type` | `str \| None` | — | Specific collider type to target. |
+| `search_method` | `str \| None` | — | Search method for target resolution. |
+| `joint_type` | `str \| None` | — | Joint type: fixed, hinge, spring, character, configurable (3D); distance, fixed, friction, hinge, relative, slider, spring, target, wheel (2D). |
+| `connected_body` | `str \| None` | — | Connected body target for joints. |
+| `motor` | `dict[str, Any] \| None` | — | Motor config: {targetVelocity, force, freeSpin}. |
+| `limits` | `dict[str, Any] \| None` | — | Limits config: {min, max, bounciness}. |
+| `spring` | `dict[str, Any] \| None` | — | Spring config: {spring, damper, targetPosition}. |
+| `drive` | `dict[str, Any] \| None` | — | Drive config for ConfigurableJoint. |
+| `properties` | `dict[str, Any] \| None` | — | Direct property dict for joints or materials. |
+| `origin` | `list[float] \| None` | — | Ray origin [x,y,z] or [x,y]. |
+| `direction` | `list[float] \| None` | — | Ray direction [x,y,z] or [x,y]. |
+| `max_distance` | `float \| None` | — | Max raycast distance. |
+| `layer_mask` | `str \| None` | — | Layer mask for queries (name or int). |
+| `query_trigger_interaction` | `str \| None` | — | Trigger interaction: UseGlobal, Ignore, Collide. |
+| `shape` | `str \| None` | — | Overlap shape: sphere, box, capsule (3D); circle, box, capsule (2D). |
+| `position` | `list[float] \| None` | — | Overlap position [x,y,z] or [x,y]. |
+| `size` | `Any \| None` | — | Overlap size: float (radius) or [x,y,z] (half-extents). |
+| `start` | `list[float] \| None` | — | Linecast start point [x,y,z] or [x,y]. |
+| `end` | `list[float] \| None` | — | Linecast end point [x,y,z] or [x,y]. |
+| `point1` | `list[float] \| None` | — | Capsule shapecast point1 [x,y,z]. |
+| `point2` | `list[float] \| None` | — | Capsule shapecast point2 [x,y,z]. |
+| `height` | `float \| None` | — | Capsule height for shapecast. |
+| `capsule_direction` | `int \| None` | — | Capsule direction: 0=X, 1=Y (default), 2=Z. |
+| `angle` | `float \| None` | — | Rotation angle for 2D shape casts. |
+| `force` | `list[float] \| None` | — | Force vector [x,y,z] or [x,y] for apply_force. |
+| `force_mode` | `str \| None` | — | Force mode: Force, Impulse, Acceleration, VelocityChange (3D); Force, Impulse (2D). |
+| `force_type` | `str \| None` | — | Force type: 'normal' (default) or 'explosion' (3D only). |
+| `torque` | `list[float] \| None` | — | Torque vector [x,y,z] (3D) or [z] (2D). |
+| `explosion_position` | `list[float] \| None` | — | Explosion center [x,y,z]. |
+| `explosion_radius` | `float \| None` | — | Explosion radius. |
+| `explosion_force` | `float \| None` | — | Explosion force magnitude. |
+| `upwards_modifier` | `float \| None` | — | Explosion upwards modifier. |
+| `steps` | `int \| None` | — | Number of simulation steps (max 100). |
+| `step_size` | `float \| None` | — | Step size in seconds. |
+| `page_size` | `int \| None` | — | Page size for validate results (default 50). |
+| `cursor` | `int \| None` | — | Cursor offset for validate pagination. |
+| `component_index` | `int \| None` | — | Zero-based index to select which component when multiple of the same type exist (e.g., multiple HingeJoints or BoxColliders). If omitted, targets the first instance. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_prefabs.md

@@ -0,0 +1,50 @@
+---
+title: manage_prefabs
+sidebar_label: manage_prefabs
+description: "Manages Unity Prefab assets."
+---
+
+# `manage_prefabs`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_prefabs`
+
+## Description
+
+Manages Unity Prefab assets. Actions: get_info, get_hierarchy, create_from_gameobject, modify_contents, open_prefab_stage, save_prefab_stage, close_prefab_stage. Two approaches to prefab editing: (1) Headless: use modify_contents for automated/scripted edits without opening the prefab in the editor. (2) Interactive: use open_prefab_stage to open a prefab, then manage_gameobject/manage_components to edit objects inside the prefab stage, then save_prefab_stage to save and close_prefab_stage to return to the main scene. Use create_child parameter with modify_contents to add child GameObjects or nested prefab instances to a prefab (single object or array for batch creation in one save). Example: create_child=[{"name": "Child1", "primitive_type": "Sphere", "position": [1,0,0]}, {"name": "Nested", "source_prefab_path": "Assets/Prefabs/Bullet.prefab", "position": [0,2,0]}]. Use delete_child parameter to remove child GameObjects from the prefab (single name/path or array of paths for batch deletion. Example: delete_child=["Child1", "Child2/Grandchild"]). Use component_properties with modify_contents to set serialized fields on existing components (e.g. component_properties={"Rigidbody": {"mass": 5.0}, "MyScript": {"health": 100}}). Supports object references via {"guid": "..."}, {"path": "Assets/..."}, or {"instanceID": 123}. Use manage_asset action=search filterType=Prefab to list prefabs.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['create_from_gameobject', 'get_info', 'get_hierarchy', 'modify_contents', 'open_prefab_stage', 'save_prefab_stage', 'close_prefab_stage']` | yes | Prefab operation to perform. |
+| `prefab_path` | `str \| None` | — | Prefab asset path (e.g., Assets/Prefabs/MyPrefab.prefab). |
+| `target` | `str \| None` | — | Target GameObject: scene object for create_from_gameobject, or object within prefab for modify_contents (name or path like 'Parent/Child'). |
+| `allow_overwrite` | `bool \| None` | — | Allow replacing existing prefab. |
+| `search_inactive` | `bool \| None` | — | Include inactive GameObjects in search. |
+| `unlink_if_instance` | `bool \| None` | — | Unlink from existing prefab before creating new one. |
+| `position` | `list[float] \| dict[str, float] \| str \| None` | — | New local position [x, y, z] or {x, y, z} for modify_contents. |
+| `rotation` | `list[float] \| dict[str, float] \| str \| None` | — | New local rotation (euler angles) [x, y, z] or {x, y, z} for modify_contents. |
+| `scale` | `list[float] \| dict[str, float] \| str \| None` | — | New local scale [x, y, z] or {x, y, z} for modify_contents. |
+| `name` | `str \| None` | — | New name for the target object in modify_contents. |
+| `tag` | `str \| None` | — | New tag for the target object in modify_contents. |
+| `layer` | `str \| None` | — | New layer name for the target object in modify_contents. |
+| `set_active` | `bool \| None` | — | Set active state of target object in modify_contents. |
+| `parent` | `str \| None` | — | New parent object name/path within prefab for modify_contents. |
+| `components_to_add` | `list[str] \| None` | — | Component types to add in modify_contents. |
+| `components_to_remove` | `list[str] \| None` | — | Component types to remove in modify_contents. |
+| `create_child` | `dict[str, Any] \| list[dict[str, Any]] \| None` | — | Create child GameObject(s) in the prefab. Single object or array of objects, each with: name (required), parent (optional, defaults to target), source_prefab_path (optional: asset path to instantiate as nested prefab, e.g. 'Assets/Prefabs/Bullet.prefab'), primitive_type (optional: Cube, Sphere, Capsule, Cylinder, Plane, Quad), position, rotation, scale, components_to_add, tag, layer, set_active. source_prefab_path and primitive_type are mutually exclusive. |
+| `delete_child` | `str \| list[str] \| None` | — | Child name(s) or path(s) to remove from the prefab. Supports single string or array for batch deletion (e.g. 'Child1' or ['Child1', 'Child1/Grandchild']). |
+| `component_properties` | `dict[str, dict[str, Any]] \| None` | — | Set properties on existing components in modify_contents. Keys are component type names, values are dicts of property name to value. Example: {"Rigidbody": {"mass": 5.0}, "MyScript": {"health": 100}}. Supports object references via {"guid": "..."}, {"path": "Assets/..."}, or {"instanceID": 123}. For Sprite sub-assets: {"guid": "...", "spriteName": "<name>"}. Single-sprite textures auto-resolve. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_scene.md

@@ -0,0 +1,110 @@
+---
+title: manage_scene
+sidebar_label: manage_scene
+description: "Performs CRUD operations on Unity scenes."
+---
+
+# `manage_scene`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_scene`
+
+## Description
+
+Performs CRUD operations on Unity scenes. Read-only actions: get_hierarchy, get_active, get_build_settings, get_loaded_scenes, scene_view_frame. Modifying actions: create (with optional template), load (with optional additive flag), save, close_scene, set_active_scene, move_to_scene, validate (with optional auto_repair). For build settings management (add/remove/enable scenes), use manage_build(action='scenes'). For screenshots, use manage_camera (screenshot, screenshot_multiview actions).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['create', 'load', 'save', 'get_hierarchy', 'get_active', 'get_build_settings', 'scene_view_frame', 'close_scene', 'set_active_scene', 'get_loaded_scenes', 'move_to_scene', 'validate']` | yes | Perform CRUD operations on Unity scenes and control the Scene View camera. |
+| `name` | `str \| None` | — | Scene name. |
+| `path` | `str \| None` | — | Scene path. |
+| `build_index` | `int \| str \| None` | — | Unity build index (quote as string, e.g., '0'). |
+| `scene_view_target` | `str \| int \| None` | — | GameObject reference for scene_view_frame (name, path, or instance ID). |
+| `parent` | `str \| int \| None` | — | Optional parent GameObject reference (name/path/instanceID) to list direct children. |
+| `page_size` | `int \| str \| None` | — | Page size for get_hierarchy paging. |
+| `cursor` | `int \| str \| None` | — | Opaque cursor for paging (offset). |
+| `max_nodes` | `int \| str \| None` | — | Hard cap on returned nodes per request (safety). |
+| `max_depth` | `int \| str \| None` | — | Accepted for forward-compatibility; current paging returns a single level. |
+| `max_children_per_node` | `int \| str \| None` | — | Child paging hint (safety). |
+| `include_transform` | `bool \| str \| None` | — | If true, include local transform in node summaries. |
+| `scene_name` | `str \| None` | — | Scene name for multi-scene operations. |
+| `scene_path` | `str \| None` | — | Full scene path (e.g. 'Assets/Scenes/Level2.unity'). |
+| `target` | `str \| int \| None` | — | GameObject reference (name, path, or instanceID) for move_to_scene. |
+| `remove_scene` | `bool \| str \| None` | — | For close_scene: true to fully remove, false to just unload. |
+| `additive` | `bool \| str \| None` | — | For load: true to open scene additively (keeps current scene). |
+| `template` | `str \| None` | — | For create: scene template ('empty', 'default', '3d_basic', '2d_basic'). Omit for empty scene. |
+| `auto_repair` | `bool \| str \| None` | — | For validate: true to auto-fix missing scripts (undoable). |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+### Load a scene from `Assets/Scenes/`
+
+> Open `Assets/Scenes/MainMenu.unity`.
+
+```json
+{
+  "action": "load",
+  "path": "Scenes/MainMenu.unity"
+}
+```
+
+Paths are relative to `Assets/`. Forward slashes only.
+
+### Get the scene hierarchy (paged)
+
+> List every GameObject in the active scene.
+
+```json
+{
+  "action": "get_hierarchy",
+  "page_size": 100
+}
+```
+
+Returns up to `page_size` entries plus a `next_cursor` for the remainder. Always page large hierarchies.
+
+### Save the active scene
+
+> Save the active scene under its existing path.
+
+```json
+{ "action": "save" }
+```
+
+### Create a scene from a template
+
+> Make a new 3D scene called `Lab`.
+
+```json
+{
+  "action": "create",
+  "path": "Scenes/Lab.unity",
+  "template": "3d_basic"
+}
+```
+
+Other templates: `2d_basic`, `default`, `empty`.
+
+### Additive multi-scene editing
+
+> Load `Scenes/Boss.unity` additively while keeping the current scene open.
+
+```json
+{
+  "action": "load",
+  "path": "Scenes/Boss.unity",
+  "additive": true
+}
+```
+
+Use `set_active_scene`, `close_scene`, and `move_to_scene` to compose multi-scene setups.
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_script.md

@@ -0,0 +1,89 @@
+---
+title: manage_script
+sidebar_label: manage_script
+description: "Compatibility router for legacy script operations."
+---
+
+# `manage_script`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Compatibility router for legacy script operations. Prefer apply_text_edits (ranges) or script_apply_edits (structured) for edits. Read-only action: read. Modifying actions: create, delete.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['create', 'read', 'delete']` | yes | Perform CRUD operations on C# scripts. |
+| `name` | `str` | yes | Script name (no .cs extension) |
+| `path` | `str` | yes | Asset path (default: 'Assets/') |
+| `contents` | `str \| None` | — | Contents of the script to create |
+| `script_type` | `str \| None` | — | Script type (e.g., 'C#') |
+| `namespace` | `str \| None` | — | Namespace for the script |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+:::note Use the right tool for the job
+`manage_script` only handles whole-file lifecycle: **create**, **read**, **delete**. For editing existing scripts, reach for:
+- **[`script_apply_edits`](./script_apply_edits)** — structured edits (replace method, insert method, anchor-based insert/replace) with balanced-brace guards. Use this for most code changes.
+- **[`apply_text_edits`](./apply_text_edits)** — raw line/column text edits with optional SHA precondition. Use for surgical text patches.
+- **[`validate_script`](./validate_script)** — Roslyn-based validation (structural or full semantic).
+- **[`read_console`](./read_console)** — fetch compile diagnostics after any change.
+:::
+
+### Create a new script
+
+> Create `Assets/Scripts/PlayerController.cs` with a starter MonoBehaviour.
+
+```json
+{
+  "action": "create",
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "namespace": "MyGame",
+  "contents": "using UnityEngine;\n\nnamespace MyGame {\n    public class PlayerController : MonoBehaviour {\n        void Update() { }\n    }\n}\n"
+}
+```
+
+`path` is relative to `Assets/` and must end in `/`. Omit `contents` to write a minimal stub.
+
+### Read a script's full contents
+
+> Show me `Assets/Scripts/PlayerController.cs`.
+
+```json
+{
+  "action": "read",
+  "name": "PlayerController",
+  "path": "Scripts/"
+}
+```
+
+Returns the full file. For just a SHA (to detect drift between reads and writes), use [`get_sha`](./get_sha) instead — it's cheaper.
+
+### Delete a script
+
+> Remove `Assets/Scripts/PlayerController.cs`.
+
+```json
+{
+  "action": "delete",
+  "name": "PlayerController",
+  "path": "Scripts/"
+}
+```
+
+### After every create / delete
+
+Unity needs a domain reload to compile the new file (or notice the old one is gone). Poll the `editor_state` resource's `isCompiling` field until it flips back to `false`, then run [`read_console`](./read_console) to catch any compile errors before relying on the new types.
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_script_capabilities.md

@@ -0,0 +1,35 @@
+---
+title: manage_script_capabilities
+sidebar_label: manage_script_capabilities
+description: "Get manage_script capabilities (supported ops, limits, and guards)."
+---
+
+# `manage_script_capabilities`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Get manage_script capabilities (supported ops, limits, and guards).
+    Returns:
+        - ops: list of supported structured ops
+        - text_ops: list of supported text ops
+        - max_edit_payload_bytes: server edit payload cap
+        - guards: header/using guard enabled flag
+
+## Parameters
+
+_No parameters._
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/manage_tools.md

@@ -0,0 +1,33 @@
+---
+title: manage_tools
+sidebar_label: manage_tools
+description: "Manage which tool groups are visible in this session."
+---
+
+# `manage_tools`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_tools`
+
+## Description
+
+Manage which tool groups are visible in this session. Actions: list_groups (show all groups and their status), activate (enable a group), deactivate (disable a group), sync (refresh visibility from Unity Editor's toggle states), reset (restore defaults). Activating a group makes its tools appear; deactivating hides them. Use sync after toggling tools in the Unity Editor GUI.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['list_groups', 'activate', 'deactivate', 'sync', 'reset']` | yes | Action to perform. |
+| `group` | `str \| None` | — | Group name (required for activate / deactivate). Valid groups: animation, asset_gen, core, docs, probuilder, profiling, scripting_ext, testing, ui, vfx |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/read_console.md

@@ -0,0 +1,39 @@
+---
+title: read_console
+sidebar_label: read_console
+description: "Gets messages from or clears the Unity Editor console."
+---
+
+# `read_console`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.read_console`
+
+## Description
+
+Gets messages from or clears the Unity Editor console. Defaults to 10 most recent entries. Use page_size/cursor for paging. Note: For maximum client compatibility, pass count as a quoted string (e.g., '5'). The 'get' action is read-only; 'clear' modifies ephemeral UI state (not project data).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `action` | `Literal['get', 'clear'] \| None` | — | Get or clear the Unity Editor console. Defaults to 'get' if omitted. |
+| `types` | `list[Literal['error', 'warning', 'log', 'all']] \| str \| None` | — | Message types to get (accepts list or JSON string) |
+| `count` | `int \| str \| None` | — | Max messages to return in non-paging mode (accepts int or string, e.g., 5 or '5'). Ignored when paging with page_size/cursor. |
+| `filter_text` | `str \| None` | — | Text filter for messages |
+| `page_size` | `int \| str \| None` | — | Page size for paginated console reads. Defaults to 50 when omitted. |
+| `cursor` | `int \| str \| None` | — | Opaque cursor for paging (0-based offset). Defaults to 0. |
+| `format` | `Literal['plain', 'detailed', 'json'] \| None` | — | Output format |
+| `include_stacktrace` | `bool \| str \| None` | — | Include stack traces in output (accepts true/false or 'true'/'false') |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/refresh_unity.md

@@ -0,0 +1,35 @@
+---
+title: refresh_unity
+sidebar_label: refresh_unity
+description: "Request a Unity asset database refresh and optionally a script compilation."
+---
+
+# `refresh_unity`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.refresh_unity`
+
+## Description
+
+Request a Unity asset database refresh and optionally a script compilation. Can optionally wait for readiness.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `mode` | `Literal['if_dirty', 'force']` | — | Refresh mode |
+| `scope` | `Literal['assets', 'scripts', 'all']` | — | Refresh scope |
+| `compile` | `Literal['none', 'request']` | — | Whether to request compilation |
+| `wait_for_ready` | `bool` | — | If true, wait until editor_state.advice.ready_for_tools is true |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/script_apply_edits.md

@@ -0,0 +1,186 @@
+---
+title: script_apply_edits
+sidebar_label: script_apply_edits
+description: "Structured C# edits (methods/classes) with safer boundaries - prefer this over raw text."
+---
+
+# `script_apply_edits`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.script_apply_edits`
+
+## Description
+
+Structured C# edits (methods/classes) with safer boundaries - prefer this over raw text.
+    Best practices:
+    - Prefer anchor_* ops for pattern-based insert/replace near stable markers
+    - Use replace_method/delete_method for whole-method changes (keeps signatures balanced)
+    - Avoid whole-file regex deletes; validators will guard unbalanced braces
+    - For tail insertions, prefer anchor/regex_replace on final brace (class closing)
+    - Pass options.validate='standard' for structural checks; 'basic' for interior-only edits
+    Canonical fields (use these exact keys):
+    - op: replace_method | insert_method | delete_method | anchor_insert | anchor_delete | anchor_replace
+    - className: string (defaults to 'name' if omitted on method/class ops)
+    - methodName: string (required for replace_method, delete_method)
+    - replacement: string (required for replace_method, insert_method)
+    - position: start | end | after | before (insert_method only)
+    - afterMethodName / beforeMethodName: string (required when position='after'/'before')
+    - anchor: regex string (for anchor_* ops)
+    - text: string (for anchor_insert/anchor_replace)
+    Examples:
+    1) Replace a method:
+    {
+        "name": "SmartReach",
+        "path": "Assets/Scripts/Interaction",
+        "edits": [
+        {
+        "op": "replace_method",
+        "className": "SmartReach",
+        "methodName": "HasTarget",
+        "replacement": "public bool HasTarget(){ return currentTarget!=null; }"
+        }
+    ],
+    "options": {"validate": "standard", "refresh": "immediate"}
+    }
+    "2) Insert a method after another:
+    {
+        "name": "SmartReach",
+        "path": "Assets/Scripts/Interaction",
+        "edits": [
+        {
+        "op": "insert_method",
+        "className": "SmartReach",
+        "replacement": "public void PrintSeries(){ Debug.Log(seriesName); }",
+        "position": "after",
+        "afterMethodName": "GetCurrentTarget"
+        }
+    ],
+    }
+    ]
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `name` | `str` | yes | Name of the script to edit |
+| `path` | `str` | yes | Path to the script to edit under Assets/ directory |
+| `edits` | `list[dict[str, Any]] \| str` | yes | List of edits to apply to the script (JSON list or stringified JSON) |
+| `options` | `dict[str, Any] \| None` | — | Options for the script edit |
+| `script_type` | `str` | — | Type of the script to edit |
+| `namespace` | `str \| None` | — | Namespace of the script to edit |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+:::tip
+Prefer this over [`apply_text_edits`](./apply_text_edits) for method-level changes. Structured ops keep braces balanced and survive incidental whitespace drift. Use `apply_text_edits` only when you need surgical line/column patching.
+:::
+
+### Replace a single method
+
+> In `Assets/Scripts/PlayerController.cs`, make `HasTarget` return `currentTarget != null`.
+
+```json
+{
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "edits": [
+    {
+      "op": "replace_method",
+      "className": "PlayerController",
+      "methodName": "HasTarget",
+      "replacement": "public bool HasTarget() { return currentTarget != null; }"
+    }
+  ],
+  "options": { "validate": "standard", "refresh": "immediate" }
+}
+```
+
+`path` ends with `/`. `validate: 'standard'` runs Roslyn structural checks before the write commits; use `'basic'` for cheap interior-only checks when you're touching a method body and trust the signature.
+
+### Insert a new method at the end of a class
+
+> Add a `Reset()` method after `Update` in `PlayerController`.
+
+```json
+{
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "edits": [
+    {
+      "op": "insert_method",
+      "className": "PlayerController",
+      "methodName": "Update",
+      "position": "after",
+      "replacement": "void Reset() { currentTarget = null; }"
+    }
+  ]
+}
+```
+
+`position`: `start | end | before | after`. With `before`/`after`, `methodName` is the anchor; with `start`/`end`, it's the position within the class body.
+
+### Delete a method
+
+> Remove `PlayerController.LegacyTick`.
+
+```json
+{
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "edits": [
+    { "op": "delete_method", "className": "PlayerController", "methodName": "LegacyTick" }
+  ]
+}
+```
+
+### Anchor-based insert (around a regex marker)
+
+> Add a `Debug.Log` right after the line containing `// --- input ---`.
+
+```json
+{
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "edits": [
+    {
+      "op": "anchor_insert",
+      "anchor": "//\\s*---\\s*input\\s*---",
+      "position": "after",
+      "replacement": "    Debug.Log(\"input frame\");"
+    }
+  ]
+}
+```
+
+Anchor ops are great for adding instrumentation near stable comment markers without locking into exact line numbers. The anchor is a regex; escape literal characters.
+
+### Apply several edits atomically
+
+> Replace two methods AND remove a third — all in one transaction. If validation fails on any, nothing is written.
+
+```json
+{
+  "name": "PlayerController",
+  "path": "Scripts/",
+  "edits": [
+    { "op": "replace_method", "methodName": "Awake",  "replacement": "void Awake() { Init(); }" },
+    { "op": "replace_method", "methodName": "Update", "replacement": "void Update() { Tick(); }" },
+    { "op": "delete_method",  "methodName": "OnDestroyOld" }
+  ],
+  "options": { "validate": "standard" }
+}
+```
+
+`className` defaults to `name` when omitted on method ops, so for single-class files you can skip it.
+
+### After every edit
+
+Poll `editor_state.isCompiling` until it flips back to `false`, then run [`read_console`](./read_console) to catch any compile errors before relying on the new types.
+<!-- examples:end -->
+

website/docs/reference/tools/core/set_active_instance.md

@@ -0,0 +1,32 @@
+---
+title: set_active_instance
+sidebar_label: set_active_instance
+description: "Set the active Unity instance for this client/session."
+---
+
+# `set_active_instance`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.set_active_instance`
+
+## Description
+
+Set the active Unity instance for this client/session. Accepts Name@hash, hash prefix, or port number (stdio only).
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `instance` | `str` | yes | Target instance (Name@hash, hash prefix, or port number in stdio mode) |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/core/validate_script.md

@@ -0,0 +1,34 @@
+---
+title: validate_script
+sidebar_label: validate_script
+description: "Validate a C# script and return diagnostics."
+---
+
+# `validate_script`
+
+> **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.
+
+**Group:** `core` &nbsp;·&nbsp; **Module:** `services.tools.manage_script`
+
+## Description
+
+Validate a C# script and return diagnostics.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `uri` | `str` | yes | URI of the script to validate under Assets/ directory, mcpforunity://path/Assets/... or file://... or Assets/... |
+| `level` | `Literal['basic', 'standard']` | — | Validation level |
+| `include_diagnostics` | `bool` | — | Include full diagnostics and summary |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+