Rootly Mcp Server

O que é o Servidor Rootly MCP?

O Servidor Rootly MCP é uma plataforma inovadora projetada para simplificar e melhorar a gestão de recursos e serviços em nuvem. Ele fornece um hub centralizado para desenvolvedores e equipes de TI monitorarem, controlarem e otimizarem sua infraestrutura em nuvem de forma eficiente. Com sua interface amigável e recursos robustos, o Servidor Rootly MCP simplifica operações complexas em nuvem, tornando-as acessíveis para equipes de todos os tamanhos.

Recursos do Servidor Rootly MCP

• Gestão Centralizada: Gerencie todos os seus recursos em nuvem a partir de um único painel, permitindo uma supervisão e controle mais fáceis.
• Monitoramento em Tempo Real: Receba atualizações instantâneas sobre o desempenho e a saúde dos seus serviços em nuvem, permitindo uma gestão proativa.
• Alertas Automatizados: Configure notificações para eventos críticos, garantindo que sua equipe esteja sempre informada sobre mudanças ou problemas importantes.
• Escalabilidade: Escale facilmente seus recursos em nuvem para cima ou para baixo com base nas necessidades do seu projeto, otimizando custos e desempenho.
• Interface Amigável: Projetada com a usabilidade em mente, a plataforma permite que os usuários naveguem e gerenciem recursos sem esforço.
• Capacidades de Integração: Integre-se perfeitamente com várias ferramentas e serviços de terceiros para aprimorar a funcionalidade e simplificar fluxos de trabalho.

Como Usar o Servidor Rootly MCP

1. Inscreva-se: Crie uma conta na plataforma do Servidor Rootly MCP.
2. Conecte Seus Serviços em Nuvem: Vincule suas contas em nuvem existentes ao Servidor Rootly MCP para gestão centralizada.
3. Configure as Configurações: Personalize seu painel e configure alertas de acordo com as necessidades da sua equipe.
4. Monitore o Desempenho: Use as ferramentas de monitoramento em tempo real para acompanhar seus recursos em nuvem e métricas de desempenho.
5. Otimize Recursos: Analise padrões de uso e ajuste seus recursos para garantir desempenho e custo-efetividade ideais.

Perguntas Frequentes

Q: Que tipos de serviços em nuvem posso gerenciar com o Servidor Rootly MCP?

A: O Servidor Rootly MCP suporta uma ampla gama de serviços em nuvem, incluindo AWS, Azure e Google Cloud, permitindo que você gerencie vários recursos de diferentes provedores em um só lugar.

Q: Existe um teste gratuito disponível?

A: Sim, o Servidor Rootly MCP oferece um teste gratuito para novos usuários explorarem seus recursos e capacidades antes de se comprometerem com uma assinatura.

Q: Posso integrar o Servidor Rootly MCP com outras ferramentas?

A: Absolutamente! O Servidor Rootly MCP suporta integração com inúmeras aplicações de terceiros, aprimorando sua funcionalidade e permitindo um fluxo de trabalho mais simplificado.

Q: Como o Servidor Rootly MCP garante a segurança dos dados?

A: O Servidor Rootly MCP emprega medidas de segurança padrão da indústria, incluindo criptografia e protocolos de acesso seguro, para proteger seus dados e garantir conformidade com regulamentos.

Q: Quais opções de suporte estão disponíveis?

A: O Servidor Rootly MCP oferece várias opções de suporte, incluindo documentação, fóruns comunitários e suporte ao cliente direto para quaisquer perguntas ou problemas.

Rootly MCP Server

An MCP server for the Rootly API that integrates seamlessly with 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

Installation

Configure your MCP-compatible editor (tested with Cursor) with one of the configurations below. The package will be automatically downloaded and installed when you first open your editor.

With uv

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

With uvx

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

To customize allowed_paths and access additional Rootly API paths, clone the repository and use this configuration:

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

Connect to Hosted MCP Server

Alternatively, connect directly to our hosted MCP server:

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

Features

