Rootly

Servidor MCP para a plataforma de gerenciamento de incidentes Rootly.

GitHub
45
Experimente este MCPPatrocinado

Documentação

Servidor MCP Rootly

PyPI version PyPI - Downloads Python Version

Um servidor MCP para a API Rootly para Cursor, Windsurf, Claude e outros clientes MCP.

Demo GIF

Início Rápido

Use o servidor MCP hospedado. Nenhuma instalação local é necessária.

Opções de Transporte Hospedado

  • Streamable HTTP (recomendado): https://mcp.rootly.com/mcp
  • SSE (alternativa estável): https://mcp.rootly.com/sse
  • Code Mode: https://mcp.rootly.com/mcp-codemode

Perfis de ferramentas hospedados:

  • Completo (padrão): use as URLs acima como estão
  • Enxuto (~70 ferramentas): adicione ?tool_profile=slim à URL hospedada, por exemplo https://mcp.rootly.com/mcp?tool_profile=slim
  • Alternativa de cabeçalho: envie X-Rootly-Tool-Profile: slim
  • Padrão global do servidor: defina ROOTLY_MCP_HOSTED_TOOL_PROFILE=full|slim
  • Substituição personalizada exata: defina ROOTLY_MCP_ENABLED_TOOLS=...

Configuração Remota Geral

Com OAuth2 (recomendado):

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp"
    }
  }
}

Seu cliente MCP lida com o login OAuth2 automaticamente — uma janela do navegador abre para você autenticar com a Rootly. Nenhum token de API é necessário.

Com Token de API:

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ROOTLY_API_TOKEN"
      }
    }
  }
}

SSE (alternativa):

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/sse"
    }
  }
}

Code Mode:

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp-codemode"
    }
  }
}

Configuração de Agentes

Claude Code

Com OAuth2 (recomendado):

claude mcp add --transport http rootly https://mcp.rootly.com/mcp

# Code Mode:
claude mcp add --transport http rootly-codemode https://mcp.rootly.com/mcp-codemode

Com Token de API:

claude mcp add --transport http rootly https://mcp.rootly.com/mcp \
  --header "Authorization: Bearer YOUR_ROOTLY_API_TOKEN"

Configuração Manual — Crie .mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "rootly": {
      "type": "http",
      "url": "https://mcp.rootly.com/mcp"
    }
  }
}
Gemini CLI

Instale a extensão:

gemini extensions install https://github.com/rootlyhq/rootly-mcp-server

Ou configure manualmente em ~/.gemini/settings.json:

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

Adicione a .cursor/mcp.json ou ~/.cursor/mcp.json:

Com OAuth2 (recomendado):

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp"
    }
  }
}

Com Token de API:

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}
Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

Com OAuth2 (recomendado):

{
  "mcpServers": {
    "rootly": {
      "serverUrl": "https://mcp.rootly.com/mcp"
    }
  }
}

Com Token de API:

{
  "mcpServers": {
    "rootly": {
      "serverUrl": "https://mcp.rootly.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ROOTLY_API_TOKEN>"
      }
    }
  }
}
Codex

Adicione a ~/.codex/config.toml:

Com OAuth2 (recomendado):

[mcp_servers.rootly]
url = "https://mcp.rootly.com/mcp"

Com Token de API:

[mcp_servers.rootly]
url = "https://mcp.rootly.com/mcp"
bearer_token_env_var = "ROOTLY_API_TOKEN"
Claude Desktop

Com OAuth2 (recomendado):

Adicione a claude_desktop_config.json:

{
  "mcpServers": {
    "rootly": {
      "url": "https://mcp.rootly.com/mcp"
    }
  }
}

O Claude Desktop lida com o login OAuth2 automaticamente.

Com Token de API (via mcp-remote):

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

CLI Rootly

CLI autônomo para operações de incidentes, alertas, serviços e plantão.

Instale via Homebrew:

brew install rootlyhq/tap/rootly-cli

Ou via Go:

go install github.com/rootlyhq/rootly-cli/cmd/rootly@latest

Para mais detalhes, consulte o repositório do CLI Rootly.

