get_assets
Get a filtered list of assets including devices from Cumulocity.
LABSCO SUMMARY
A fleet you can ask about in a sentence.
Devices, measurements and alarms are the three things anyone opens the Cumulocity UI for. Having the JSONata evaluator beside them matters if you write Dynamic Mapper transformations, because an expression can be tested against a real payload without leaving the conversation.
What it is
A Python MCP server for the Cumulocity IoT platform, covering device management, measurements and alarms, run locally or deployed into the tenant as a microservice.
What you get
- Devices listed and filtered by type and name, a page at a time
- A single device fetched by id, with its child devices and its fragments
- Measurements for a device across a date range you give
- Active alarms filtered by severity
- JSONata expressions evaluated against a JSON object, for working out Dynamic Mapper transformations
Requirements
uvx, or pip install mcp-server-c8y and run it as python -m mcp_server_c8y. To run it inside the tenant instead, build mcp-server-c8y.zip with the provided script — that needs Docker and zip — and upload it as a microservice.
Setup effort
One command plus credentials — pip install mcp-server-c8y, then supply credentials
USE CASES
01
Finding a device when you only half know its name
Filter the device list by name or type instead of paging through the inventory.
02
Reading what a sensor reported overnight
Pull measurements for that device between two timestamps.
03
Seeing what is alarming right now
List active alarms filtered to the severity you actually respond to.
04
Walking down a device's children
Fetch the parent, then its child devices and fragments, rather than clicking through the hierarchy.
05
Getting a JSONata expression right first time
Evaluate it against a real payload before wiring it into a Dynamic Mapper mapping.
8 tools
Listed in project code.
get_child_devices
Get child devices of a specific device.
get_device_context
Get comprehensive context for a specific device.
get_device_measurements
Get the latest measurements for a specific device.
get_alarms
Get alarms across the platform or for a specific device (optionally including children).
get_events
Get events for a specific device (optionally including children). Platform-wide queries are not allowed.
get_asset_hierarchy
Get the complete asset hierarchy for a specific asset or device by retrieving all parent managed objects.
evaluate_jsonata_expression
Test a JSONata expression against a JSON string.
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools registered in the project's code.
Requires
- Python 3.10 or later
- uvx on PATH
- C8Y_BASEURL and C8Y_TENANT for your Cumulocity tenant
- C8Y_PASSWORD in your environment
- C8Y_USER in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install mcp-server-c8yMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-c8y": {
"command": "uvx",
"args": [
"mcp-server-c8y",
"--transport",
"stdio"
],
"env": {
"C8Y_BASEURL": "<YOUR_C8Y_BASEURL>",
"C8Y_TENANT": "<YOUR_C8Y_TENANT>",
"C8Y_USER": "<YOUR_C8Y_USER>",
"C8Y_PASSWORD": "<YOUR_C8Y_PASSWORD>"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"Cumulocity": {
"url": "<YOUR_C8Y_BASEURL>/service/mcp-server-c8y/mcp/",
"headers": {
"Authorization": "Basic <YOUR_BASE64_AUTH_TOKEN>"
}
}
}
}
