chore(internal): sync tool docs after merge [skip ci]

Author: github-actions[bot]

README.md

@@ -8,7 +8,7 @@
   <!-- mcp-name: io.github.homeassistant-ai/ha-mcp -->
 
   <p align="center">
-    <img src="https://img.shields.io/badge/tools-86-blue" alt="95+ Tools">
+    <img src="https://img.shields.io/badge/tools-87-blue" alt="95+ Tools">
     <a href="https://github.com/homeassistant-ai/ha-mcp/releases"><img src="https://img.shields.io/github/v/release/homeassistant-ai/ha-mcp" alt="Release"></a>
     <a href="https://github.com/homeassistant-ai/ha-mcp/actions/workflows/e2e-tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/homeassistant-ai/ha-mcp/e2e-tests.yml?branch=master&label=E2E%20Tests" alt="E2E Tests"></a>
     <a href="LICENSE.md"><img src="https://img.shields.io/github/license/homeassistant-ai/ha-mcp.svg" alt="License"></a>
@@ -151,7 +151,7 @@ Spend less time configuring, more time enjoying your smart home.
 <details>
 <!-- TOOLS_TABLE_START -->
 
-<summary><b>Complete Tool List (86 tools)</b></summary>
+<summary><b>Complete Tool List (87 tools)</b></summary>
 
 | Category | Tools |
 |----------|-------|
@@ -175,7 +175,7 @@ Spend less time configuring, more time enjoying your smart home.
 | **Scripts** | `ha_config_get_script`, `ha_config_remove_script`, `ha_config_set_script` |
 | **Search & Discovery** | `ha_deep_search`, `ha_get_overview`, `ha_get_state`, `ha_search_entities` |
 | **Service & Device Control** | `ha_bulk_control`, `ha_call_service`, `ha_get_operation_status`, `ha_list_services` |
-| **System** | `ha_backup_create`, `ha_backup_restore`, `ha_check_config`, `ha_config_set_yaml` *(beta)*, `ha_get_system_health`, `ha_get_updates`, `ha_reload_core`, `ha_restart` |
+| **System** | `ha_backup_create`, `ha_backup_restore`, `ha_check_config`, `ha_config_set_yaml` *(beta)*, `ha_get_system_health`, `ha_get_updates`, `ha_manage_custom_tool` *(beta)*, `ha_reload_core`, `ha_restart` |
 | **Todo Lists** | `ha_get_todo`, `ha_remove_todo_item`, `ha_set_todo_item` |
 | **Utilities** | `ha_eval_template`, `ha_install_mcp_tools` *(beta)*, `ha_report_issue` |
 | **Zones** | `ha_get_zone`, `ha_remove_zone`, `ha_set_zone` |

homeassistant-addon/DOCS.md

@@ -4,7 +4,7 @@ AI assistant integration for Home Assistant via Model Context Protocol (MCP).
 
 ## About
 
-This add-on enables AI assistants (Claude, ChatGPT, etc.) to control your Home Assistant installation through the Model Context Protocol (MCP). It provides 86+ tools for device control, automation management, entity search, calendars, todo lists, dashboards, backup/restore, history/statistics, camera snapshots, and system queries.
+This add-on enables AI assistants (Claude, ChatGPT, etc.) to control your Home Assistant installation through the Model Context Protocol (MCP). It provides 87+ tools for device control, automation management, entity search, calendars, todo lists, dashboards, backup/restore, history/statistics, camera snapshots, and system queries.
 
 **Key Features:**
 - **Zero Configuration** - Automatically discovers Home Assistant connection
@@ -246,7 +246,7 @@ Requires add-on restart to take effect.
 
 **Default:** `false`
 
-Replaces the full tool catalog (~86 tools, ~46K tokens) with search-based discovery (~4 proxy tools, ~5K tokens). When enabled, tools are found via `ha_search_tools` and executed through categorized proxies (read/write/delete).
+Replaces the full tool catalog (~87 tools, ~46K tokens) with search-based discovery (~4 proxy tools, ~5K tokens). When enabled, tools are found via `ha_search_tools` and executed through categorized proxies (read/write/delete).
 
 > ⚠️ **Do NOT enable this if you use Claude in Sonnet or Opus modes.** Those models run their own built-in tool search / deferred tools, which conflicts with ha-mcp's — running both at once does not work. To use ha-mcp's tool search with Claude, disable Claude's built-in tool search first; otherwise leave this off.
 
@@ -356,7 +356,7 @@ If the add-on is slow or unresponsive:
 
 <!-- ADDON_TOOLS_START -->
 