Instalação Alternativa (Local)

Execute o servidor MCP localmente se você não quiser usar o serviço hospedado.

Pré-requisitos

  • Python 3.12 ou superior
  • Gerenciador de pacotes uv 
    curl -LsSf https://astral.sh/uv/install.sh | sh
  • Token de API Rootly

Tipos de Token de API

Escolha o tipo de token com base no acesso necessário:

  • Chave de API Global: Acesso completo à instância Rootly. Melhor para visibilidade em toda a organização.
  • Chave de API de Equipe: Acesso limitado a entidades de propriedade dessa equipe.
  • Chave de API Pessoal: Acesso correspondente ao usuário que a criou.

Uma Chave de API Global é recomendada para consultas em toda a organização e para ações que modificam dados, especialmente quando os fluxos de trabalho podem abranger várias equipes, escalas ou incidentes.

Com uv

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

Opções de Transporte Auto-Hospedado

Escolha um transporte por processo de servidor:

  • Streamable HTTP caminho do endpoint: /mcp
  • SSE caminho do endpoint: /sse
  • Code Mode (experimental) caminho do endpoint: /mcp-codemode no modo de transporte duplo hospedado

As implantações hospedadas e auto-hospedadas agora expõem toda a superfície de ferramentas por padrão.

  • Padrão hospedado: superfície completa
  • Perfil enxuto hospedado: cerca de 70 ferramentas de alto uso via ?tool_profile=slim
  • Padrão auto-hospedado: superfície completa

Para restringir qualquer implantação a ferramentas somente leitura, inicie o servidor com --no-enable-write-tools ou defina ROOTLY_MCP_ENABLE_WRITE_TOOLS=false.

Para clientes hospedados que desejam o perfil remoto menor, acrescente ?tool_profile=slim à URL MCP ou envie X-Rootly-Tool-Profile: slim.

Telemetria AgentCat e Sentry

As implantações hospedadas podem enviar telemetria MCP para o AgentCat definindo ROOTLY_MCPCAT_PROJECT_ID. Para também exportar eventos do AgentCat para o Sentry, forneça SENTRY_DSN por meio do armazenamento de segredos da implantação. O opcional ENVIRONMENT tem como padrão production, e SENTRY_RELEASE tem como padrão a versão instalada do Servidor MCP Rootly. O rastreamento de desempenho do Sentry é ativado quando o exportador está configurado. O texto de eventos de formato livre é editado e os nomes dos atores são omitidos da telemetria destinada ao Sentry; IDs internos estáveis dos atores permanecem disponíveis para correlação.

A telemetria é executada no AgentCat v2 (especificação MCP 2026-07-28). As sessões são correlacionadas via um session_id transportado na lista de ferramentas, em vez de conexões com estado, o que se adequa ao nosso transporte hospedado sem estado; os eventos initialize e tools/list não são mais publicados pelo SDK.

Para substituir completamente o perfil padrão hospedado ou auto-hospedado, defina ROOTLY_MCP_ENABLED_TOOLS (ou passe --enabled-tools) com uma lista de permissões separada por vírgulas de nomes exatos de ferramentas. Quando essa variável é definida, ela substitui totalmente a seleção padrão.

Para expor apenas um subconjunto específico de ferramentas MCP em uma implantação auto-hospedada, defina ROOTLY_MCP_ENABLED_TOOLS (ou passe --enabled-tools) com uma lista de permissões separada por vírgulas de nomes exatos de ferramentas, por exemplo list_incidents,get_incident,get_server_version.

Verificação de domínio de aplicativos OpenAI

As implantações hospedadas expõem um endpoint de verificação de domínio não autenticado usado pelo diretório de plugins OpenAI:

  • Endpoint: GET /.well-known/openai-apps-challenge
  • Variável de ambiente: ROOTLY_OPENAI_APPS_CHALLENGE_TOKEN

