Rootly AI Labs Rootly MCP Server

🚀 Rootly MCP Server

A MCP server designed for the Rootly API. Integrate it into your favorite MCP-compatible editors like Cursor, Windsurf, and Claude to resolve production incidents in under a minute without leaving your IDE.

🚀 Quick Start

Prerequisites

• Python 3.12 or higher
• uv package manager. Install it with the following command:

curl -LsSf https://astral.sh/uv/install.sh | sh

• Rootly API Token

Installation and Configuration

Install the server via our PyPi package or by cloning this repository.

To set it up in your favorite MCP-compatible editor (we've tested Cursor and Windsurf), use the following configuration:

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": [
        "--from",
        "rootly-mcp-server",
        "rootly-mcp-server"
      ],
      "env": {
        "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

If you want to customize allowed_paths to access more Rootly API paths, clone the package and use this configuration:

{
    "mcpServers": {
      "rootly": {
        "command": "uv",
        "args": [
          "run",
          "--directory",
          "/path/to/rootly-mcp-server",
          "rootly-mcp-server"
        ],
        "env": {
          "ROOTLY_API_TOKEN": "<YOUR_ROOTLY_API_TOKEN>"
        }
      }
    }
  }

✨ Features

This server dynamically generates MCP resources based on Rootly's OpenAPI (Swagger) specification:

• Dynamically generate MCP tools according to Rootly's OpenAPI specification.
• Implement default pagination (10 items) to prevent context window overflow.
• Limit the number of API paths exposed to AI agents.

We limit the number of accessible paths for the following reasons:

• Context Size: Since Rootly's API contains a large number of paths, AI agents may be overloaded and unable to perform simple operations correctly. Currently, we only expose the /incidents and /incidents/{incident_id}/alerts paths.
• Security: If you want to restrict the types of information or operations that users can access through the MCP server.

If you need to enable more paths, edit the allowed_paths variable in src/rootly_mcp_server/server.py.

📄 Disclaimer

This project is a prototype and is not suitable for production environments. If you have any feature suggestions or find some issues, feel free to submit a PR or open an Issue.

🔧 About Rootly AI Labs

This project is developed by Rootly AI Labs. The AI Labs are building the future of system reliability and operational excellence. We operate as an open-source incubator, sharing ideas, conducting experiments, and prototyping rapidly. We are committed to ensuring that our research benefits the entire community.