ha-mcp-dev 7.12.3.dev1932__tar.gz → 7.12.3.dev1937__tar.gz

{ha_mcp_dev-7.12.3.dev1932/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.12.3.dev1937}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.12.3.dev1932
+Version: 7.12.3.dev1937
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.12.3.dev1932"
+version = "7.12.3.dev1937"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 # Upper bound widened to <3.15 so the package installs on Home Assistant's

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/server.py

@@ -1349,6 +1349,7 @@ class HomeAssistantSmartMCPServer(EnhancedToolsMixin):
             name=SKILL_TOOL_NAME,
             description=tool_description,
             annotations={
+                "openWorldHint": False,
                 "readOnlyHint": True,
                 "idempotentHint": True,
                 "title": "Get Home Assistant Best Practices Skill Guide",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/settings_ui/_tools_meta.py

@@ -89,8 +89,9 @@ TRANSFORM_GENERATED_TOOLS: dict[str, ToolStub] = {}
 # won't appear in local_provider._list_tools(), so we inject stub entries
 # into the settings UI so users discover the tool exists and how to enable
 # it. Keep this dict in sync with the ``"beta"`` tag added to each tool's
-# source file (tools_yaml_config.py, tools_filesystem.py, tools_mcp_component.py,
-# tools_code.py) — a future rename or removal needs to land in both places.
+# source file (tools_yaml_config.py, tools_yaml_read.py, tools_filesystem.py,
+# tools_mcp_component.py, tools_code.py) — a future rename or removal needs to
+# land in both places.
 FEATURE_GATED_TOOLS: dict[str, ToolStub] = {
     "ha_config_set_yaml": {
         "title": "Set YAML Config",
@@ -99,6 +100,13 @@ FEATURE_GATED_TOOLS: dict[str, ToolStub] = {
         "disabled_by": "enable_yaml_config_editing",
         "destructiveHint": True,
     },
+    "ha_config_get_yaml": {
+        "title": "Read YAML Config Fragment",
+        "primary_tag": "System",
+        "description": "Read the YAML fragment under a key in a config file, or find which file defines it.",
+        "disabled_by": "enable_filesystem_tools",
+        "readOnlyHint": True,
+    },
     "ha_manage_custom_tool": {
         "title": "Custom Tool",
         "primary_tag": "System",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/backup.py

@@ -1054,7 +1054,11 @@ def register_backup_tools(
     @mcp.tool(
         description=manage_backup_description,
         tags={"System"},
-        annotations={"destructiveHint": True, "title": "Manage Backups"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Manage Backups",
+        },
     )
     @log_tool_usage
     async def ha_manage_backup(

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_addons.py

@@ -2572,6 +2572,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
     @mcp.tool(
         tags={"Add-ons"},
         annotations={
+            "openWorldHint": True,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Add-ons",
@@ -2660,6 +2661,7 @@ def register_addon_tools(mcp: Any, client: HomeAssistantClient, **kwargs: Any) -
     @mcp.tool(
         tags={"Add-ons"},
         annotations={
+            "openWorldHint": True,
             "destructiveHint": True,
             "idempotentHint": False,
             "readOnlyHint": False,

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_areas.py

@@ -139,6 +139,7 @@ class AreaTools:
         name="ha_list_floors_areas",
         tags={"Areas & Floors"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "List Floors and Areas",
@@ -390,6 +391,7 @@ class AreaTools:
         name="ha_set_area_or_floor",
         tags={"Areas & Floors"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Create or Update Area or Floor",
         },
@@ -640,6 +642,7 @@ class AreaTools:
         name="ha_remove_area_or_floor",
         tags={"Areas & Floors"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Area or Floor",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_blueprints.py

@@ -76,6 +76,7 @@ class BlueprintTools:
         name="ha_get_blueprint",
         tags={"Blueprints"},
         annotations={
+            "openWorldHint": True,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Blueprint",
@@ -224,7 +225,11 @@ class BlueprintTools:
     @tool(
         name="ha_import_blueprint",
         tags={"Blueprints"},
-        annotations={"destructiveHint": True, "title": "Import Blueprint"},
+        annotations={
+            "openWorldHint": True,
+            "destructiveHint": True,
+            "title": "Import Blueprint",
+        },
     )
     @log_tool_usage
     async def ha_import_blueprint(

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_bug_report.py

@@ -646,6 +646,7 @@ class BugReportTools:
         name="ha_report_issue",
         tags={"Utilities"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Report Issue or Feedback",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_calendar.py

@@ -43,6 +43,7 @@ class CalendarTools:
         name="ha_config_get_calendar_events",
         tags={"Calendar"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Calendar Events",
@@ -282,6 +283,7 @@ class CalendarTools:
         name="ha_config_set_calendar_event",
         tags={"Calendar"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Create or Update Calendar Event",
         },
@@ -426,6 +428,7 @@ class CalendarTools:
         name="ha_config_remove_calendar_event",
         tags={"Calendar"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Calendar Event",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_camera.py

@@ -62,6 +62,7 @@ class CameraTools:
         name="ha_get_camera_image",
         tags={"Camera"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Camera Image",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_categories.py

@@ -38,6 +38,7 @@ class CategoryTools:
         name="ha_config_get_category",
         tags={"Labels & Categories"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Category",
@@ -170,7 +171,11 @@ class CategoryTools:
     @tool(
         name="ha_config_set_category",
         tags={"Labels & Categories"},
-        annotations={"destructiveHint": True, "title": "Create or Update Category"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Create or Update Category",
+        },
     )
     @with_auto_backup(
         domain="category",
@@ -313,6 +318,7 @@ class CategoryTools:
         name="ha_config_remove_category",
         tags={"Labels & Categories"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Category",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_code.py

@@ -1289,6 +1289,7 @@ def register_code_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
     @mcp.tool(
         tags={"System", "beta"},
         annotations={
+            "openWorldHint": False,
             "title": "Custom Tool",
             "destructiveHint": True,
             "idempotentHint": False,

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_config_automations.py

@@ -340,6 +340,7 @@ class AutomationConfigTools:
         name="ha_config_get_automation",
         tags={"Automations"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Automation Config",
@@ -450,6 +451,7 @@ class AutomationConfigTools:
         name="ha_config_set_automation",
         tags={"Automations"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Create or Update Automation",
         },
@@ -1291,6 +1293,7 @@ class AutomationConfigTools:
         name="ha_config_remove_automation",
         tags={"Automations"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Automation",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_config_dashboards.py

@@ -1259,6 +1259,7 @@ class DashboardConfigTools:
         name="ha_config_get_dashboard",
         tags={"Dashboards"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": False,
             "idempotentHint": True,
             "title": "Get Dashboard",
@@ -1815,7 +1816,11 @@ class DashboardConfigTools:
     @tool(
         name="ha_config_set_dashboard",
         tags={"Dashboards"},
-        annotations={"destructiveHint": True, "title": "Create or Update Dashboard"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Create or Update Dashboard",
+        },
     )
     @with_auto_backup(domain="dashboard", id_param="url_path")
     @log_tool_usage
@@ -2743,7 +2748,11 @@ class DashboardConfigTools:
     @tool(
         name="ha_config_delete_dashboard",
         tags={"Dashboards"},
-        annotations={"destructiveHint": True, "title": "Delete Dashboard"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Delete Dashboard",
+        },
     )
     @with_auto_backup(domain="dashboard", id_param="url_path")
     @log_tool_usage

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_config_helpers.py

@@ -3608,6 +3608,7 @@ class HelperConfigTools:
         name="ha_config_list_helpers",
         tags={"Helper Entities"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "List Helpers",
@@ -4021,7 +4022,11 @@ class HelperConfigTools:
     @tool(
         name="ha_config_set_helper",
         tags={"Helper Entities"},
-        annotations={"destructiveHint": True, "title": "Create or Update Helper"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Create or Update Helper",
+        },
     )
     @with_auto_backup(
         domain_fn=lambda kw: f"helper_{kw.get('helper_type', 'unknown')}",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_config_scenes.py

@@ -204,6 +204,7 @@ class ConfigSceneTools:
         name="ha_config_get_scene",
         tags={"Scenes"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Scene Config",
@@ -453,6 +454,7 @@ class ConfigSceneTools:
         name="ha_config_set_scene",
         tags={"Scenes"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Create or Update Scene",
         },
@@ -976,6 +978,7 @@ class ConfigSceneTools:
         name="ha_config_remove_scene",
         tags={"Scenes"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Scene",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_config_scripts.py

@@ -99,6 +99,7 @@ class ConfigScriptTools:
         name="ha_config_get_script",
         tags={"Scripts"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Script Config",
@@ -409,6 +410,7 @@ class ConfigScriptTools:
         name="ha_config_set_script",
         tags={"Scripts"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Create or Update Script",
         },
@@ -860,6 +862,7 @@ class ConfigScriptTools:
         name="ha_config_remove_script",
         tags={"Scripts"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Script",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_dashboard_screenshot.py

@@ -100,6 +100,7 @@ class DashboardScreenshotTools:
         name="ha_get_dashboard_screenshot",
         tags={"Dashboard", "beta"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": False,
             "title": "Get Dashboard Screenshot",
         },

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_dev.py

@@ -456,7 +456,11 @@ class DevTools:
     @tool(
         name="ha_dev_manage_settings",
         tags={"Developer"},
-        annotations={"title": "Manage Server Settings (dev)", "destructiveHint": True},
+        annotations={
+            "openWorldHint": False,
+            "title": "Manage Server Settings (dev)",
+            "destructiveHint": True,
+        },
     )
     @log_tool_usage
     async def ha_dev_manage_settings(
@@ -698,7 +702,11 @@ class DevTools:
     @tool(
         name="ha_dev_manage_server",
         tags={"Developer"},
-        annotations={"title": "Manage MCP Server (dev)", "destructiveHint": True},
+        annotations={
+            "openWorldHint": True,
+            "title": "Manage MCP Server (dev)",
+            "destructiveHint": True,
+        },
     )
     @log_tool_usage
     async def ha_dev_manage_server(

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_energy.py

@@ -370,6 +370,7 @@ class EnergyTools:
         name="ha_manage_energy_prefs",
         tags={"Energy"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": False,
             "title": "Manage Energy Dashboard Preferences",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_entities.py

@@ -1388,6 +1388,7 @@ class EntityTools:
         name="ha_set_entity",
         tags={"Entity Registry"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Set Entity",
@@ -1723,6 +1724,7 @@ class EntityTools:
         name="ha_get_entity",
         tags={"Entity Registry"},
         annotations={
+            "openWorldHint": False,
             "readOnlyHint": True,
             "idempotentHint": True,
             "title": "Get Entity",
@@ -2014,6 +2016,7 @@ class EntityTools:
         name="ha_remove_entity",
         tags={"Entity Registry"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Entity",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_filesystem.py

@@ -74,7 +74,14 @@ CALLER_TOKEN_BOOTSTRAP_SERVICE = "get_caller_token"
 # ENABLE_YAML_EDIT_CONFIRM, default on); a <0.11.0 component's strict
 # (PREVENT_EXTRA) schema rejects the unknown arg with a raw voluptuous
 # error — the gate surfaces an actionable "update" prompt instead.
-MIN_COMPONENT_VERSION = "0.11.0"
+# 1.1.0: the YAML fragment read (#1788) needs two component behaviours that a
+# <1.1.0 component reports no differently from a missing key. ``list_files``
+# only now honours the configured packages folder, so ha_config_get_yaml's
+# glob/discovery would otherwise come back "Path not allowed" instead of
+# enumerating packages; and ``include_parsed`` on ``read_file`` is a new arg
+# that an older strict (PREVENT_EXTRA) schema rejects with a raw voluptuous
+# error. The gate turns both into the actionable "update" prompt.
+MIN_COMPONENT_VERSION = "1.1.0"
 
 
 def _version_tuple(version: str) -> tuple[int, ...]:
@@ -371,6 +378,7 @@ class FilesystemTools:
         name="ha_list_files",
         tags={"Files", "beta"},
         annotations={
+            "openWorldHint": False,
             "readOnlyHint": True,
             "title": "List Files",
         },
@@ -478,6 +486,7 @@ class FilesystemTools:
         name="ha_read_file",
         tags={"Files", "beta"},
         annotations={
+            "openWorldHint": False,
             "readOnlyHint": True,
             "title": "Read File",
         },
@@ -509,6 +518,19 @@ class FilesystemTools:
                 ),
             ),
         ] = None,
+        yaml_path: Annotated[
+            str | None,
+            Field(
+                default=None,
+                description=(
+                    "Dotted YAML key path (e.g. 'alert2', 'mqtt.sensor'). When "
+                    "set, the response also carries 'subtree': the round-trip "
+                    "text of just that key's value. To look a key up across "
+                    "packages/*.yaml, or to get it as structured data, use "
+                    "ha_config_get_yaml instead."
+                ),
+            ),
+        ] = None,
     ) -> dict[str, Any]:
         """Read a file from the Home Assistant config directory.
 
@@ -539,6 +561,9 @@ class FilesystemTools:
         - size: File size in bytes
         - modified: Last modification timestamp
         - path: The file path that was read
+        - subtree: Round-trip text of the `yaml_path` key, when that arg is set
+          (null when the key is absent). Comments and HA tags (`!secret`,
+          `!include`) survive as written — a `!secret` is never resolved.
 
         **Example:**
         ```python
@@ -547,6 +572,9 @@ class FilesystemTools:
 
         # Read last 100 lines of log
         result = ha_read_file(path="home-assistant.log", tail_lines=100)
+
+        # Read just the alert2 block out of a package file
+        result = ha_read_file(path="packages/alert2.yaml", yaml_path="alert2")
         ```
         """
         try:
@@ -557,6 +585,8 @@ class FilesystemTools:
             service_data: dict[str, Any] = {"path": path}
             if tail_lines is not None:
                 service_data["tail_lines"] = tail_lines
+            if yaml_path is not None:
+                service_data["yaml_path"] = yaml_path
 
             # Call the custom component service
             result = await call_mcp_tools_service(
@@ -593,6 +623,7 @@ class FilesystemTools:
         name="ha_write_file",
         tags={"Files", "beta"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Write File",
         },
@@ -735,6 +766,7 @@ class FilesystemTools:
         name="ha_delete_file",
         tags={"Files", "beta"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "title": "Delete File",
         },

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_groups.py

@@ -136,6 +136,7 @@ class GroupTools:
         name="ha_config_list_groups",
         tags={"Groups"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "List Groups",
@@ -210,7 +211,11 @@ class GroupTools:
     @tool(
         name="ha_config_set_group",
         tags={"Groups"},
-        annotations={"destructiveHint": True, "title": "Create or Update Group"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Create or Update Group",
+        },
     )
     @with_auto_backup(domain="group", id_param="object_id")
     @log_tool_usage
@@ -390,6 +395,7 @@ class GroupTools:
         name="ha_config_remove_group",
         tags={"Groups"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Group",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_hacs.py

@@ -111,6 +111,7 @@ class HacsTools:
         name="ha_get_hacs_info",
         tags={"HACS"},
         annotations={
+            "openWorldHint": True,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get HACS Info",
@@ -214,6 +215,7 @@ class HacsTools:
         name="ha_manage_hacs",
         tags={"HACS"},
         annotations={
+            "openWorldHint": True,
             "destructiveHint": True,
             "title": "Manage HACS",
         },

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_history.py

@@ -127,6 +127,7 @@ class HistoryTools:
         name="ha_get_history",
         tags={"History & Statistics"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Entity History or Statistics",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_integrations.py

@@ -292,6 +292,7 @@ class IntegrationTools:
         name="ha_get_integration",
         tags={"Integrations"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Integration",
@@ -1188,7 +1189,11 @@ class IntegrationTools:
     @tool(
         name="ha_set_integration",
         tags={"Integrations"},
-        annotations={"destructiveHint": True, "title": "Set Integration"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Set Integration",
+        },
     )
     @with_auto_backup(domain="integration", id_param="entry_id")
     @log_tool_usage
@@ -1412,6 +1417,7 @@ class IntegrationTools:
         name="ha_remove_helpers_integrations",
         tags={"Helper Entities", "Integrations"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Helper or Integration",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_labels.py

@@ -35,6 +35,7 @@ class LabelTools:
         name="ha_config_get_label",
         tags={"Labels & Categories"},
         annotations={
+            "openWorldHint": False,
             "idempotentHint": True,
             "readOnlyHint": True,
             "title": "Get Label",
@@ -151,7 +152,11 @@ class LabelTools:
     @tool(
         name="ha_config_set_label",
         tags={"Labels & Categories"},
-        annotations={"destructiveHint": True, "title": "Create or Update Label"},
+        annotations={
+            "openWorldHint": False,
+            "destructiveHint": True,
+            "title": "Create or Update Label",
+        },
     )
     @with_auto_backup(domain="label", id_param="label_id")
     @log_tool_usage
@@ -289,6 +294,7 @@ class LabelTools:
         name="ha_config_remove_label",
         tags={"Labels & Categories"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": True,
             "title": "Remove Label",

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_mcp_component.py

@@ -253,7 +253,11 @@ class McpComponentTools:
     @tool(
         name="ha_install_mcp_tools",
         tags={"Utilities", "beta"},
-        annotations={"destructiveHint": True, "title": "Install MCP Tools Component"},
+        annotations={
+            "openWorldHint": True,
+            "destructiveHint": True,
+            "title": "Install MCP Tools Component",
+        },
     )
     @log_tool_usage
     async def ha_install_mcp_tools(

{ha_mcp_dev-7.12.3.dev1932 → ha_mcp_dev-7.12.3.dev1937}/src/ha_mcp/tools/tools_radio.py

@@ -90,6 +90,7 @@ class RadioTools:
         name="ha_manage_radio",
         tags={"Radio Management", "Z-Wave", "Zigbee", "Matter", "Thread"},
         annotations={
+            "openWorldHint": False,
             "destructiveHint": True,
             "idempotentHint": False,
             "title": "Manage Radios (Z-Wave / Zigbee / Matter / Thread)",