Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http causely https://api.causely.app/mcp
Open on GitHub

What 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-api and its blast radius
  • Check which services will be affected by changes to payment-service
  • Generate a postmortem for incident INC-2947 with timeline and root cause

How to install causely

Platform CLI: remote server

claude mcp add --transport http causely https://api.causely.app/mcp

Step 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.

Similar MCP servers

All MCP servers for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open