📌Overview

Purpose: The Rootly MCP Server serves as a bridge between Rootly API and various MCP-compatible editors, enabling quick resolution of production incidents directly from the IDE.

Overview: This server enables integration with the Rootly API, allowing users to address production incidents efficiently without leaving their development environment. By using the Rootly MCP Server, developers can manage incidents swiftly, leveraging dynamic MCP tools generated from Rootly's OpenAPI specification.

Key Features:

Dynamic MCP Tools: Automatically generates tools based on Rootly's OpenAPI specification, providing real-time access to incident management features.
Default Pagination: Implements pagination for incident endpoints to manage context size effectively, limiting the number of items displayed to avoid overwhelming users.
Controlled API Exposure: Only exposes specific API paths to enhance security and maintain focus on essential functionalities, currently limited to handling incidents and alerts.

Rootly MCP Server

An MCP server for Rootly API that you can plug into your favorite MCP-compatible editors like Cursor, Windsurf, and Claude. Resolve production incidents in under a minute without leaving your IDE.

Prerequisites

Python 3.12 or higher

uv package manager

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

Rootly API token (see https://docs.rootly.com/api-reference/overview#how-to-generate-an-api-key%3F)

Run it in your IDE

Install with our PyPi package or by cloning this repo.

To set it up in your MCP-compatible editor (tested with Cursor and Windsurf), use this config:

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

To customize allowed_paths for more Rootly API paths, clone the package and use this config:

{
  "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 generated MCP tools based on Rootly's OpenAPI specification
Default pagination (10 items) for incident endpoints to prevent context window overflow
Limits the number of API paths exposed to the AI agent

Why limit API paths?

Context size: Rootly's API is very rich in paths, which can overwhelm AI agents and affect performance. Currently, only the /incidents and /incidents/{incident_id}/alerts endpoints are exposed.
Security: To control the type of information or actions users can access through the MCP server.

To expose more paths, edit the allowed_paths variable in src/rootly_mcp_server/server.py.

Disclaimer

This project is a prototype and not intended for production use. Contributions and issue reports are welcome.

About the Rootly AI Labs

This project was developed by the Rootly AI Labs. The AI Labs is building the future of system reliability and operational excellence through open-source incubator efforts, sharing ideas, experimenting, and rapid prototyping to benefit the community.

Rootly-MCP-server