Skip to main content

​
Overview

The Rootly MCP (Model Context 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.