Defina ROOTLY_OPENAI_APPS_CHALLENGE_TOKEN para o token gerado no portal de envio da OpenAI. O endpoint retorna esse token exato como text/plain (com Cache-Control: no-store) e retorna 404 quando a variável não está definida ou está vazia. O token é lido do ambiente no momento da solicitação — nunca codifique ou confirme-o. A rota é servida tanto nas implantações hospedadas de transporte duplo (--transport both) quanto nas de streamable HTTP com perfil e não está sujeita à autenticação Bearer.

Para descobrir os nomes exatos das ferramentas disponíveis na sua configuração auto-hospedada atual, execute:

ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
uv run python -m rootly_mcp_server --list-tools

Isso imprime os nomes efetivos das ferramentas MCP após aplicar suas configurações atuais, incluindo ROOTLY_MCP_ENABLE_WRITE_TOOLS e ROOTLY_MCP_ENABLED_TOOLS.

Teste de fumaça de uma lista de permissões auto-hospedada:

ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
ROOTLY_MCP_ENABLED_TOOLS=list_incidents,get_incident,get_server_version \
uv run python -m rootly_mcp_server --transport streamable-http --log-level ERROR

Em seguida, conecte um cliente MCP a http://127.0.0.1:8000/mcp e verifique se tools/list retorna apenas:

get_server_version
get_incident
list_incidents

Para incluir ferramentas de escrita específicas para testes auto-hospedados, adicione tanto o sinalizador de escrita quanto a lista de permissões:

ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
ROOTLY_MCP_ENABLE_WRITE_TOOLS=true \
ROOTLY_MCP_ENABLED_TOOLS=create_incident,create_workflow_task,list_teams \
uv run python -m rootly_mcp_server --transport streamable-http --log-level ERROR

Exemplo de execução Docker (Streamable HTTP):

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=streamable-http \
  -e ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
  -e ROOTLY_MCP_ENABLE_WRITE_TOOLS=true \
  rootly-mcp-server

Exemplo de execução Docker (SSE):

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=sse \
  -e ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
  rootly-mcp-server

Exemplo de execução Docker (Transporte duplo + Code Mode):

docker run -p 8000:8000 \
  -e ROOTLY_TRANSPORT=both \
  -e ROOTLY_API_TOKEN=<YOUR_ROOTLY_API_TOKEN> \
  rootly-mcp-server

Subconjuntos de Ferramentas Focados em Fluxos de Trabalho

A superfície completa hospedada e auto-hospedada expõe mais de 200 ferramentas. Se você quiser subconjuntos mais restritos e específicos para fluxos de trabalho, use ROOTLY_MCP_ENABLED_TOOLS:

🚨 Resposta a Incidentes (25 ferramentas)

Ferramentas essenciais para respondedores de emergência e comandantes de incidentes

ROOTLY_MCP_ENABLED_TOOLS="list_incidents,get_incident,create_incident,update_incident,search_incidents,find_related_incidents,suggest_solutions,create_incident_action_item,list_incident_action_items,update_incident_form_field_selection,list_teams,get_current_user,list_services,list_severities,get_alert,list_alerts,get_alert_by_short_id,list_escalation_policies,get_escalation_policy,list_on_call_roles,list_schedules,get_schedule_shifts,get_oncall_handoff_summary,get_shift_incidents,list_endpoints"

📅 Gerenciamento de Plantão (35 ferramentas)

Para coordenadores de escala e gerentes de plantão

ROOTLY_MCP_ENABLED_TOOLS="list_schedules,get_schedule,update_schedule,get_schedule_shifts,list_shifts,create_schedule_rotation,update_schedule_rotation,list_schedule_rotations,get_schedule_rotation,list_schedule_rotation_users,update_schedule_rotation_user,create_on_call_shadow,update_on_call_shadow,list_on_call_shadows,create_override_shift,update_override_shift,list_override_shifts,list_on_call_roles,update_on_call_role,get_oncall_schedule_summary,get_oncall_shift_metrics,check_oncall_health_risk,check_responder_availability,create_override_recommendation,list_teams,get_team,list_users,get_user,get_current_user,list_escalation_policies,update_escalation_policy,list_escalation_paths,update_escalation_path,list_escalation_levels"

📊 Monitoramento e Alertas (40 ferramentas)

