MCP server for Sparkplug B: node/device discovery, metrics, commands, host state over MQTT.
Connect Runs on your machine
claude mcp add sparkplug-b -e SPARKPLUG_MQTT_HOST=<SPARKPLUG_MQTT_HOST> -e SPARKPLUG_HOST_ID=<SPARKPLUG_HOST_ID> -e SPARKPLUG_MQTT_PORT=<SPARKPLUG_MQTT_PORT> -e SPARKPLUG_MQTT_USERNAME=<SPARKPLUG_MQTT_USERNAME> -e SPARKPLUG_MQTT_PASSWORD=<SPARKPLUG_MQTT_PASSWORD> -e SPARKPLUG_MQTT_USE_TLS=<SPARKPLUG_MQTT_USE_TLS> -e SPARKPLUG_GROUP_ID=<SPARKPLUG_GROUP_ID> -- uvx sparkplug-b-mcp-server==0.1.0
{
"mcpServers": {
"sparkplug-b": {
"command": "uvx",
"args": [
"sparkplug-b-mcp-server==0.1.0"
],
"env": {
"SPARKPLUG_MQTT_HOST": "<SPARKPLUG_MQTT_HOST>",
"SPARKPLUG_HOST_ID": "<SPARKPLUG_HOST_ID>",
"SPARKPLUG_MQTT_PORT": "<SPARKPLUG_MQTT_PORT>",
"SPARKPLUG_MQTT_USERNAME": "<SPARKPLUG_MQTT_USERNAME>",
"SPARKPLUG_MQTT_PASSWORD": "<SPARKPLUG_MQTT_PASSWORD>",
"SPARKPLUG_MQTT_USE_TLS": "<SPARKPLUG_MQTT_USE_TLS>",
"SPARKPLUG_GROUP_ID": "<SPARKPLUG_GROUP_ID>"
}
}
}
}
{
"mcpServers": {
"sparkplug-b": {
"command": "uvx",
"args": [
"sparkplug-b-mcp-server==0.1.0"
],
"env": {
"SPARKPLUG_MQTT_HOST": "<SPARKPLUG_MQTT_HOST>",
"SPARKPLUG_HOST_ID": "<SPARKPLUG_HOST_ID>",
"SPARKPLUG_MQTT_PORT": "<SPARKPLUG_MQTT_PORT>",
"SPARKPLUG_MQTT_USERNAME": "<SPARKPLUG_MQTT_USERNAME>",
"SPARKPLUG_MQTT_PASSWORD": "<SPARKPLUG_MQTT_PASSWORD>",
"SPARKPLUG_MQTT_USE_TLS": "<SPARKPLUG_MQTT_USE_TLS>",
"SPARKPLUG_GROUP_ID": "<SPARKPLUG_GROUP_ID>"
}
}
}
}
{
"servers": {
"sparkplug-b": {
"type": "stdio",
"command": "uvx",
"args": [
"sparkplug-b-mcp-server==0.1.0"
],
"env": {
"SPARKPLUG_MQTT_HOST": "<SPARKPLUG_MQTT_HOST>",
"SPARKPLUG_HOST_ID": "<SPARKPLUG_HOST_ID>",
"SPARKPLUG_MQTT_PORT": "<SPARKPLUG_MQTT_PORT>",
"SPARKPLUG_MQTT_USERNAME": "<SPARKPLUG_MQTT_USERNAME>",
"SPARKPLUG_MQTT_PASSWORD": "<SPARKPLUG_MQTT_PASSWORD>",
"SPARKPLUG_MQTT_USE_TLS": "<SPARKPLUG_MQTT_USE_TLS>",
"SPARKPLUG_GROUP_ID": "<SPARKPLUG_GROUP_ID>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
SPARKPLUG_MQTT_HOSTRequired | MQTT broker hostname or IP. |
SPARKPLUG_HOST_IDRequired | This connector's Sparkplug Host Application ID (used in the spBv1.0/STATE/{id} topic). |
SPARKPLUG_MQTT_PORTOptional | MQTT broker port, default 1883 |
SPARKPLUG_MQTT_USERNAMEOptional | Broker username, if required |
SPARKPLUG_MQTT_PASSWORDOptional, secret | Broker password, if required |
SPARKPLUG_MQTT_USE_TLSOptional | true/false, default false |
SPARKPLUG_GROUP_IDOptional | Restrict discovery/watching to a single Sparkplug Group ID; omit to subscribe to every group |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 4 Aug 2026 |
| Last updated | 4 Aug 2026 |
| Registry name | io.github.nagarjunr/sparkplug-b |
More data and analytics servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
