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.
| Area | Path | What it is |
|---|
| MCP skills & plugins | mcp/ | 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 CLI | cli/ | Go CLI that wraps Helm to install and manage the Causely agent in-cluster. |
| API shell client | api/ | 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:
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.
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).