manage-mqtt-subscriptionslisted

# manage-mqtt-subscriptions List, add, update, or remove MQTT subscriptions for a TopicGate broker profile. ## 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_subscriptions` | read-only | List persisted subscriptions for a broker | | `add_subscription` | control | Add and apply a new MQTT subscription | | `update_subscription` | control | Replace an existing subscription filter | | `remove_subscription` | control | Delete a subscription (destructive) | Mutation tools (`add_subscription`, `update_subscription`, `remove_subscription`) are only available when the server runs with `--mode control`. If they are missing, tell the user: > Subscription management requires control mode. Reconfigure the server with > `"args": ["--mode", "control"]` and restart. ## Listing subscriptions (read-only) Call `list_subscriptions` with `broker_id` (UUID or unique case-insensitive name). Report each subscription's `topic_filter`, `qos`, `retain_as_published`, and `retain_handling`. ## Adding a subscription Call `add_subscription`: | Parameter | Required | Default | Description | |---|---|---|---| | `broker_id` | yes | | Broker UU