ha-mcp-dev 7.4.1.dev436__tar.gz → 7.4.1.dev438__tar.gz

{ha_mcp_dev-7.4.1.dev436/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.4.1.dev438}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.4.1.dev436
+Version: 7.4.1.dev438
 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.4.1.dev436 → ha_mcp_dev-7.4.1.dev438}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.4.1.dev436"
+version = "7.4.1.dev438"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

{ha_mcp_dev-7.4.1.dev436 → ha_mcp_dev-7.4.1.dev438}/src/ha_mcp/tools/tools_config_helpers.py

@@ -248,9 +248,12 @@ async def _handle_flow_helper(
         if not config_dict.get("name"):
             raise_tool_error(create_error_response(
                 ErrorCode.VALIDATION_INVALID_PARAMETER,
-                "name is required for create action",
+                f'name is required for create action. Include "name" as a '
+                f'top-level argument, e.g. {{"helper_type": "{helper_type}", '
+                f'"name": "My Helper"}}.',
                 suggestions=[
-                    "Pass the name argument directly or include 'name' in config",
+                    'Add "name": "My Helper" at the top level of the JSON arguments',
+                    'Or include "name": "My Helper" inside the "config" dict',
                 ],
                 context={"helper_type": helper_type},
             ))
@@ -533,11 +536,12 @@ def register_config_helper_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
             str | None,
             Field(
                 description=(
-                    "Display name for the helper. Required on create; optional on "
-                    "update (pass helper_id to skip). For flow-based helper types on "
-                    "update (template, group, utility_meter, ...), this is typically "
-                    "ignored — options flows don't expose renaming. Rename a flow "
-                    "helper by deleting and recreating instead."
+                    "REQUIRED when creating (no helper_id provided). Display name "
+                    "for the helper. Optional on update — pass helper_id instead. "
+                    "For flow-based helper types on update (template, group, "
+                    "utility_meter, ...), this is typically ignored — options flows "
+                    "don't expose renaming. Rename a flow helper by deleting and "
+                    "recreating instead."
                 ),
                 default=None,
             ),
@@ -545,7 +549,7 @@ def register_config_helper_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
         helper_id: Annotated[
             str | None,
             Field(
-                description="Helper ID for updates (e.g., 'my_button' or 'input_button.my_button'). If not provided, creates a new helper.",
+                description="REQUIRED when updating an existing helper. Bare ID ('my_button') or full entity ID ('input_button.my_button'). Omit to create a new helper.",
                 default=None,
             ),
         ] = None,
@@ -783,7 +787,7 @@ def register_config_helper_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
         """
         Create or update Home Assistant helper entities (27 types, unified interface).
 
-        Creates new helper if helper_id is omitted, updates existing if helper_id is provided.
+        Create requires `name`; update requires `helper_id`.
 
         SIMPLE types (structured params, WebSocket API): input_boolean, input_button,
         input_select, input_number, input_text, input_datetime, counter, timer, schedule,
@@ -869,7 +873,14 @@ def register_config_helper_tools(mcp: Any, client: Any, **kwargs: Any) -> None:
                     raise_tool_error(
                         create_error_response(
                             ErrorCode.VALIDATION_INVALID_PARAMETER,
-                            "name is required for create action",
+                            f'name is required for create action. Include '
+                            f'"name" as a top-level argument, e.g. '
+                            f'{{"helper_type": "{helper_type}", "name": '
+                            f'"My Helper"}}.',
+                            suggestions=[
+                                'Add "name": "My Helper" at the top level of the JSON arguments',
+                                'Or pass "helper_id": "my_helper" if you intended to update an existing helper',
+                            ],
                             context={"helper_type": helper_type},
                         )
                     )

{ha_mcp_dev-7.4.1.dev436 → ha_mcp_dev-7.4.1.dev438/src/ha_mcp_dev.egg-info}/PKG-INFO

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