Odel
causely client

causely client

@causely-oss3ShellApache-2.0Updated 6 days ago

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

View on GitHub
Server endpointStreamable HTTPOAuthProbed
https://api.causely.app/mcp

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

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:

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).