Multi-feature smart home MCP server providing tools for home appliance interactions, HVAC control, solar energy monitoring, door/video systems, lighting, and network management
SmartHaus exposes 5 read-only appliance tools via HTTP. All tools have basic descriptions (10-60 chars) and verb-noun naming (GetAllAppliances, GetApplianceState, etc.). However, descriptions are minimal and lack context for LLM selection. Input schemas are present for 4 of 5 tools but lack parameter descriptions, only 'deviceId' is documented. No output schemas are visible. No error handling guidance, no pagination support, and no tool annotations (readOnlyHint, etc.). The server follows HTTP transport correctly but lacks modern MCP patterns like structured output documentation and per-request _meta logLevel.
Retrieve all household appliances
Retrieve the available actions for an appliance
Retrieve the identity information of an appliance
Retrieve the available programs for an appliance
Retrieve the full state of an appliance by device ID
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Descriptions are too brief (10-60 chars). They lack context for when to use each tool and what distinguishes them. E.g., 'Retrieve the full state of an appliance' does not explain what 'full state' includes or when to call it vs GetApplianceIdentification.
GetAllAppliances has no input schema visible. Without a schema, LLMs cannot determine if pagination (limit, offset) is supported or what constraints apply.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
No error handling guidance. Tools do not document what happens on invalid deviceId, network failure, or appliance offline. LLMs have no recovery path.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). While all tools are read-only, explicit annotations would help clients optimize caching and retry logic.