# causely

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3 repo stars
- Author: causely-oss
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/causely-oss/causely-client
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/causely

## What it 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`.

## Requirements
- Remote server: `https://api.causely.app/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http causely https://api.causely.app/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add causely --url https://api.causely.app/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "causely": {
            "url": "https://api.causely.app/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "causely": {
            "type": "http",
            "url": "https://api.causely.app/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http causely https://api.causely.app/mcp
```

## When to use it
- 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
- 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

## Similar
- [error-detective](https://affpapa.org/en/nevibecode/agents/error-detective.md) — subagent · 7557 installs
- [pagerduty-automation](https://affpapa.org/en/nevibecode/skills/pagerduty-automation.md) — skill · ★ 3785 repo stars
- [incident-response](https://affpapa.org/en/nevibecode/commands/seth-hobson-incident-response.md) — command · ★ 126 repo stars
- [incident-responder](https://affpapa.org/en/nevibecode/agents/incident-responder.md) — subagent · 265 installs
- [error-diagnostics-smart-debug](https://affpapa.org/en/nevibecode/skills/error-diagnostics-smart-debug.md) — skill · 1 install
- [groundcover-cli](https://affpapa.org/en/nevibecode/skills/groundcover-cli.md) — skill · 10400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
