Rootly

Устраняйте инциденты в продакшене быстрее с интеграцией Rootly в IDE. Доступ к Rootly API, настройка путей и повышение безопасности. Интеграция с Cursor, Windsurf и другими! Получите API-ключ сегодня.

Разработка API Инструменты разработчика Совместная работа ★ 53 GitHub (53 ★)

Rootly предоставляет MCP-сервер, интегрируемый с API Rootly, что позволяет разработчикам устранять инциденты в продакшне прямо из своих любимых MCP-совместимых редакторов, таких как Cursor и Windsurf. Сервер динамически генерирует MCP-ресурсы на основе OpenAPI-спецификации Rootly, оптимизируя процесс разрешения инцидентов. Ограничение числа доступных путей API уменьшает размер контекста и повышает безопасность, фокусируясь на управлении инцидентами и оповещениями.

Ключевые возможности

01Динамически генерируемые MCP-инструменты на основе OpenAPI-спецификации Rootly

02Совместимость с MCP-редакторами, такими как Cursor и Windsurf

03Пагинация по умолчанию для конечных точек инцидентов, предотвращающая переполнение контекстного окна

04Возможность настройки разрешённых путей API

05Ограничение количества путей API, доступных ИИ-агенту, для повышения безопасности и управления контекстом

0653 звезды на GitHub

Примеры использования

01Устранение инцидентов в продакшне прямо из вашей IDE

02Интеграция возможностей управления инцидентами Rootly в рабочие процессы разработки

03Настройка доступа к API для ИИ-агентов, работающих с данными об инцидентах

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

Run it in your IDE

Install with our PyPi package or by cloning this repo.

To set it up in your favorite MCP-compatible editor (we tested it with Cursor and Windsurf), here is the config :