-The add-on provides 86+ MCP tools for controlling Home Assistant:
+The add-on provides 87+ MCP tools for controlling Home Assistant:
 
 > Tools marked **(beta — dev channel only)** are gated behind feature flags and ship with the dev channel add-on only. See [docs/beta.md](https://github.com/homeassistant-ai/ha-mcp/blob/master/docs/beta.md) for setup and caveats.
 
@@ -476,6 +476,7 @@ The add-on provides 86+ MCP tools for controlling Home Assistant:
 - `ha_config_set_yaml` **(beta — dev channel only)** — Update raw YAML configuration in configuration.yaml or packages/*.yaml (LAST RESORT).
 - `ha_get_system_health` — Get Home Assistant system health, including Zigbee (ZHA) and Z-Wave JS network diagnostics.
 - `ha_get_updates` — Get update information -- list all updates or get details for a specific one.
+- `ha_manage_custom_tool` **(beta — dev channel only)** — Create and run a custom tool in a sandbox, or manage saved custom tools.
 - `ha_reload_core` — Reload Home Assistant configuration without full restart.
 - `ha_restart` — Restart Home Assistant.
 

site/src/data/tools.json

@@ -2594,6 +2594,45 @@
     ],
     "source_file": "tools_updates.py"
   },
+  {
+    "name": "ha_manage_custom_tool",
+    "title": "Custom Tool",
+    "description": "Create and run a custom tool in a sandbox, or manage saved custom tools.\n\n⚠️  **LAST RESORT** — search for existing tools first.\n\n**Modes** (mutually exclusive):\n- Provide ``code`` + ``justification`` to execute custom code\n- Set ``run_saved`` to re-run a previously saved tool by name\n- Set ``list_saved=True`` to list all saved tools\n\n**Available functions in sandbox:**\n- ``api_get(endpoint)`` — GET request to HA REST API\n- ``api_post(endpoint, data)`` — POST request to HA REST API\n- ``ws_send(message)`` — send a HA WebSocket command (e.g. registry\n  lookups, ``render_template``, dashboard ops). ``message`` must include\n  a ``\"type\"`` field; the MCP server adds ``id`` and handles auth.\n- ``call_tool(name, args)`` — call a registered MCP tool\n- ``delete_saved_tool(name)`` — remove a previously saved custom\n  tool by name. Returns ``{\"deleted\": True, \"name\": name}`` or\n  ``{\"error\": ...}``.\n\nUse ``api_get``/``api_post`` for REST operations not covered by existing\ntools.  Use ``ws_send`` when the operation is only available over the\nHome Assistant WebSocket API (most registry CRUD, template rendering,\nand Lovelace operations).  Use ``call_tool`` when an existing tool\nalready does what you need. Use ``delete_saved_tool`` to clean up\nsaved tools you no longer need.\n\nSaved tools persist across server restarts when\n``CODE_MODE_SAVED_TOOLS_PATH`` is set (the addon sets this by\ndefault to ``/data/saved_tools.json``).\n\nExample — check repairs (no built-in tool for this):\n```python\nrepairs = await api_get(\"/repairs/issues\")\nrepairs\n```\n\nExample — list areas via WebSocket:\n```python\nresult = await ws_send({\"type\": \"config/area_registry/list\"})\nresult.get(\"result\", [])\n```\n\nExample — chain existing tools:\n```python\nresult = await call_tool(\"ha_search_entities\", {\"query\": \"light\", \"limit\": 5})\ndata = result.get(\"data\", result)\nlights = data.get(\"results\", [])\nfor e in lights:\n    await call_tool(\"ha_call_service\", {\n        \"domain\": \"light\", \"service\": \"turn_off\",\n        \"entity_id\": e[\"entity_id\"]})\n{\"turned_off\": len(lights)}\n```\n\nExample — delete an obsolete saved tool:\n```python\ndelete_saved_tool(\"old_movie_mode\")\n```\n\nArgs:\n    code: Python code to execute.  Last expression is the return value.\n    justification: Why no existing tool works (required with code).\n    save_as: Save the tool under this name for reuse (alphanumeric/underscores, max 64 chars).\n    run_saved: Name of a previously saved tool to re-run.\n    list_saved: Set True to list all saved tools.",
+    "inputSchema": {
+      "properties": {
+        "code": {
+          "type": "str | None",
+          "default": null
+        },
+        "justification": {
+          "type": "str | None",
+          "default": null
+        },
+        "save_as": {
+          "type": "str | None",
+          "default": null
+        },
+        "run_saved": {
+          "type": "str | None",
+          "default": null
+        },
+        "list_saved": {
+          "type": "bool",
+          "default": false
+        }
+      }
+    },
+    "annotations": {
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "readOnlyHint": false
+    },
+    "tags": [
+      "System",
+      "beta"
+    ],
+    "source_file": "tools_code.py"
+  },
   {
     "name": "ha_reload_core",
     "title": "Reload Core Components",