• Dynamic Tool Generation: Automatically creates MCP resources from Rootly's OpenAPI (Swagger) specification
• Smart Pagination: Defaults to 10 items per request for incident endpoints to prevent context window overflow
• API Filtering: Limits exposed API endpoints for security and performance
• AI-Powered Incident Analysis: Smart tools that learn from historical incident data
  • find_related_incidents: Uses TF-IDF similarity analysis to find historically similar incidents
  • suggest_solutions: Mines past incident resolutions to recommend actionable solutions
• MCP Resources: Exposes incident and team data as structured resources for easy AI reference
• Intelligent Pattern Recognition: Automatically identifies services, error types, and resolution patterns

Whitelisted Endpoints

By default, the following Rootly API endpoints are exposed to the AI agent (see allowed_paths in src/rootly_mcp_server/server.py):

/v1/incidents
/v1/incidents/{incident_id}/alerts
/v1/alerts
/v1/alerts/{alert_id}
/v1/severities
/v1/severities/{severity_id}
/v1/teams
/v1/teams/{team_id}
/v1/services
/v1/services/{service_id}
/v1/functionalities
/v1/functionalities/{functionality_id}
/v1/incident_types
/v1/incident_types/{incident_type_id}
/v1/incident_action_items
/v1/incident_action_items/{incident_action_item_id}
/v1/incidents/{incident_id}/action_items
/v1/workflows
/v1/workflows/{workflow_id}
/v1/workflow_runs
/v1/workflow_runs/{workflow_run_id}
/v1/environments
/v1/environments/{environment_id}
/v1/users
/v1/users/{user_id}
/v1/users/me
/v1/status_pages
/v1/status_pages/{status_page_id}

Why Path Limiting?

We limit exposed API paths for two key reasons:

1. Context Management: Rootly's comprehensive API can overwhelm AI agents, affecting their ability to perform simple tasks effectively
2. Security: Controls which information and actions are accessible through the MCP server

To expose additional paths, modify the allowed_paths variable in src/rootly_mcp_server/server.py.

AI-Powered Smart Tools

The MCP server includes intelligent tools that analyze historical incident data to provide actionable insights:

find_related_incidents

Finds historically similar incidents using machine learning text analysis:

find_related_incidents(incident_id="12345", similarity_threshold=0.3, max_results=5)

• Input: Incident ID, similarity threshold (0.0-1.0), max results
• Output: Similar incidents with confidence scores, matched services, and resolution times
• Use Case: Get context from past incidents to understand patterns and solutions

suggest_solutions

Recommends solutions by analyzing how similar incidents were resolved:

suggest_solutions(incident_id="12345", max_solutions=3)
### OR for new incidents:
suggest_solutions(incident_title="Payment API errors", incident_description="Users getting 500 errors during checkout")

• Input: Either incident ID OR title/description text
• Output: Actionable solution recommendations with confidence scores and time estimates
• Use Case: Get AI-powered suggestions based on successful past resolutions

How It Works

• Text Similarity: Uses TF-IDF vectorization and cosine similarity (scikit-learn)
• Service Detection: Automatically identifies affected services from incident text
• Pattern Recognition: Finds common error types, resolution patterns, and time estimates
• Fallback Mode: Works without ML libraries using keyword-based similarity
• Solution Mining: Extracts actionable steps from resolution summaries

Data Requirements

For optimal results, ensure your Rootly incidents have descriptive:

• Titles: Clear, specific incident descriptions
• Summaries: Detailed resolution steps when closing incidents
• Service Tags: Proper service identification

Example good resolution summary: "Restarted auth-service, cleared Redis cache, and increased connection pool from 10 to 50"

About Rootly AI Labs

This project was developed by Rootly AI Labs, where we're building the future of system reliability and operational excellence. As an open-source incubator, we share ideas, experiment, and rapidly prototype solutions that benefit the entire community.

Developer Setup & Troubleshooting

Prerequisites

• Python 3.12 or higher
• uv for dependency management

1. Set Up Virtual Environment

Create and activate a virtual environment:

uv venv .venv
source .venv/bin/activate  # Always activate before running scripts

2. Install Dependencies

Install all project dependencies:

uv pip install .

To add new dependencies during development:

uv pip install <package>

3. Verify Installation

The server should now be ready to use with your MCP-compatible editor.

For developers: Additional testing tools are available in the tests/ directory.