
Rootly
com.rootly由 rootly.com 發布官方發布者v2.2.4更新於 Oct 24, 2026
Incident management, on-call scheduling, and intelligent analysis powered by Rootly.
概覽
Rootly 的 MCP 伺服器,用於事件管理、值班排班與事件分析,可作為託管端點或本機 Python 程序執行。
- 可以做什麼
- 列出、搜尋、檢視、建立與更新事件、行動項目及事後檢討
- 管理值班排班、輪替、代班、升級策略與回應人員可用性
- 檢視告警、告警群組、路由規則、心跳、脈衝、儀表板與狀態頁
- 以相似事件比對、解決方案建議與 AI SRE 調查分析歷史資料
- 瀏覽團隊、服務、使用者、嚴重程度、環境、工作流程與目錄實體
- 適用情境
- 適合讓助理在 Rootly 組織內協助事件應變、值班協調或事後檢討,或回答關於歷史事件與排班的問題。
- 執行需求
- 可使用託管端點並以 OAuth2 登入,或提供 Rootly API 權杖,透過 ROOTLY_API_TOKEN 環境變數或 Authorization 標頭傳入。本機執行需要 Python 3.12 以上與 uv 套件管理員,亦提供 Docker 方式。需要可連線至 Rootly 的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Rootly,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/com.rootly%2Fmcp-server/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"rootly": {
"type": "sse",
"url": "https://mcp.rootly.com/sse"
}
}
}README
Rootly MCP Server
[PyPI version] [PyPI - Downloads] [Python Version]
An MCP server for the Rootly API for Cursor, Windsurf, Claude, and other MCP clients.
Quick Start
Use the hosted MCP server. No local installation required.
Hosted Transport Options
- Streamable HTTP (recommended):
https://mcp.rootly.com/mcp - Code Mode:
https://mcp.rootly.com/mcp-codemode - SSE (deprecated, removed after 2026-11-20):
https://mcp.rootly.com/sse
[!WARNING] SSE is deprecated. The hosted
https://mcp.rootly.com/sseendpoint and the self-hosted--transport sseoption will be removed after 2026-11-20. Switch your client to Streamable HTTP (https://mcp.rootly.com/mcp) or Code Mode (https://mcp.rootly.com/mcp-codemode); for most clients that means changing the URL and, if your client config has one, setting the transport tohttp/streamable-http. SSE responses now carryDeprecation,SunsetandLink: rel="successor-version"headers.
Hosted tool profiles:
- Full (default): use the URLs above as-is
- Slim (~70 tools): add
?tool_profile=slimto the hosted URL, for examplehttps://mcp.rootly.com/mcp?tool_profile=slim - Header alternative: send
X-Rootly-Tool-Profile: slim - Server-wide default: set
ROOTLY_MCP_HOSTED_TOOL_PROFILE=full|slim - Exact custom override: set
ROOTLY_MCP_ENABLED_TOOLS=...
General Remote Setup
With OAuth2 (recommended):
Your MCP client handles OAuth2 login automatically — a browser window opens for you to authenticate with Rootly. No API token needed.
With API Token:
Code Mode:
If your config still points at https://mcp.rootly.com/sse, replace it with https://mcp.rootly.com/mcp before 2026-11-20 (SSE is deprecated, see above).
Agent Setup
Claude Code
With OAuth2 (recommended):
With API Token:
Manual Configuration — Create .mcp.json in your project root:
Gemini CLI
Install the extension:
Or configure manually in ~/.gemini/settings.json:
Cursor
Add to .cursor/mcp.json or ~/.cursor/mcp.json:
With OAuth2 (recommended):
With API Token:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
With OAuth2 (recommended):
With API Token:
Codex
Add to ~/.codex/config.toml:
With OAuth2 (recommended):
With API Token:
Claude Desktop
With OAuth2 (recommended):
Add to claude_desktop_config.json:
Claude Desktop handles OAuth2 login automatically.
With API Token (via mcp-remote):
Databricks
Register the hosted server in Unity Gateway so Supervisor Agent, AI Playground, and other Databricks agents can use it:
- In your workspace, open Unity Gateway > MCPs, click + MCP, and choose Connect an existing MCP server.
- Pick a catalog and schema, name the MCP, and create a new connection with URL
https://mcp.rootly.com/mcp. - Choose an authentication method:
- Dynamic Client Registration (recommended): each user signs in to Rootly with their own account.
- Bearer token: paste a Rootly API token.
- Click Create & load tools, click Login if prompted, and select the tools to expose.
Or create the connection with the Databricks SDK:
The full profile exposes about 250 tools. Use Unity Gateway tool selection to expose only what your agents need. See docs/databricks-marketplace.md for the Marketplace listing details.
Rootly CLI
Standalone CLI for incidents, alerts, services, and on-call operations.
Install via Homebrew:
Or via Go:
For more details, see the Rootly CLI repository.
Alternative Installation (Local)
Run the MCP server locally if you do not want to use the hosted service.
Prerequisites
- Python 3.12 or higher
uvpackage manager- Rootly API token
API Token Types
Choose the token type based on the access you need:
- Global API Key: Full access across the Rootly instance. Best for organization-wide visibility.
- Team API Key: Access limited to entities owned by that team.
- Personal API Key: Access matches the user who created it.
A Global API Key is recommended for organization-wide queries and for actions that modify data, especially when workflows may span multiple teams, schedules, or incidents.
With uv
Self-Hosted Transport Options
Choose one transport per server process:
- Streamable HTTP endpoint path:
/mcp - SSE (deprecated, removed after 2026-11-20) endpoint path:
/sse.--transport sselogs a deprecation warning at startup; use--transport streamable-httpinstead. - Code Mode (experimental) endpoint path:
/mcp-codemodein hosted dual-transport mode. Oneexecutecall may make at most 50 tool calls; setROOTLY_CODE_MODE_MAX_TOOL_CALLSto a positive integer to change that.
Hosted and self-hosted deployments now both expose the full tool surface by default.
- Hosted default: full surface
- Hosted slim profile: about 70 high-usage tools via
?tool_profile=slim - Self-hosted default: full surface
To restrict either deployment to read-only tools, start the server with --no-enable-write-tools or set ROOTLY_MCP_ENABLE_WRITE_TOOLS=false.
For hosted clients that want the smaller remote profile, append ?tool_profile=slim to the MCP URL or send X-Rootly-Tool-Profile: slim.
AgentCat and Sentry telemetry
Hosted deployments can send MCP telemetry to AgentCat by setting
ROOTLY_MCPCAT_PROJECT_ID. To also export AgentCat events to Sentry, provide
SENTRY_DSN through the deployment's secret store. The optional
ENVIRONMENT defaults to production, and SENTRY_RELEASE defaults to the
installed Rootly MCP Server version. Sentry performance tracing is enabled when
the exporter is configured.
Free-form event text is redacted and actor names are omitted from Sentry-bound
telemetry; stable internal actor IDs remain available for correlation.
AgentCat's enable_tool_call_context and enable_report_missing options are
disabled. The SDK does not add an analytics context parameter or the
get_more_tools feedback tool. Tool-call telemetry remains enabled, including
arguments, responses, timing, errors, and configured identity information,
subject to the existing redaction hooks.
Telemetry runs on AgentCat v2 (MCP 2026-07-28 spec). Session correlation uses the
SDK's hook mode (resolve_session_id): the server derives the session from the
request. The key always starts with the caller (authenticated user, or a digest
of the token), then the client's Mcp-Session-Id when it sends one, otherwise
the UTC hour. No session_id parameter or session instructions are added to
tool schemas. Clients holding a cached tool
list that still send context or session_id are tolerated; the stray
argument is dropped before validation. initialize and tools/list events are
no longer published by the SDK.
To override the hosted or self-hosted default profile entirely, set ROOTLY_MCP_ENABLED_TOOLS (or pass --enabled-tools) with a comma-separated allowlist of exact tool names. When that variable is set, it fully replaces the default selection.
To expose only a specific subset of MCP tools on a self-hosted deployment, set ROOTLY_MCP_ENABLED_TOOLS (or pass --enabled-tools) with a comma-separated allowlist of exact tool names, for example list_incidents,get_incident,get_server_version.
PostHog MCP analytics
Setting POSTHOG_PROJECT_TOKEN (and optionally POSTHOG_HOST, default
https://us.i.posthog.com) sends $mcp_* events to PostHog with the same
privacy settings as AgentCat: no injected context, conversation_id or
llm_model parameters, credential scrubbing before send, and hosted users
identified by Rootly user ID only.
When AgentCat is also configured, both run side by side. posthog.mcp's MCP SDK
1.x code path cannot handle AgentCat's middleware directly, so the server wraps
it in an adapter first. On the stateless hosted transport, PostHog sessions are
tied together through the Mcp-Session-Id header minted at initialize.
AgentCat's session resolver also reads that header (scoped to the
authenticated caller), so with PostHog on, AgentCat groups those clients'
calls per connection instead of per hour.
OpenAI Apps domain verification
Hosted deployments expose an unauthenticated domain-verification endpoint used by the OpenAI plugin directory:
- Endpoint:
GET /.well-known/openai-apps-challenge - Environment variable:
ROOTLY_OPENAI_APPS_CHALLENGE_TOKEN
Set ROOTLY_OPENAI_APPS_CHALLENGE_TOKEN to the token generated in the OpenAI submission portal. The endpoint returns that exact token as text/plain (with Cache-Control: no-store), and returns 404 when the variable is unset or empty. The token is read from the environment at request time — never hardcode or commit it. The route is served on both the dual-transport (--transport both) and profiled streamable-HTTP hosted deployments and is not subject to Bearer authentication.
To discover the exact tool names available under your current self-hosted configuration, run:
This prints the effective MCP tool names after applying your current settings, including ROOTLY_MCP_ENABLE_WRITE_TOOLS and ROOTLY_MCP_ENABLED_TOOLS.
Smoke-test a self-hosted allowlist:
Then connect an MCP client to http://127.0.0.1:8000/mcp and verify tools/list returns only:
To include specific write tools for self-hosted testing, add both the write flag and the allowlist:
Example Docker run (Streamable HTTP):
Example Docker run (SSE, deprecated: removed after 2026-11-20, use Streamable HTTP above):
Example Docker run (Dual transport + Code Mode; the /sse endpoint it also serves is deprecated):
Workflow-Focused Tool Subsets
The full hosted and self-hosted surface exposes 200+ tools. If you want tighter workflow-specific subsets, use ROOTLY_MCP_ENABLED_TOOLS:
🚨 Incident Response (25 tools)
Essential tools for emergency responders and incident commanders
📅 On-Call Management (33 tools)
For schedule coordinators and on-call managers
📊 Monitoring & Alerting (40 tools)
For platform teams setting up observability
📋 Post-Incident Analysis (30 tools)
For SREs doing retrospectives and process improvement
📈 Analytics & Reporting (15 tools)
For leadership and metrics teams (read-only focus)
Multiple MCP Instances for Different Teams
You can run multiple MCP instances with different tool subsets:
With uvx
Features
- Dynamic Tool Generation: Automatically creates MCP resources from Rootly's OpenAPI (Swagger) specification
- Smart Pagination: Uses bounded pagination and compact incident responses to prevent context window overflow
- API Filtering: Limits exposed API endpoints for security and performance
- Intelligent Incident Analysis: Smart tools that analyze historical incident data
find_related_incidents: Uses TF-IDF similarity analysis to find historically similar incidentssuggest_solutions: Mines past incident resolutions to recommend actionable solutions
- MCP Resources: Exposes incidents, teams, on-call status, and workflow guides as structured resources for AI context
- Intelligent Pattern Recognition: Automatically identifies services, error types, and resolution patterns
- On-Call Health Integration (self-hosted only): Detects workload health risk in scheduled responders
Supported Tools
The default tool surface depends on deployment profile:
- Hosted default: about 218 tools
- Hosted slim profile: about 70 tools
- Self-hosted default: about 218 tools
Custom Agentic Tools
check_oncall_health_risk- self-hosted onlycheck_responder_availabilitycollect_incidentscreate_incident- create a new incident with a scoped set of fields for agent workflowscreate_override_recommendationfind_related_incidentsget_incident- retrieve a single incident for direct verification, including PIR-related fieldsget_alert_by_short_idget_investigation- an AI SRE investigation's verdict, evidence, causal chain and open questions (by id, or latest for an alert/incident)get_investigation_progress- follow a running investigation; call again withafter_cursoruntildoneget_oncall_handoff_summaryget_oncall_schedule_summaryget_oncall_shift_metricsget_server_versionget_shift_incidentslist_endpointslist_investigationslist_incidentslist_shiftssearch_incidentsstart_investigation,cancel_investigation- start or cancel an AI SRE investigation; write toolssuggest_solutionsupdate_incident- update native incident fields with severity validation; retrospective status changes require the Rootly UI
OpenAPI-Generated Tools
Tool naming: all tools use
snake_case. The historicalcamelCasenames (e.g.getScheduleShifts,listIncidents) are no longer advertised intools/list, but remain callable as hidden aliases — they are transparently routed to theirsnake_casecanonical. Update configs andROOTLY_MCP_ENABLED_TOOLSallowlists to thesnake_casenames; legacy camelCase allowlist entries are auto-canonicalized.
Major Expansion: This version includes 50+ new endpoints covering communications, dashboards, playbooks, post-incident reviews, monitoring, and advanced form management - while carefully excluding security-sensitive operations like API key management, user creation/deletion, role management, and webhook configuration.
Delete operations remain disabled in the default tool surface.
On-Call Health Integration (Self-Hosted Only)
Integrates with On-Call Health to detect workload health risk in scheduled responders.
check_oncall_health_risk is unavailable on the hosted MCP service, including
the full and slim profiles, SSE, Streamable HTTP, and Code Mode. It is not
registered in hosted mode, so an API key or ROOTLY_MCP_ENABLED_TOOLS allowlist
cannot enable it. Ordinary on-call scheduling and incident tools remain available.
Self-hosted deployments retain this integration. Operators are responsible for appropriate employee disclosure and data handling for their deployment.
Setup
Set the ONCALLHEALTH_API_KEY environment variable:
Usage
Returns at-risk users who are scheduled, recommended safe replacements, and action summaries.
Example Skills
Pre-built Claude Code skills:
🚨 Rootly Incident Responder
This skill:
- Analyzes production incidents with full context
- Finds similar historical incidents using ML-based similarity matching
- Suggests solutions based on past successful resolutions
- Coordinates with on-call teams across timezones
- Correlates incidents with recent code changes and deployments
- Creates action items and remediation plans
- Provides confidence scores and time estimates
Quick Start:
It demonstrates a full incident response workflow using Rootly tools and GitHub context.
On-Call Shift Metrics
Get on-call shift metrics for any time period, grouped by user, team, or schedule. Includes primary/secondary role tracking, shift counts, hours, and days on-call.
On-Call Handoff Summary
Complete handoff: current/next on-call + incidents during shifts.
Regional filtering shows only people on-call during business hours (9am-5pm) in the specified timezone.
Returns: schedules with current_oncall, next_oncall, and shift_incidents
MCP Resources for Context
AI agents can access these resources for situational awareness:
incident://{incident_id}- Detailed incident information for specific incidentsteam://{team_id}- Team details including name, color, and metadatarootly://incidents- List of recent incidents for quick referencerootly://oncall-status- Current on-call status across all schedules (critical for incident response)rootly://workflow-guide- Step-by-step workflow guidance for common operations
Example usage: "Check the current on-call status" → AI reads rootly://oncall-status resource
Shift Incidents
Incidents during a time period, with filtering by severity/status/tags.
Returns: incidents list + summary (counts, avg resolution time, grouping)
Contributing
See CONTRIBUTING.md for developer setup and guidelines.
Play with it on Postman
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. [Rootly AI logo]
來源:README.md,提交 61a887b
工具
0版本歷史
1- v2.2.4最新Sep 16, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
其他 Rootly 整合

On-Call Health
由 GitHub 帳號 Rootly-AI-Labs 發布
將助理連接到 On-Call Health,用來執行值班倦怠風險分析,並找出高風險或狀態良好的值班人員。

Rootly
由 GitHub 帳號 wyre-technology 發布
讓助理透過決策樹式工具集讀取與管理 Rootly 的事件、告警、值班排程與組織資料。

Rootly
由 GitHub 帳號 WYRE-AI 發布
面向 Rootly 事件管理的本機 MCP 伺服器,讓助理列出、建立、更新與解決事件和警示,並讀取值班表與組織資訊。

Rootly MCP
由 GitHub 帳號 Servosity 發布
非官方本機 MCP 伺服器,讓助理以具型別的 Rootly 事件、告警與值班指令操作,並附本機 SQLite 鏡像供離線分析。

Rootly
com.mcparmory
一個在本機執行的 MCP 伺服器,讓助理連接 Rootly,管理事件告警、事件記錄與含自訂自動化的工作流程。