{"openapi":"3.1.0","info":{"title":"SmartHomeGlossary API","version":"0.1.0","description":"A fully local, brand-neutral smart-home protocol reference: a real technical comparison of Zigbee, Z-Wave, Matter, and Thread, a device-compatibility concept explainer, and a glossary of smart-home terms. General technical reference only, never a recommendation for a specific product.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://smarthomeglossary.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/smarthomeglossary/docs"},"termsOfService":"https://connectorbay.com/smarthomeglossary/terms"},"servers":[{"url":"https://smarthomeglossary.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/smarthomeglossary/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/protocol_comparison":{"post":{"operationId":"protocol_comparison","summary":"A real technical comparison of Zigbee, Z-Wave, Matter, and Thread: frequency band, mesh/star topology,","description":"A real technical comparison of Zigbee, Z-Wave, Matter, and Thread: frequency band, mesh/star topology,\n    typical per-hop range, power consumption, max devices per network, hub/bridge requirements,\n    interoperability (including Matter's cross-ecosystem multi-admin feature), introduction year, governing\n    body, and best-fit use case. Use for \"what's the difference between Zigbee and Z-Wave\", \"is Matter better\n    than Zigbee\". Brand-neutral — protocols and standards only, never a specific product.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"protocols":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Filter to specific protocol names (e.g. ['zigbee', 'matter']); omit for all four.","title":"Protocols"}},"title":"protocol_comparisonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/device_compatibility_guide":{"post":{"operationId":"device_compatibility_guide","summary":"Explains device-compatibility concepts: hub requirements, bridge devices, what \"Matter over Thread\"","description":"Explains device-compatibility concepts: hub requirements, bridge devices, what \"Matter over Thread\"\n    means and why it needs a Thread Border Router, ecosystem/platform lock-in and Matter's multi-admin fix, and\n    how to check compatibility before buying. Use for \"do I need a hub for this\", \"what's a bridge device\",\n    \"will this work with my ecosystem\". Brand-neutral — concepts only, never a specific product.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific topic to look up (e.g. 'hub', 'matter over thread'); omit to list all.","title":"Topic"}},"title":"device_compatibility_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/smarthome_glossary":{"post":{"operationId":"smarthome_glossary","summary":"Plain-language definitions of core smart-home terms: hub, bridge, mesh network, coordinator,","description":"Plain-language definitions of core smart-home terms: hub, bridge, mesh network, coordinator,\n    controller, Thread Border Router, fabric, multi-admin, commissioning, scene, automation/automation\n    trigger, end device, mesh router, interoperability, and PAN. Use for \"what's a scene versus an\n    automation\", \"what does commissioning mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"smarthome_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}