# causely [Health: Active]

**Category:** 🧬 Biology & Bioinformatics  
**Repository:** https://github.com/causely-oss/causely-client  
**GitHub Stars:** 3  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/causely-2

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

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "causely": {
    "url": "https://causely.ai"
  }
}
```

## Documentation & 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](https://causely.ai): 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/`](https://github.com/causely-oss/causely-client/blob/HEAD/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/`](https://github.com/causely-oss/causely-client/blob/HEAD/cli/) | Go **CLI** that wraps Helm to install and manage the Causely agent in-cluster. |
| **API shell client** | [`api/`](https://github.com/causely-oss/causely-client/blob/HEAD/api/) | **Bash** libraries and scripts for snapshots, comparisons, and CI workflows against the Causely API. |

Product documentation lives at [docs.causely.ai](https://docs.causely.ai/). For MCP authentication, headers, and troubleshooting, start with [MCP Server Integration](https://docs.causely.ai/agent-integration/mcp-server/).

---

## 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`](https://github.com/causely-oss/causely-client/blob/HEAD/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`](https://github.com/causely-oss/causely-client/blob/HEAD/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/`](https://github.com/causely-oss/causely-client/blob/HEAD/mcp/skills/), each with `SKILL.md` and `references/complete-investigation.md` (symlink to the shared [`mcp/complete-investigation.md`](https://github.com/causely-oss/causely-client/blob/HEAD/mcp/complete-investigation.md) in this repo).
- **Master router skill** — [`mcp/SKILL.md`](https://github.com/causely-oss/causely-client/blob/HEAD/mcp/SKILL.md) (same `causely-mcp` role as in the skills overview) plus [`mcp/complete-investigation.md`](https://github.com/causely-oss/causely-client/blob/HEAD/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](https://www.causely.ai/product/benchmark) — 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`](https://github.com/causely-oss/causely-client/blob/HEAD/cli/README.md)** for the install script, `causely agent install`, auth, and Helm-oriented flags. Official install guide: [CLI Installation](https://docs.causely.ai/installation/cli/).

```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`](https://github.com/causely-oss/causely-client/blob/HEAD/api/README.md)** and [`api/docs/`](https://github.com/causely-oss/causely-client/blob/HEAD/api/docs/).

---

## Contributing

See **[`CONTRIBUTING.md`](https://github.com/causely-oss/causely-client/blob/HEAD/CONTRIBUTING.md)** for project layout, development setup, and how to submit changes.

The Go module for the CLI is declared in [`go.mod`](https://github.com/causely-oss/causely-client/blob/HEAD/go.mod) at the repository root (`github.com/Causely/causely-api-client`).