Cumulocity MCP Server

@Cumulocity-IoT

About Cumulocity MCP Server

A Python-based server that provides Cumulocity IoT platform functionality through the MCP (Model Control Protocol) interface.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cumulocity-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_c8y"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Cumulocity MCP Server?

A Python-based server that provides Cumulocity IoT platform functionality through the MCP (Model Control Protocol) interface. It enables seamless interaction with Cumulocity’s device management, measurements, and alarm systems for administrators and developers.

How to use Cumulocity MCP Server?

Install via pip install mcp-server-c8y or use uvx mcp-server-c8y. Configure environment variables (C8Y_BASEURL, C8Y_TENANT, C8Y_USER, C8Y_PASSWORD) and connect clients like Claude Desktop or Cursor. For deployment on a Cumulocity tenant, build a microservice deployment package using the provided script and upload it via the Cumulocity Administration UI.

Key features of Cumulocity MCP Server

List and filter devices with pagination options
Retrieve detailed device, child device, and fragment data
Fetch device measurements with ISO 8601 time filtering
Monitor active alarms filtered by severity
Evaluate JSONata expressions against JSON objects

Use cases of Cumulocity MCP Server

Query and filter devices in a Cumulocity instance from an MCP‑compatible client
Retrieve time‑bounded measurements for specific devices for analysis
Monitor and filter active alarms by severity level for incident response
Integrate Cumulocity data into AI assistants (e.g., Claude Desktop) for natural‑language queries

FAQ from Cumulocity MCP Server

How do I install Cumulocity MCP Server?

Use pip install mcp-server-c8y or run directly with uvx mcp-server-c8y. After installing, execute python -m mcp_server_c8y.

What environment variables are required for authentication?

Set C8Y_BASEURL, C8Y_TENANT, C8Y_USER, and C8Y_PASSWORD for stdio transport. For HTTP transport (e.g., Cursor), use a url and Authorization header with Base64‑encoded credentials.

Can Cumulocity MCP Server be deployed directly on the Cumulocity platform?

Yes. Build a microservice deployment package using ./scripts/buildcontainer.sh, which creates mcp-server-c8y.zip, then upload it via Administration > Ecosystem > Microservices in your Cumulocity tenant.

What transport methods are supported?

The server supports stdio transport (used with Claude Desktop via uvx) and HTTP/SSE transport (used when deployed as a microservice, e.g., https://<tenant>.cumulocity.com/service/mcp-server-c8y/mcp/).

What tools are available in Cumulocity MCP Server?

It provides tools for device management (Get Devices, Get Device by ID, Get Child Devices, Get Device Fragments), measurements (Get Device Measurements), alarms (Get Active Alarms), and a dynamic mapper (evaluate_jsonata_expression).

Frequently asked questions

How do I install Cumulocity MCP Server?

Use `pip install mcp-server-c8y` or run directly with `uvx mcp-server-c8y`. After installing, execute `python -m mcp_server_c8y`.

What environment variables are required for authentication?

Set `C8Y_BASEURL`, `C8Y_TENANT`, `C8Y_USER`, and `C8Y_PASSWORD` for stdio transport. For HTTP transport (e.g., Cursor), use a `url` and `Authorization` header with Base64‑encoded credentials.

Can Cumulocity MCP Server be deployed directly on the Cumulocity platform?

Yes. Build a microservice deployment package using `./scripts/buildcontainer.sh`, which creates `mcp-server-c8y.zip`, then upload it via **Administration > Ecosystem > Microservices** in your Cumulocity tenant.

What transport methods are supported?

The server supports stdio transport (used with Claude Desktop via `uvx`) and HTTP/SSE transport (used when deployed as a microservice, e.g., `https://<tenant>.cumulocity.com/service/mcp-server-c8y/mcp/`).

What tools are available in Cumulocity MCP Server?

Comments

Basic information

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep