manage-mqtt-brokerslisted
Install: claude install-skill Dumdart/TopicGate
# manage-mqtt-brokers
Discover, inspect, and switch between saved MQTT broker profiles in TopicGate.
## 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.
## Tools
| Tool | Mode | Purpose |
|---|---|---|
| `list_brokers` | read-only | List all saved broker profiles (UUID, name, host, port, active flag). Never exposes passwords. |
| `get_connection_status` | read-only | Connection state, dropped message count, and topic update interval for a broker. Omit `broker` to query the active profile. |
| `activate_broker` | control | Switch to a different broker profile. Disconnects the current client, changes the active profile, and connects over MQTT. |
## Listing and inspecting (read-only)
1. Call `list_brokers` to see all profiles.
2. Call `get_connection_status` with a broker UUID or name (or omit for the active one).
3. Report connection state, dropped messages, and update interval.
## Switching brokers (control mode)
`activate_broker` is only available when the server runs with `--mode control`.
1. Call `list_brokers` to confirm the target profile exists.
2. Call `activate_broker` with the broker UUID or name.
3. Verify with `get_connection_status` if the user wants confirma