Cumulocity MCP Server
Cumulocity-IoTLABSCO SUMMARY
Natural-language control over a fleet you already run.
Because this is the platform's own bridge, what the assistant can reach is exactly what the API key can reach — and that includes commands that change device state, not just questions about it. Give it a key scoped to the devices you actually want an assistant touching.
What it is
The ThingsPanel team's own bridge between the platform and an AI model: a lightweight middleware that lets an assistant look devices up, read what they recorded, work through alarms and send control commands.
What you get
- Devices found and managed by description, instead of hunting for an identifier first
- Historical readings for a device pulled into the conversation
- Alarms surfaced and handled in the same thread
- Control commands sent to a device
- Stdio and SSE transports
- A modular tool layer — the parts you do not want stay switched off
Requirements
A ThingsPanel platform and an API key for it, exported as THINGSPANEL_API_KEY. Installs from PyPI with pip install thingspanel-mcp and runs as thingspanel-mcp, on Python 3.8 or newer; Docker and Docker Compose are supported too. Apache License 2.0.
Setup effort
One command plus a key — pip install thingspanel-mcp, then supply credentials
USE CASES
01
Finding out what a device has been doing
Name the device in the conversation and ask for its recent readings; the history comes back without opening the platform's UI.
02
Working through an alarm someone forwarded to you
Pull the alarm and the device behind it into one thread, so the reading that triggered it and the response sit together.
03
Sending a command without hunting for the device page
Describe the device and the command; the server issues the control call through the platform.
BEFORE YOU INSTALL
What to know first
Requires
- thingspanel-mcp on PATH
- Python 3.8+
- THINGSPANEL_API_KEY in your environment
- THINGSPANEL_BASE_URL in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install thingspanel-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"thingspanel": {
"command": "thingspanel-mcp",
"args": [
"--api-key",
"<YOUR_API_KEY>",
"--base-url",
"<YOUR_BASE_URL>"
]
}
}
}
