cb-analytics-capellalisted
Install: claude install-skill celticht32/Couchbase-Skills-for-Claude.ai
# Capella Management via cb-analytics-mcp
The 9 `capella_*` tools wrap Couchbase Capella's v4 Management API. They are
only available when `CB_CAPELLA_API_KEY_SECRET` is set; otherwise the tools
raise a clear `RuntimeError: Capella client is not configured`.
## The hierarchy
```
Organization (you may belong to several)
└── Project (group of clusters; usually one per environment)
└── Cluster (the actual Capella deployment)
└── Backup
```
Every cluster-scoped tool takes `(org_id, project_id, cluster_id)` in that
order. Use `capella_list_organizations()` and your own org's project IDs to
discover them — the tools don't accept names.
## Read-only first
- `capella_list_organizations()` — first call to discover IDs.
- `capella_list_clusters(org_id, project_id)` — see what exists.
- `capella_get_cluster(org_id, project_id, cluster_id)` — full details for one.
- `capella_list_backups(org_id, project_id, cluster_id)` — list available
backups.
- `capella_list_api_keys(org_id)` — audit API key usage.
## Write operations (require confirmation)
- `capella_create_cluster(org_id, project_id, cluster_spec)` — `cluster_spec`
is a free-form dict matching the v4 API schema; **don't guess it**, ask
the user to paste the exact body, or refer them to Capella's UI's "View
as JSON" feature.
- `capella_delete_cluster(org_id, project_id, cluster_id)` — **destructive**.
Always restate the cluster name and project before calling.
- `capella_create_backup(org_id, p