About causely
Causely's integration repository bundles MCP skills and plugins, a Kubernetes CLI, and shell tools for its GraphQL API. It helps agents investigate reliability using Causely's causal model, root-cause analysis, blast radius, and service health.
Key features
- 01Hosted MCP server integration
- 02Agent skills for incident investigations
- 03Starter configurations for agent clients
- 04Kubernetes agent installation CLI
- 05GraphQL shell tools for snapshots and comparisons
Use cases
- 01Triage alerts with causal context
- 02Investigate changes and service impact
- 03Install or manage the agent in Kubernetes
- 04Compare API snapshots in CI workflows
MCP support
Causely's hosted MCP server exposes its causal model, deterministic root cause, blast radius, and service health as structured tools. Clients authenticate on first connection using OAuth.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.causely.app/mcpclaude mcp add --transport http app-causely-causely https://api.causely.app/mcp{"mcpServers":{"app-causely-causely":{"type":"http","url":"https://api.causely.app/mcp"}}}Open in Cursor{"servers":{"app-causely-causely":{"type":"http","url":"https://api.causely.app/mcp"}}}Open in VS Code{"mcpServers":{"app-causely-causely":{"type":"http","url":"https://api.causely.app/mcp"}}}{"mcpServers":{"app-causely-causely":{"serverUrl":"https://api.causely.app/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMECausely 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 withSKILL.mdandreferences/complete-investigation.md(symlink to the sharedmcp/complete-investigation.mdin this repo). - Master router skill —
mcp/SKILL.md(samecausely-mcprole as in the skills overview) plusmcp/complete-investigation.mdat themcp/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).
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.