inspect-mqtt-statelisted

# inspect-mqtt-state Build a full situational overview of a TopicGate broker: profiles, connection health, subscriptions, and latest observed values. ## MCP server not available If the `topicgate` MCP server is not connected or its tools cannot be found, stop and tell the user: > The TopicGate MCP server is not active. Install TopicGate (`pip install topicgate`) > and add the server to your MCP harness configuration, then restart the harness. Do not attempt to call any other tool as a substitute. ## Workflow 1. **Discover brokers** — call `list_brokers` to get all saved profiles with their UUIDs, names, host, port, and active flag. Never expose passwords. 2. **Check connection** — call `get_connection_status` for the broker of interest (omit `broker` to use the active profile). Report the connection state, dropped message count, and topic update interval. 3. **List subscriptions** — call `list_subscriptions` with the broker UUID or name. Report each filter, QoS, retain-as-published, and retain-handling setting. 4. **Snapshot values** — call `get_broker_snapshot` with the broker UUID or name. Inspect and report `freshness`, `completeness.is_complete`, `completeness.limitations`, result count, and any payload truncation. If a broker name is ambiguous or unknown at any step, fall back to the UUID returned by `list_brokers`. ## Tools used | Tool | Mode | Purpose | |---|---|---| | `list_brokers` | read-only | Discover profiles | | `get_connection_status