{
  "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 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

We limited the number of API paths exposed for 2 reasons

Context size: because Rootly's API is very rich in paths, AI agents can get overwhelmed and not perform simple actions properly. As of now we only expose the /incidents and /incidents/{incident_id}/alerts.
Security: if you want to limit the type of information or actions that users can access through the MCP server

If you want to make more path available, edit the variable allowed_paths in src/rootly_mcp_server/server.py.

Disclaimer

This project is a prototype and not intended for production use. If you have featured ideas or spotted some issues, feel free to submit a PR or open an issue.

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. We operate as an open-source incubator, sharing ideas, experimenting, and rapidly prototyping. We're committed to ensuring our research benefits the entire community.

Rootly MCP Server

MCP-сервер для интеграции с API Rootly. Позволяет управлять инцидентами прямо из редактора кода (Cursor, Windsurf, Claude) — без переключения контекста.

Установка

Требования:

Python 3.12 или выше
Менеджер пакетов uv (установка: curl -LsSf https://astral.sh/uv/install.sh | sh)
API-токен Rootly (как получить — в документации Rootly)

Установить можно через PyPi или клонировав репозиторий.

Быстрый старт

Добавьте в конфигурацию MCP вашего редактора (пример для Cursor/Windsurf):

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

Если нужно расширить доступные пути API, клонируйте репозиторий и используйте локальный запуск:

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

Возможности

Динамическая генерация инструментов на основе OpenAPI-спецификации Rootly.
Пагинация по умолчанию (10 элементов) для эндпоинтов инцидентов — предотвращает переполнение контекстного окна.
Ограничение путей API — по умолчанию доступны только /incidents и /incidents/{incident_id}/alerts. Это сделано для:
- Уменьшения размера контекста (API Rootly очень богатое, AI-агенты могут путаться).
- Безопасности: вы сами решаете, какие данные и действия доступны через MCP.

Чтобы добавить больше путей, отредактируйте переменную allowed_paths в файле src/rootly_mcp_server/server.py.

Предупреждение

Это прототип, не предназначенный для production-использования. Если есть идеи или баги — создавайте issue или PR.

О Rootly AI Labs

Проект разработан Rootly AI Labs. Это open-source инкубатор, где исследуют и прототипируют решения для надёжности систем и операционного совершенства.

List Incident Alerts

List incident alerts **Path Parameters:** - **incident_id** (Required): No description. **Query Parameters:** - **include**: comma separated if needed. eg: environments,services,groups - **page...

Parameters

incident_idstring

Required

Attach Alert

Attach alerts to an incident from provided data **Path Parameters:** - **incident_id** (Required): No description. **Responses:** - **200** (Success): alert created - Content-Type: `applicatio...

Parameters

dataobject

Required

incident_idstring

Required

List Alerts

List alerts **Query Parameters:** - **include**: comma separated if needed. eg: environments,services,groups - **filter_status**: No description. - **filter_source**: No description. - **filter_...

Parameters

filter_groupsstring

Optional

Create Alert

Creates a new alert from provided data **Responses:** - **201** (Success): alert created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` - **401**: ...

Parameters

dataobject

Required

List Environments

List environments **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - **filter_slug**...

Parameters

sortstring

Optional

includestring

Optional

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Environment

Creates a new environment from provided data **Responses:** - **201** (Success): environment created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` ...

Parameters

dataobject

Required

List Functionalities

List functionalities **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - **filter_nam...

Parameters

sortstring

Optional

includestring

Optional

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Functionality

Creates a new functionality from provided data **Responses:** - **201** (Success): functionality created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ...

Parameters

dataobject

Required

List Workflows

List workflows **Query Parameters:** - **include**: comma separated if needed. eg: form_field_conditions,genius_tasks - **sort**: comma separated if needed. eg: created_at,updated_at - **page_num...

Parameters

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Workflow

Creates a new workflow from provided data **Responses:** - **201** (Success): admins can set 'locked' while creating a workflow - Content-Type: `application/vnd.api+json` - **Example:** ```jso...

List Incident Action Items

List incident action items **Path Parameters:** - **incident_id** (Required): No description. **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_s...

Parameters

includestring

Optional

incident_idstring

Required

Create Incident Action Item

Creates a new action item from provided data **Path Parameters:** - **incident_id** (Required): No description. **Responses:** - **201** (Success): incident_action_item created - Content-Type:...

Parameters

dataobject

Required

incident_idstring

Required

List Incident Types

List incident types **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_size**: No description. - **filter_slug**: No description. - **filter_name**...

Parameters

sortstring

Optional

includestring

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Incident Type

Creates a new incident_type from provided data **Responses:** - **201** (Success): incident_type created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ...

Parameters

dataobject

Required

List Services

List services **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - **filter_name**: No...

Parameters

sortstring

Optional

includestring

Optional

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Service

Creates a new service from provided data **Responses:** - **201** (Success): service created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` - **401...

Parameters

dataobject

Required

List Severities

List severities **Query Parameters:** - **include**: No description. - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - **filter_slug**: ...

Parameters

sortstring

Optional

includestring

Optional

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Severity

Creates a new severity from provided data **Responses:** - **201** (Success): severity created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` - **4...

Parameters

dataobject

Required

List Teams

List teams **Query Parameters:** - **include**: comma separated if needed. eg: users - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - *...

Parameters

sortstring

Optional

page_sizeinteger

Optional

filter_namestring

Optional

filter_slugstring

Optional

Create Team

Creates a new team from provided data **Responses:** - **201** (Success): team created - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` - **401**: re...

Parameters

dataobject

Required

List Users

List users **Query Parameters:** - **page_number**: No description. - **page_size**: No description. - **filter_search**: No description. - **filter_email**: No description. - **filter_created_...

Parameters

page_sizeinteger

Optional

page_numberinteger

Optional

filter_emailstring

Optional

Get Current User

Get current user **Responses:** - **200** (Success): user found - Content-Type: `application/vnd.api+json` - **Example:** ```json { "key": "value" } ``` - **401**: responds with unauthorize...

List Endpoints

List all available Rootly API endpoints with their descriptions.

Search Incidents

Search incidents with flexible pagination control. Use page_number=0 to fetch all matching results across multiple pages up to max_results. Use page_number>0 to fetch a specific page.

Parameters

Find Related Incidents

Find historically similar incidents to help with context and resolution strategies.

Parameters

incident_idstring

Required

Suggest Solutions

Suggest solutions based on similar resolved incidents. Provide either incident_id OR title/description.

Parameters

incident_idstring

Optional

incident_titlestring

Optional

incident_descriptionstring

Optional

Источник: https://mcpmarket.com/server/rootly

Ключевые возможности

Примеры использования

Rootly MCP Server

Prerequisites

Run it in your IDE

Features

Disclaimer

About the Rootly AI Labs

Rootly MCP Server

Установка

Быстрый старт

Возможности

Предупреждение

О Rootly AI Labs

Какие IDE совместимы с Rootly MCP Server?

В чем преимущества ограничения путей API?

Что такое Rootly MCP Server?

Могу ли я настроить пути API, доступные через MCP-сервер?

Как получить токен API Rootly?

List Incident Alerts

Parameters

Attach Alert

Parameters

List Alerts

Parameters

Create Alert

Parameters

List Environments

Parameters

Create Environment

Parameters

List Functionalities

Parameters

Create Functionality

Parameters

List Workflows

Parameters

Create Workflow

List Incident Action Items

Parameters

Create Incident Action Item

Parameters

List Incident Types

Parameters

Create Incident Type

Parameters

List Services

Parameters

Create Service

Parameters

List Severities

Parameters

Create Severity

Parameters

List Teams

Parameters

Create Team

Parameters

List Users

Parameters

Get Current User

List Endpoints

Search Incidents

Parameters

Find Related Incidents

Parameters

Suggest Solutions

Parameters

Комментарии