Skip to content

Commit d2ff93b

Browse files
chore(internal): sync tool docs after merge [skip ci]
1 parent 5076c1d commit d2ff93b

2 files changed

Lines changed: 7 additions & 3 deletions

File tree

homeassistant-addon/DOCS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -476,7 +476,7 @@ The add-on provides 88+ MCP tools for controlling Home Assistant:
476476
- `ha_deep_search` — Search inside automation, script, scene, helper, and dashboard *configurations* — not for finding entity IDs.
477477
- `ha_get_overview` — Get AI-friendly system overview with intelligent categorization.
478478
- `ha_get_state` — Get current status, state, and attributes of one or more entities (lights, switches, sensors, climate, covers, locks, fans, etc.).
479-
- `ha_search_entities` Find or list entities (lights, sensors, switches, etc.) by name, domain, or area.
479+
- `ha_search_entities` Search for entities (lights, sensors, switches, etc.) by name, domain, or area.
480480

481481
### Service & Device Control
482482
- `ha_bulk_control` — Control multiple devices with bulk operation support and WebSocket tracking.

site/src/data/tools.json

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2323,15 +2323,15 @@
23232323
{
23242324
"name": "ha_search_entities",
23252325
"title": "Search Entities",
2326-
"description": "Find or list entities (lights, sensors, switches, etc.) by name, domain, or area.\n\nWhen NOT to use: for searching inside automation, script, helper, or dashboard\n*configurations* (e.g. which automations call a service or reference an entity),\nuse `ha_deep_search`.\n\nTo enumerate all entities of a domain, omit `query` and pass `domain_filter`. For\nexample, `ha_search_entities(domain_filter=\"calendar\")` lists all calendars. At\nleast one of `query`, `domain_filter`, or `area_filter` must be set.",
2326+
"description": "Search for entities (lights, sensors, switches, etc.) by name, domain, or area.\n\nWhen NOT to use: for searching inside automation, script, helper, or dashboard\n*configurations* (e.g. which automations call a service or reference an entity),\nuse `ha_deep_search`.\n\nTo enumerate all entities of a domain, omit `query` and pass `domain_filter`. For\nexample, `ha_search_entities(domain_filter=\"calendar\")` lists all calendars. At\nleast one of `query`, `domain_filter`, or `area_filter` must be set.",
23272327
"inputSchema": {
23282328
"properties": {
23292329
"query": {
23302330
"type": "Annotated[str | None, Field(default=None, description='Entity name to search for (fuzzy or exact match). Omit to list entities; `domain_filter` or `area_filter` must be set in that mode.')]",
23312331
"default": null
23322332
},
23332333
"domain_filter": {
2334-
"type": "Annotated[str | None, Field(default=None, description=\"Limit to a single domain (e.g. 'light', 'sensor', 'calendar').\")]",
2334+
"type": "Annotated[str | None, Field(default=None, description=\"Limit to a single domain (e.g. 'light', 'sensor', 'calendar'). Case-insensitive — values are normalized to lowercase before matching.\")]",
23352335
"default": null
23362336
},
23372337
"area_filter": {
@@ -2353,6 +2353,10 @@
23532353
"exact_match": {
23542354
"type": "Annotated[bool | str, Field(default=True, description='Use exact substring matching (default: True). Set to False for fuzzy matching when the query may contain typos or approximate terms.')]",
23552355
"default": true
2356+
},
2357+
"include_hidden": {
2358+
"type": "Annotated[bool | str, Field(default=True, description='Include entities marked hidden_by in the entity registry (default: True). Hidden entities still appear in results but receive a score penalty so they sort below comparable visible matches — typically pulling integration diagnostics and user-suppressed entries to the bottom of the list rather than excluding them. Set to False to filter them out entirely.')]",
2359+
"default": true
23562360
}
23572361
}
23582362
},

0 commit comments

Comments
 (0)