get-mcp-snapshotlisted

# get-mcp-snapshot Use the `topicgate` MCP server to retrieve the latest observed MQTT state for a broker. Requires: TopicGate ≥ 1.0.0 (`pip install topicgate`). ## MCP server not available If the `topicgate` MCP server is not connected or `get_broker_snapshot` cannot be found, stop and tell the user: > The TopicGate MCP server is not active. To fix this: > > 1. Install TopicGate: `pip install topicgate` > 2. Verify the executable is on PATH: `topicgate --help` > If not found, use the full path to the virtual-environment binary, e.g. > `.venv/bin/topicgate` (Linux/macOS) or `.venv\Scripts\topicgate.exe` (Windows), > and set `"command"` in your harness config accordingly. > 3. Add the server to your MCP harness configuration: > ```json > { "mcpServers": { "topicgate": { "command": "topicgate", "args": ["--mode", "read-only"] } } } > ``` > 4. Restart your MCP harness. Do not attempt to call any other tool as a substitute. ## Calling the tool Tool: `get_broker_snapshot` | Parameter | Required | Description | |---|---|---| | `broker` | yes | Broker UUID or unique case-insensitive profile name | | `topic_filter` | no | MQTT wildcard filter, default `#` (all topics) | | `max_age_seconds` | no | Omit values older than this; omitting returns all cached values | | `limit` | no | Max number of topic results returned | | `payload_limit_bytes` | no | Truncate individual payloads above this size | Call `get_broker_snapshot` directly with the user-supplied UUID