This article is the customer-facing index of the clariBI MCP server. Engineers should also see the engineering reference in the repo.
Base URL
https://claribi.com/mcp/v1/Authentication
- OAuth 2.1 with Dynamic Client Registration (RFC 7591). Recommended for any client used by multiple humans.
- API key. Paste a
claribi_mcp_*key into your client's MCP config. Mint keys from Developer Portal → MCP Server → Clients & Keys.
Discovery endpoints
/mcp/v1/.well-known/oauth-authorization-server: RFC 8414 metadata./mcp/v1/.well-known/oauth-protected-resource: RFC 9728 metadata./mcp/v1/info: server identification + transport summary.
Transports
- Streamable HTTP (current MCP spec). POST JSON-RPC requests, receive JSON responses or an upgrade to SSE.
- SSE (legacy). For Claude Desktop builds shipped before April 2025.
Scopes
| Scope | Description |
|---|---|
dashboards:read | List and view dashboards. |
dashboards:write | Create and update dashboards. |
reports:read | List and view reports. |
reports:write | Generate reports. |
data-sources:read | List data sources and inspect schemas. |
analysis:run | Run conversational analysis (consumes AI credits). |
usage:read | View AI credit usage and tier info. |
billing:read | View subscription status. |
billing:write | Initiate Stripe checkout sessions. |
account:write | Update org profile. |
Tier gating
Outbound MCP requires the mcp_server_access feature. Available on Trial, Starter, Professional, and Enterprise. Free and Lite do not include it.
Rate limits
- DCR (open client registration): 20/hour in production.
- Public signup tools: 5/hour per IP in production.
- Authenticated tool calls: 600/min in production, layered with per-org throttling.
SDKs
- Python:
pip install claribi-mcp. - TypeScript:
npm install @claribi/mcp.
Support
Issues? Email support@claribi.com with the request_id from the JSON-RPC envelope and the prefix of the access token you used.