Causely logo

Causely

Causal reasoning for reliability: root cause, blast radius, and service health for agents.

Install Causely

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
Server URL
https://api.causely.app/mcp

Remote servers are added in the app, not the config file: Customize β†’ Connectors β†’ Add custom connector, then paste this URL.

Overview

Security & health

What it can reach and how reliably it runs β€” from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 46d

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks β€” not a rating.

GitHub stars3Stargazers on the source repository.
Last commit3d agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

From the project README

Causely Agent Integrations β€” MCP Skills, Plugins & CLI

These are the tools that let AI agents query Causely's causal model directly, instead of scanning raw telemetry and guessing. This repository bundles client-side resources for working with Causely: agent integrations (MCP), a Kubernetes install CLI, and a shell toolkit for the Causely GraphQL API.

The Causely MCP server is hosted at https://api.causely.app/mcp. Point any MCP-compatible client at it and sign in with your Causely account on first connect (OAuth, no API keys). It exposes Causely's causal model, deterministic root cause, blast radius, and service health, as structured tools your agent can call directly.

AreaPathWhat it is
MCP skills & pluginsmcp/Claude (and compatible) skills that route work across Causely's MCP tools, plus starter configs for Cursor, Claude, Codex, VS Code Copilot, and OpenCode.
Kubernetes CLIcli/Go CLI that wraps Helm to install and manage the Causely agent in-cluster.
API shell clientapi/Bash libraries and scripts for snapshots, comparisons, and CI workflows against the Causely API.

Product documentation lives at docs.causely.ai. For MCP authentication, headers, and troubleshooting, start with MCP Server Integration.


MCP (mcp/)

Point any MCP-compatible client directly at the hosted server:

Code
https://api.causely.app/mcp

On first connect, your client opens a browser to sign in to Causely (OAuth). No API keys or custom headers are required for the hosted server.

Or install the pre-built skills below for Claude Code, Claude Desktop, and Cursor, so your agent gets the right investigation sequence without hand-writing tool-selection logic.

  • mcp/README.md β€” Overview of the seven packaged skills (alert triage, change impact, health reporting, K8s investigation, correlated incidents, postmortems, and the master MCP router).
  • mcp/plugins/README.md β€” How to wire the hosted MCP server into Claude, Cursor, Codex, GitHub Copilot, OpenCode, and related tools, including optional custom headers.
  • Leaf skills β€” six drop-in folders under mcp/skills/, each with SKILL.md and references/complete-investigation.md (symlink to the shared mcp/complete-investigation.md in this repo).
  • Master router skill β€” mcp/SKILL.md (same causely-mcp role as in the skills overview) plus mcp/complete-investigation.md at the mcp/ root for full tool routing and investigation patterns.

Curious why causal context matters for agent accuracy? See the benchmark results β€” 100% fault scenario accuracy and 48% fewer tokens per investigation across 72 experiments.


CLI (cli/)

Install and operate the Causely agent from the terminal. See cli/README.md for the install script, causely agent install, auth, and Helm-oriented flags. Official install guide: CLI Installation.

bash
go build -C cli -o causely .
./causely version

API client (api/)

Shell-based GraphQL client: snapshots, diffing, GitHub Actions examples, and numbered docs. See api/README.md and api/docs/.


Contributing

See CONTRIBUTING.md for project layout, development setup, and how to submit changes.

The Go module for the CLI is declared in go.mod at the repository root (github.com/Causely/causely-api-client).

Reviews

No reviews yet β€” be the first to share how it worked for you.

Frequently Asked Questions about Causely

causely is an MCP server that provides AI agents with direct access to Causely's causal model for reliability investigations. It exposes structured tools for deterministic root cause, blast radius, and service health, helping agents investigate incidents without scanning raw telemetry and guessing. Hosted at https://api.causely.app/mcp, it uses OAuth through Causely account sign-in and requires n…

Connect your MCP-compatible client to https://api.causely.app/mcp. On first connection, the client opens a browser for OAuth sign-in with your Causely account; the hosted server does not require API keys or custom headers.

causely helps agents investigate reliability issues using Causely's causal model, including deterministic root cause, blast radius, and service health. The repository also provides packaged skills for alert triage, change impact, health reporting, Kubernetes investigation, correlated incidents, and postmortems.

Yes. The repository includes MCP skills and starter configurations for Claude, Cursor, Codex, VS Code Copilot, OpenCode, and related tools. These integrations help route work across Causely's MCP tools without requiring agents to hand-write tool-selection logic.

Related MCP servers

Add a badge to your READMEShow it’s listed β€” live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCausely AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/causely-2?style=directory)](https://allmcps.com/mcp/causely-2)
HTML Embed
<a href="https://allmcps.com/mcp/causely-2"><img src="https://allmcps.com/api/badge/causely-2?style=directory" alt="Causely on AllMCPs" /></a>