Para equipes de plataforma que configuram observabilidade

ROOTLY_MCP_ENABLED_TOOLS="list_alerts,get_alert,get_alert_by_short_id,create_alert_group,update_alert_group,list_alert_groups,create_alert_routing_rule,update_alert_routing_rule,list_alert_routing_rules,list_alert_events,get_alert_event,update_alert_event,create_heartbeat,update_heartbeat,list_heartbeats,get_heartbeat,create_pulse,update_pulse,list_pulses,get_pulse,create_dashboard,update_dashboard,list_dashboards,get_dashboard,create_dashboard_panel,update_dashboard_panel,list_status_pages,get_status_page,update_status_page,list_status_page_templates,get_status_page_template,list_communications_templates,update_communications_template,create_live_call_router,update_live_call_router,list_services,list_teams,get_current_user,list_environments,list_severities,list_endpoints"

📋 Análise Pós-Incidente (30 ferramentas)

Para SREs que fazem retrospectivas e melhoria de processos

ROOTLY_MCP_ENABLED_TOOLS="get_incident,update_incident,find_related_incidents,suggest_solutions,list_incident_action_items,create_incident_action_item,update_incident_form_field_selection,create_post_incident_review,update_post_incident_review,list_post_incident_reviews,get_post_incident_review,create_retrospective_step,update_retrospective_step,list_retrospective_steps,create_retrospective_process,update_retrospective_process,list_retrospective_processes,create_playbook,update_playbook,list_playbooks,get_playbook,create_playbook_task,update_playbook_task,list_causes,get_cause,update_cause,list_incident_types,get_incident_type,update_incident_type,get_current_user"

📈 Análise e Relatórios (15 ferramentas)

Para liderança e equipes de métricas (foco somente leitura)

ROOTLY_MCP_ENABLED_TOOLS="list_incidents,search_incidents,collect_incidents,list_teams,list_services,list_schedules,get_oncall_shift_metrics,get_shift_incidents,list_dashboards,get_dashboard,list_alerts,list_heartbeats,list_pulses,get_current_user,list_endpoints"

Múltiplas Instâncias MCP para Diferentes Equipes

Você pode executar várias instâncias MCP com diferentes subconjuntos de ferramentas:

{
  "mcpServers": {
    "rootly-incident-response": {
      "command": "uvx", "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "<token>",
        "ROOTLY_MCP_ENABLED_TOOLS": "list_incidents,get_incident,create_incident,find_related_incidents,suggest_solutions..."
      }
    },
    "rootly-oncall-management": {
      "command": "uvx", "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "<token>",
        "ROOTLY_MCP_ENABLED_TOOLS": "list_schedules,update_schedule,create_override_shift,get_oncall_shift_metrics..."
      }
    }
  }
}

Com uvx

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

Recursos

  • Geração Dinâmica de Ferramentas: Cria automaticamente recursos MCP a partir da especificação OpenAPI (Swagger) da Rootly
  • Paginação Inteligente: Usa paginação limitada e respostas compactas de incidentes para evitar estouro da janela de contexto
  • Filtragem de API: Limita os endpoints de API expostos para segurança e desempenho
  • Análise Inteligente de Incidentes: Ferramentas inteligentes que analisam dados históricos de incidentes
    • find_related_incidents: Usa análise de similaridade TF-IDF para encontrar incidentes historicamente semelhantes
    • suggest_solutions: Explora resoluções passadas de incidentes para recomendar soluções acionáveis
  • Recursos MCP: Expõe incidentes, equipes, status de plantão e guias de fluxo de trabalho como recursos estruturados para contexto de IA
  • Reconhecimento Inteligente de Padrões: Identifica automaticamente serviços, tipos de erro e padrões de resolução
  • Integração de Saúde de Plantão: Detecta risco de saúde de carga de trabalho em respondedores escalados

Ferramentas Suportadas

A superfície padrão de ferramentas depende do perfil de implantação:

  • Padrão hospedado: cerca de 218 ferramentas
  • Perfil enxuto hospedado: cerca de 70 ferramentas
  • Padrão auto-hospedado: cerca de 218 ferramentas

