causely — Claude Code MCP server: what it does, how to install
The causely MCP server gives agents direct access to Causely's causal model: incident root causes, change blast radius, and service health — without parsing raw telemetry.
Apache-2.0 ★ 3 updated 2026-10-20
claude mcp add --transport http causely https://api.causely.app/mcpWhat causely does
The server runs at https://api.causely.app/mcp and handles OAuth on first connect. Agents get seven tools: alert triage, change impact assessment, cluster health checks, Kubernetes investigations, incident correlation, and postmortem generation. The repository includes pre-built skills for Claude Code and config examples for Cursor, Codex, and GitHub Copilot.
Causely benchmarks show 100% root cause accuracy across 72 fault scenarios and 48% fewer tokens per investigation compared to raw metric analysis. The server requires the Causely agent running in your cluster — install it via the CLI bundled in the same repository with causely agent install.
What it helps with
- identify the root cause of an incident using the causal model
- assess the impact of a change before deploying
- check service health and dependencies in Kubernetes
- correlate multiple alerts to a single cause and generate a postmortem
- investigate failures without manually parsing metrics and logs
Example prompts for the agent
- Show me the root cause of alert
high-latency-apiand its blast radius - Check which services will be affected by changes to
payment-service - Generate a postmortem for incident
INC-2947with timeline and root cause
How to install causely
Platform CLI: remote server
claude mcp add --transport http causely https://api.causely.app/mcpPlatform CLI: remote server
codex mcp add causely --url https://api.causely.app/mcpConfig file
{
"mcpServers": {
"causely": {
"url": "https://api.causely.app/mcp"
}
}
}Config file
{
"servers": {
"causely": {
"type": "http",
"url": "https://api.causely.app/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http causely https://api.causely.app/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about causely
How do I install causely in Claude Code?
Run claude mcp add --transport http causely https://api.causely.app/mcp. On first connect, your browser will open for OAuth sign-in to your Causely account.
What does the causely MCP server do?
It provides agents with access to Causely's causal model: determines root causes of failures, shows change blast radius, checks service health. Instead of analyzing raw metrics, the agent works with a ready-made cause-and-effect map of your infrastructure.
What does causely require to work?
The Causely agent must be installed in your Kubernetes cluster — without it, the server cannot connect to your infrastructure. Install it via the CLI with causely agent install. You also need a Causely account for OAuth authentication.