MCP server

Use clariBI from Claude, Cursor or any MCP client

clariBI runs its own MCP server at claribi.com/mcp/v1/. Connect your AI assistant to it and ask for your dashboards, reports and forecasts from the chat, or have it run an analysis on your data.

Available on Trial, Starter, Professional and Enterprise.

mcp.json
{
  "mcpServers": {
    "claribi": {
      "url": "https://claribi.com/mcp/v1/",
      "headers": { "Authorization": "Bearer claribi_mcp_..." }
    }
  }
}
01  Setup

Connecting a client

01

Create a key

In the app, open Settings, then Developer, then MCP Server, and create a key. It starts with claribi_mcp_ and is shown once. Clients that support OAuth can sign in instead.

02

Add it to the client

Point the client at https://claribi.com/mcp/v1/ with the key as a Bearer token. Guides for Claude Desktop and Cursor are in the docs.

03

Ask

Try "List my clariBI dashboards" or "What was revenue last quarter by region?". The client picks the tool and shows the result in the chat.

02  Tools

26 tools, 3 resources and 2 prompts

Analyses, reports and forecasts use AI credits from your plan, the same as in the app.

GroupTools
Read (12)list_dashboards, get_dashboard, list_reports, get_report, list_data_sources, get_data_source_schema, list_forecasts, get_forecast, get_forecast_run, get_forecast_trust, get_usage, get_billing_status
Act (10)run_analysis, get_analysis_status, generate_report, upload_data_source, ingest_url_data_source, request_oauth_integration_url, check_integration_status, create_forecast, run_forecast, regenerate_forecast_narrative
Sign-up (3, no key needed)check_pricing, register_account, verify_email
Billing (1)create_checkout_session
Resourcesdashboard, report and data source (schema)
Promptsanalyze_question, weekly_review
03  Protocol and security

Details for whoever sets it up

  • JSON-RPC over streamable HTTP, with SSE at /mcp/v1/sse for older clients. Protocol versions 2024-11-05 and 2025-03-26.
  • OAuth 2.1 with dynamic client registration. PKCE with S256 is required.
  • Keys and tokens are stored as SHA-256 hashes; the raw value is shown once.
  • Each tool call is recorded against the user and organization that made it.
04  SDKs

Python and TypeScript clients

Two MIT-licensed SDKs wrap the same tools for your own scripts and agents.

Python

pip install claribi-mcp

TypeScript

npm install @claribicom/mcp

Try it on your own data

The 14-day trial includes the MCP server and 50 AI credits, with no credit card.