Ferramentas Agênticas Personalizadas

  • check_oncall_health_risk
  • check_responder_availability
  • collect_incidents
  • create_incident - cria um novo incidente com um conjunto limitado de campos para fluxos de trabalho de agentes
  • create_override_recommendation
  • find_related_incidents
  • get_incident - recupera um único incidente para verificação direta, incluindo campos relacionados a PIR
  • get_alert_by_short_id
  • get_oncall_handoff_summary
  • get_oncall_schedule_summary
  • get_oncall_shift_metrics
  • get_server_version
  • get_shift_incidents
  • list_endpoints
  • list_incidents
  • list_shifts
  • search_incidents
  • suggest_solutions
  • update_incident - ferramenta de atualização de incidente com escopo para summary e retrospective_progress_status

Ferramentas Geradas por OpenAPI

Nomenclatura de ferramentas: todas as ferramentas usam snake_case. Os nomes históricos camelCase (por exemplo, getScheduleShifts, listIncidents) não são mais anunciados em tools/list, mas permanecem chamáveis como aliases ocultos — eles são roteados de forma transparente para seu canônico snake_case. Atualize as configurações e as listas de permissões ROOTLY_MCP_ENABLED_TOOLS para os nomes snake_case; entradas legadas de lista de permissões em camelCase são auto-canonicalizadas.

list_workflow_runs
create_incident_action_item
create_incident_form_field_selection
create_workflow_task
get_alert
get_alert_event
get_alert_group
get_alert_routing_rule
get_alert_source
get_alert_urgency
get_catalog
get_catalog_entity
get_cause
get_current_user
get_custom_form
get_environment
get_escalation_level
get_escalation_path
get_escalation_policy
get_form_field
get_form_field_option
get_functionality
get_functionality_incidents_chart
get_functionality_uptime_chart
get_incident_action_items
get_incident_form_field_selection
get_incident_type
get_on_call_role
get_on_call_shadow
get_override_shift
get_schedule
get_schedule_rotation
get_schedule_shifts
get_service
get_service_incidents_chart
get_service_uptime_chart
get_severity
get_status_page
get_status_page_template
get_team
get_team_incidents_chart
get_user
get_workflow
get_workflow_form_field_condition
get_workflow_group
get_workflow_task
list_alert_events
list_alert_groups
list_alert_routing_rules
list_alert_sources
list_alert_urgencies
list_alerts
list_all_incident_action_items
list_catalog_entities
list_catalogs
list_causes
list_custom_forms
list_environments
list_escalation_levels
list_escalation_levels_paths
list_escalation_paths
list_escalation_policies
list_form_field_options
list_form_fields
list_functionalities
list_incident_action_items
list_incident_alerts
list_incident_form_field_selections
list_incident_types
list_on_call_roles
list_on_call_shadows
list_override_shifts
list_schedule_rotation_active_days
list_schedule_rotation_users
list_schedule_rotations
list_schedules
list_services
list_severities
list_shifts
list_status_page_templates
list_status_pages
list_teams
list_users
list_workflow_form_field_conditions
list_workflow_groups
list_workflows
list_workflow_tasks
update_environment
update_escalation_level
update_escalation_path
update_escalation_policy
update_functionality
update_incident_type
update_on_call_role
update_on_call_shadow
update_override_shift
update_schedule
update_schedule_rotation
update_service
update_severity
update_team
update_workflow
update_incident_form_field_selection
update_workflow_task

Expansão Principal: Esta versão inclui mais de 50 novos endpoints cobrindo comunicações, painéis, playbooks, revisões pós-incidente, monitoramento e gerenciamento avançado de formulários — excluindo cuidadosamente operações sensíveis à segurança, como gerenciamento de chaves de API, criação/exclusão de usuários, gerenciamento de funções e configuração de webhooks.

As operações de exclusão permanecem desabilitadas na superfície padrão de ferramentas.

Integração de Saúde de Plantão

Integra-se com On-Call Health para detectar risco de saúde de carga de trabalho em respondedores escalados.

Configuração

