Rootly Incident Management MCP Server

MonitoringPython

Resolve production incidents without leaving your IDE

Available Tools

list_incidents

List incidents from Rootly with pagination (default 10 items)

pageper_page

get_incident

Get details of a specific incident by ID

incident_id

list_incident_alerts

List alerts associated with a specific incident

incident_idpageper_page

Rootly MCP Server provides seamless integration with Rootly's incident management platform directly within your favorite MCP-compatible code editors like Cursor, Windsurf, and Claude. This integration allows developers and SREs to view, manage, and resolve production incidents without context switching between tools. The server dynamically generates MCP resources based on Rootly's OpenAPI specification, providing access to critical incident data with sensible defaults like pagination to prevent context window overflow. By bringing incident management capabilities directly into your development environment, Rootly helps teams resolve production issues faster and more efficiently.

Installation

Prerequisites

Python 3.12 or higher
uv package manager (install with curl -LsSf https://astral.sh/uv/install.sh | sh)
A Rootly API token (generate one from your Rootly account)

Installation Options

Option 1: Install via PyPI (Recommended)

The simplest way to install Rootly MCP Server is through PyPI:

pip install rootly-mcp-server

Option 2: Clone the Repository

For more customization options, you can clone the repository:

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

Configuration

To set up Rootly MCP Server in your MCP-compatible editor (such as Cursor or Windsurf), add the following configuration:

Basic Configuration (PyPI Installation)

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

Custom Configuration (Repository Clone)

If you want to customize the allowed API paths or other settings, use this configuration after cloning the repository:

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

Usage

Once configured, you can interact with Rootly directly from your AI-assisted editor. For example, you can:

List recent incidents
View incident details
Check incident alerts
Manage incident status

The server is configured with sensible defaults:

Default pagination (10 items) for incident endpoints to prevent context window overflow
Limited API paths exposure for better AI agent performance and security

Customization

By default, the server only exposes the /incidents and /incidents/{incident_id}/alerts endpoints from Rootly's API. This limitation helps prevent context overflow and improves AI agent performance.

If you need access to additional Rootly API endpoints, you can modify the allowed_paths variable in src/rootly_mcp_server/server.py after cloning the repository.

Troubleshooting

If you encounter issues:

Verify your Rootly API token is correct and has the necessary permissions
Check that you're using Python 3.12 or higher
Ensure the uv package manager is properly installed
Confirm your editor's MCP configuration is correct

For more help, visit the Rootly AI Labs GitHub repository or submit an issue.