domain_summary_tool

Generate a detailed summary of entities within a specified domain, including total count, state distribution, examples, and common attributes. Use this tool to preview available entities before querying or managing them in Home Assistant via Hass-MCP.

Instructions

Get a summary of entities in a specific domain

Args: domain: The domain to summarize (e.g., 'light', 'switch', 'sensor') example_limit: Maximum number of examples to include for each state

Returns: A dictionary containing: - total_count: Number of entities in the domain - state_distribution: Count of entities in each state - examples: Sample entities for each state - common_attributes: Most frequently occurring attributes

Examples: domain="light" - get light summary domain="climate", example_limit=5 - climate summary with more examples Best Practices: - Use this before retrieving all entities in a domain to understand what's available

Input Schema

Name	Required	Description	Default
`domain`	Yes
`example_limit`	No

Input Schema (JSON Schema)

{
  "properties": {
    "domain": {
      "title": "Domain",
      "type": "string"
    },
    "example_limit": {
      "default": 3,
      "title": "Example Limit",
      "type": "integer"
    }
  },
  "required": [
    "domain"
  ],
  "title": "domain_summary_toolArguments",
  "type": "object"
}

Hass-MCP