rootlyhq/rootly-mcp-server

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
- **SSE (stable alternative):** https://mcp.rootly.com/sse
- **Code Mode:** https://mcp.rootly.com/mcp-codemode
Hosted tool profiles:
- **Full (default):** use the URLs above as-is
- **Slim (~70 tools):** add ?tool_profile=slim to the hosted URL, for example https://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:**
SSE (alternative):
Code Mode:
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):**
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
- uv package 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** endpoint path: /sse
- **Code Mode (experimental)** endpoint path: /mcp-codemode in hosted dual-transport mode
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