Defina a variável de ambiente ONCALLHEALTH_API_KEY:

{
  "mcpServers": {
    "rootly": {
      "command": "uvx",
      "args": ["--from", "rootly-mcp-server", "rootly-mcp-server"],
      "env": {
        "ROOTLY_API_TOKEN": "your_rootly_token",
        "ONCALLHEALTH_API_KEY": "och_live_your_key"
      }
    }
  }
}

Uso

check_oncall_health_risk(
    start_date="2026-02-09",
    end_date="2026-02-15"
)

Retorna usuários em risco que estão escalados, substituições seguras recomendadas e resumos de ações.

Exemplos de Habilidades

Habilidades pré-construídas do Claude Code:

🚨 Respondedor de Incidentes Rootly

Esta habilidade:

  • Analisa incidentes de produção com contexto completo
  • Encontra incidentes históricos semelhantes usando correspondência de similaridade baseada em ML
  • Sugere soluções com base em resoluções passadas bem-sucedidas
  • Coordena com equipes de plantão em diferentes fusos horários
  • Correlaciona incidentes com mudanças recentes de código e implantações
  • Cria itens de ação e planos de remediação
  • Fornece pontuações de confiança e estimativas de tempo

Início Rápido:

# Copy the skill to your project
mkdir -p .claude/skills
cp examples/skills/rootly-incident-responder.md .claude/skills/

# Then in Claude Code, invoke it:
# @rootly-incident-responder analyze incident #12345

Demonstra um fluxo de trabalho completo de resposta a incidentes usando ferramentas Rootly e contexto do GitHub.

Métricas de Turno de Plantão

Obtenha métricas de turno de plantão para qualquer período, agrupadas por usuário, equipe ou escala. Inclui rastreamento de função primária/secundária, contagens de turnos, horas e dias de plantão.

get_oncall_shift_metrics(
    start_date="2025-10-01",
    end_date="2025-10-31",
    group_by="user"
)

Resumo de Transferência de Plantão

Handoff completo: plantão atual/próximo + incidentes durante os turnos.

# All on-call (any timezone)
get_oncall_handoff_summary(
    team_ids="team-1,team-2",
    timezone="America/Los_Angeles"
)

# Regional filter - only show APAC on-call during APAC business hours
get_oncall_handoff_summary(
    timezone="Asia/Tokyo",
    filter_by_region=True
)

A filtragem regional mostra apenas pessoas de plantão durante o horário comercial (9h às 17h) no fuso horário especificado.

Retorna: schedules com current_oncall, next_oncall e shift_incidents

Recursos MCP para Contexto

Agentes de IA podem acessar estes recursos para consciência situacional:

  • incident://{incident_id} - Informações detalhadas de incidentes para incidentes específicos
  • team://{team_id} - Detalhes da equipe, incluindo nome, cor e metadados
  • rootly://incidents - Lista de incidentes recentes para referência rápida
  • rootly://oncall-status - Status atual de plantão em todos os cronogramas (crítico para resposta a incidentes)
  • rootly://workflow-guide - Orientação passo a passo de fluxos de trabalho para operações comuns

Exemplo de uso: "Verifique o status atual de plantão" → A IA lê o recurso rootly://oncall-status

Incidentes de Turno

Incidentes durante um período de tempo, com filtragem por severidade/status/tags.

get_shift_incidents(
    start_time="2025-10-20T09:00:00Z",
    end_time="2025-10-20T17:00:00Z",
    severity="critical",  # optional
    status="resolved",    # optional
    tags="database,api"   # optional
)

Retorna: lista de incidents + summary (contagens, tempo médio de resolução, agrupamento)

Contribuindo

Consulte CONTRIBUTING.md para configuração do desenvolvedor e diretrizes.

Experimente no Postman

Run In Postman

Sobre o Rootly AI Labs

Este projeto foi desenvolvido pelo Rootly AI Labs, onde estamos construindo o futuro da confiabilidade de sistemas e excelência operacional. Como incubadora de código aberto, compartilhamos ideias, experimentamos e prototipamos rapidamente soluções que beneficiam toda a comunidade. Rootly AI logo