​
Overview

The Rootly MCP (Multiplayer Collaboration Protocol) Server enables you to resolve production incidents quickly within IDE environments like Cursor, Windsurf, and Claude. This open-source tool dynamically generates MCP resources from Rootly’s OpenAPI specification, providing seamless incident management capabilities within your development workflow.

This is a prototype developed by Rootly AI Labs and is not intended for production use.

​
Features

  • Dynamic Resource Generation: Automatically generates MCP resources from Rootly’s OpenAPI specification
  • Default Pagination: Provides built-in pagination (10 items) for incident endpoints
  • Security & Context Optimization: Limits exposed API paths for enhanced security and context management
  • IDE Integration: Works with popular development environments

​
Supported Endpoints

The server provides access to approximately 20-25 whitelisted API endpoints including:

  • Incidents: Access and manage incidents
  • Alerts: Manage alerts for specific incidents
  • Severities: Access severity configurations
  • Teams: Manage team information
  • Services: Access service configurations
  • And additional endpoints for comprehensive incident management

​
Prerequisites

  • Python 3.12 or higher
  • uv package manager
  • Valid Rootly API token

​
Installation

pip install rootly-mcp-server

​
Option 2: Connect to Hosted MCP Server

Connect directly to Rootly’s hosted MCP server without any local installation:

{
  "mcpServers": {
    "rootly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rootly.com/sse",
        "--header",
        "Authorization:${ROOTLY_AUTH_HEADER}"
      ],
      "env": {
        "ROOTLY_AUTH_HEADER": "Bearer <YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}

This option provides:

  • Zero installation and maintenance overhead
  • Always up-to-date with the latest features
  • Managed infrastructure and reliability
  • Immediate access without local setup

​
Option 3: Self-Hosted Deployment

For organizations requiring full control over their deployment:

git clone https://github.com/Rootly-AI-Labs/Rootly-MCP-server
cd Rootly-MCP-server
uv pip install .

This option allows you to:

  • Host the MCP server on your own infrastructure
  • Customize the server configuration and endpoints
  • Ensure compliance with internal security policies
  • Control data flow and API access patterns

​
Configuration

​
For PyPI Installation (Option 1)

Add the following configuration to your MCP client configuration file:

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

​
Getting Your API Token

For all installation options, you’ll need a Rootly API token. Generate one in Account > Manage API keys > Generate New API Key.

  • For Option 1 & 3: Use the token directly as ROOTLY_API_TOKEN
  • For Option 2: Use the token with Bearer prefix in ROOTLY_AUTH_HEADER

​
Developer Setup

For development and testing purposes:

  1. Install dependencies:

    uv pip install .

  2. Create virtual environment:

    uv venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

  3. Run test client:

    python test_mcp_client.py

​
Customization

You can customize which API paths are exposed by modifying the configuration in src/rootly_mcp_server/server.py. This allows you to control which Rootly API endpoints are available through the MCP server.

​
Support

This integration is developed and maintained by Rootly AI Labs as an open-source project under the Apache-2.0 license. The project focuses on system reliability and operational excellence, and welcomes community contributions and feedback.

For questions or issues: