Introducing mc8yp: An Open-Source MCP Server for Cumulocity IoT

Forum
, , , ,
1

Introducing mc8yp: An Open-Source MCP Server for Cumulocity IoT

I’m excited to share mc8yp, an open-source Model Context Protocol (MCP) server that brings AI-powered capabilities to Cumulocity IoT. Now available on GitHub.

Why mc8yp?

While working with Cumulocity IoT, I wanted a more flexible way to interact with my tenant data through AI agents. This led to building mc8yp with two distinct modes:

CLI Mode - Local Development & Debugging

The CLI mode is perfect for exploring and debugging your tenant data locally. What makes it special:

  • Secure credential storage using your OS’s native keyring (Keychain on macOS, Credential Vault on Windows, Secret Service on Linux)
  • Easy tenant switching - simply tell your AI agent which tenant you want to check, and it handles the rest
  • No credential files - everything is stored securely in your system’s credential manager
# Get started in seconds
npx mc8yp creds add
npx mc8yp

Microservice Mode - Production Ready

For production use, deploy mc8yp as a Cumulocity microservice:

  1. Download the latest microservice .zip package from GitHub
  2. Upload it to your tenant via Application Management
  3. Subscribe to the application
  4. The MCP endpoint will be available at: https://<your-tenant>.cumulocity.com/service/mc8yp-server/mcp

The /mcp endpoint integrates seamlessly with Cumulocity’s agents manager, automatically using service user permissions - no credential configuration needed.

What Can It Do?

mc8yp currently provides 20 tools and 17 pre-built prompts focused on:

  • Debugging workflows - Query devices, inspect alarms, trace events
  • Data aggregation - Measurement statistics, alarm counts, tenant usage
  • Inventory management - OData queries, device hierarchies, supported series
  • Audit & administration - User management, application details, audit logs

While other MCP servers exist, mc8yp extends the capabilities with additional debugging features and the flexible CLI mode for local development.

What’s Next?

This is just the beginning. mc8yp will continue to expand with more tools and capabilities based on community needs. I’m particularly interested in:

  • Additional data analysis tools
  • Device control operations
  • Smart rule management
  • Custom dashboard creation

Try It Out

# Install and run
npm install -g mc8yp
# Add your Cumulocity credentials
mc8yp creds add

Now connect it to your favorite AI agent, like Claude Desktop:

{
  "mcpServers": {
    "mc8yp": {
      "command": "npx",
      "args": ["-y", "mc8yp"]
    }
  }
}

I’d love to hear your feedback! Try it with your Cumulocity tenant and let me know what features you’d like to see. Issues and pull requests are always welcome.

mc8yp is open-source (MIT) and available on npm and GitHub.

5 Likes
2

Hi & welcome @schplitt !

Nice stuff and thank you for the open-source contribution, I will definitely give it a try!

I especially like the tools & prompts which are already provided ootb: GitHub - schplitt/mc8yp: Unofficial Cumulocity IoT MCP Server

3

+1 for the project name. Nicely played :smiley:

1 Like
4

Very interesting development! Thanks for sharing. Will definitely give it a try!