# clariBI MCP server

AI business intelligence: sign up, ingest data, run analyses, generate reports from any MCP client.

## Links
- Registry page: https://www.getdrio.com/mcp/com-claribi-mcp-server
- Repository: https://github.com/ICS-cz/Claribi
- Website: https://claribi.com

## Install
- Endpoint: https://claribi.com/mcp/v1/
- Auth: Not captured

## Setup notes
- Remote endpoint: https://claribi.com/mcp/v1/
- Remote endpoint: https://claribi.com/mcp/v1/sse

## Tools
- check_integration_status - Poll an OAuth handoff initiated by request_oauth_integration_url. Returns the current status (pending, connected, failed, expired) and, when connected, the data_source_id you can pass to run_analysis. Endpoint: https://claribi.com/mcp/v1/
- check_pricing - List clariBI subscription tiers with prices, AI credits, data source limits, user limits, and headline features. No authentication required. Endpoint: https://claribi.com/mcp/v1/
- create_checkout_session - Create a Stripe Checkout URL the user can open in a browser to upgrade their clariBI subscription. Payment cannot happen inside the LLM; this tool returns a URL. Endpoint: https://claribi.com/mcp/v1/
- create_forecast - Bind a forecast to a metric in your workspace. Stores the configuration, sets up the schedule, and resolves the source binding immediately so a bad source_id or metric_path errors out before any credits are spent. Run the forecast with run_forecast. Endpoint: https://claribi.com/mcp/v1/
- generate_report - Create a new generated report in your clariBI organization. Returns the report id you can poll via get_report, plus a download URL once status reaches "completed". Endpoint: https://claribi.com/mcp/v1/
- get_analysis_status - Check the status of a previously-dispatched run_analysis job. Returns the analysis result if completed. Endpoint: https://claribi.com/mcp/v1/
- get_billing_status - Get the organization's billing status — tier, renewal date, and upgrade options. Endpoint: https://claribi.com/mcp/v1/
- get_dashboard - Fetch one dashboard by ID. Includes widget definitions, the most recent refresh data, and the web URL. Endpoint: https://claribi.com/mcp/v1/
- get_data_source_schema - Fetch the column schema for a data source. Useful before asking run_analysis about specific columns. The schema is derived from the preprocessing metadata clariBI extracted when the source was last synced. Poll this after upload_data_source / ingest_url_data_source until the returned status flips to "active" — that means preprocessing has finished and run_analysis will see the data. Endpoint: https://claribi.com/mcp/v1/
- get_forecast - Fetch one forecast configuration by ID. Endpoint: https://claribi.com/mcp/v1/
- get_forecast_run - Fetch one run of a forecast by ID, or pass run_id="latest" for the most recent run. Returns the full forecast envelope: target series + 30-day projection, correlated drivers (with lag and bootstrap stability), anomalies, structural changes, and credit accounting. Endpoint: https://claribi.com/mcp/v1/
- get_forecast_trust - Returns per-past-run accuracy for a forecast. Each row compares a prior run's projection against the actuals that have materialized since. Use this to see whether your forecasts have been getting MORE or LESS accurate over time, or to spot when a backtest sMAPE was systematically optimistic vs. realised performance. Endpoint: https://claribi.com/mcp/v1/
- get_report - Fetch one generated report by ID. Endpoint: https://claribi.com/mcp/v1/
- get_usage - Get the organization's current AI credit usage, data source count, user count, and rate-limit headroom. Endpoint: https://claribi.com/mcp/v1/
- ingest_url_data_source - Create a new data source by fetching a public URL on the server side. Handles CSV, TSV, JSON, Excel, TXT, and PDF. Private networks (RFC 1918, loopback, cloud metadata) are blocked. Returns the data_source_id once preprocessing has started. Use this for files larger than the 25 MB inline upload cap. Endpoint: https://claribi.com/mcp/v1/
- list_dashboards - List dashboards in your clariBI organization. Returns id, name, status, last refresh, and a URL you can open in a browser. Endpoint: https://claribi.com/mcp/v1/
- list_data_sources - List the data sources connected to your clariBI organization. Returns id, name, source_type, status, last sync time, and the number of rows (when known). Endpoint: https://claribi.com/mcp/v1/
- list_forecasts - List metric forecasts in your clariBI organization. Each row covers one metric: its source binding, horizon, schedule, and the latest run status. Use get_forecast_run to fetch the full forecast result. Endpoint: https://claribi.com/mcp/v1/
- list_reports - List generated reports in your clariBI organization. Returns id, title, status, output format, and download URL. Endpoint: https://claribi.com/mcp/v1/
- regenerate_forecast_narrative - Re-run ONLY the AI narration step against an existing completed forecast run. Costs 1-2 AI credits (no engine work). Returns the new narration; the old one is overwritten in the run record. Refuses when the run is not yet complete or when narration_enabled=false on the forecast. Endpoint: https://claribi.com/mcp/v1/
- register_account - Begin clariBI account signup. Validates the email + organization name, emails a 6-digit verification code, and returns a pending_id. Call verify_email(pending_id, code) within 10 minutes to finish signup and receive an API key. Endpoint: https://claribi.com/mcp/v1/
- request_oauth_integration_url - Initiate an OAuth handoff to a vendor integration (Google Ads, GA4, Search Console, Sheets, Drive, BigQuery, Meta Ads, Jira, Confluence). Returns an authorization URL the user opens in a browser. After the user clicks Allow, the connection is created and you can poll check_integration_status(handoff_id) to find out when the data is ready. Endpoint: https://claribi.com/mcp/v1/
- run_analysis - Run a natural-language analytics question against your connected data sources. Consumes AI credits. Returns either the completed analysis result inline OR a job_id you can poll with get_analysis_status. If list_data_sources returns an empty list, ingest data first with upload_data_source (inline base64), ingest_url_data_source (public URL), or request_oauth_integration_url (Google / Meta / Jira / Confluence). Endpoint: https://claribi.com/mcp/v1/
- run_forecast - Run a forecast now. Reserves AI credits up front, dispatches the backtest + projection + correlation pipeline, and returns either the completed result inline (wait_seconds > 0 and the run finishes in time) or a run_id you can poll with get_forecast_run. Endpoint: https://claribi.com/mcp/v1/
- upload_data_source - Create a new data source from an inline base64-encoded file (CSV, TSV, JSON, Excel, TXT, PDF). The file goes through the same validation and preprocessing as a web upload. Returns the data_source_id you can pass to run_analysis as soon as preprocessing completes (poll get_data_source_schema for readiness or pass wait_seconds to block here). Endpoint: https://claribi.com/mcp/v1/
- verify_email - Complete clariBI signup by submitting the verification code plus a password. Returns an OAuth access_token for immediate use AND a long-lived MCP API key for persistent configuration. The new organization lands on the Trial tier (50 AI credits, 14 days). Endpoint: https://claribi.com/mcp/v1/
- check_integration_status - Poll an OAuth handoff initiated by request_oauth_integration_url. Returns the current status (pending, connected, failed, expired) and, when connected, the data_source_id you can pass to run_analysis. Endpoint: https://claribi.com/mcp/v1/sse
- check_pricing - List clariBI subscription tiers with prices, AI credits, data source limits, user limits, and headline features. No authentication required. Endpoint: https://claribi.com/mcp/v1/sse
- create_checkout_session - Create a Stripe Checkout URL the user can open in a browser to upgrade their clariBI subscription. Payment cannot happen inside the LLM; this tool returns a URL. Endpoint: https://claribi.com/mcp/v1/sse
- create_forecast - Bind a forecast to a metric in your workspace. Stores the configuration, sets up the schedule, and resolves the source binding immediately so a bad source_id or metric_path errors out before any credits are spent. Run the forecast with run_forecast. Endpoint: https://claribi.com/mcp/v1/sse
- generate_report - Create a new generated report in your clariBI organization. Returns the report id you can poll via get_report, plus a download URL once status reaches "completed". Endpoint: https://claribi.com/mcp/v1/sse
- get_analysis_status - Check the status of a previously-dispatched run_analysis job. Returns the analysis result if completed. Endpoint: https://claribi.com/mcp/v1/sse
- get_billing_status - Get the organization's billing status — tier, renewal date, and upgrade options. Endpoint: https://claribi.com/mcp/v1/sse
- get_dashboard - Fetch one dashboard by ID. Includes widget definitions, the most recent refresh data, and the web URL. Endpoint: https://claribi.com/mcp/v1/sse
- get_data_source_schema - Fetch the column schema for a data source. Useful before asking run_analysis about specific columns. The schema is derived from the preprocessing metadata clariBI extracted when the source was last synced. Poll this after upload_data_source / ingest_url_data_source until the returned status flips to "active" — that means preprocessing has finished and run_analysis will see the data. Endpoint: https://claribi.com/mcp/v1/sse
- get_forecast - Fetch one forecast configuration by ID. Endpoint: https://claribi.com/mcp/v1/sse
- get_forecast_run - Fetch one run of a forecast by ID, or pass run_id="latest" for the most recent run. Returns the full forecast envelope: target series + 30-day projection, correlated drivers (with lag and bootstrap stability), anomalies, structural changes, and credit accounting. Endpoint: https://claribi.com/mcp/v1/sse
- get_forecast_trust - Returns per-past-run accuracy for a forecast. Each row compares a prior run's projection against the actuals that have materialized since. Use this to see whether your forecasts have been getting MORE or LESS accurate over time, or to spot when a backtest sMAPE was systematically optimistic vs. realised performance. Endpoint: https://claribi.com/mcp/v1/sse
- get_report - Fetch one generated report by ID. Endpoint: https://claribi.com/mcp/v1/sse
- get_usage - Get the organization's current AI credit usage, data source count, user count, and rate-limit headroom. Endpoint: https://claribi.com/mcp/v1/sse
- ingest_url_data_source - Create a new data source by fetching a public URL on the server side. Handles CSV, TSV, JSON, Excel, TXT, and PDF. Private networks (RFC 1918, loopback, cloud metadata) are blocked. Returns the data_source_id once preprocessing has started. Use this for files larger than the 25 MB inline upload cap. Endpoint: https://claribi.com/mcp/v1/sse
- list_dashboards - List dashboards in your clariBI organization. Returns id, name, status, last refresh, and a URL you can open in a browser. Endpoint: https://claribi.com/mcp/v1/sse
- list_data_sources - List the data sources connected to your clariBI organization. Returns id, name, source_type, status, last sync time, and the number of rows (when known). Endpoint: https://claribi.com/mcp/v1/sse
- list_forecasts - List metric forecasts in your clariBI organization. Each row covers one metric: its source binding, horizon, schedule, and the latest run status. Use get_forecast_run to fetch the full forecast result. Endpoint: https://claribi.com/mcp/v1/sse
- list_reports - List generated reports in your clariBI organization. Returns id, title, status, output format, and download URL. Endpoint: https://claribi.com/mcp/v1/sse
- regenerate_forecast_narrative - Re-run ONLY the AI narration step against an existing completed forecast run. Costs 1-2 AI credits (no engine work). Returns the new narration; the old one is overwritten in the run record. Refuses when the run is not yet complete or when narration_enabled=false on the forecast. Endpoint: https://claribi.com/mcp/v1/sse
- register_account - Begin clariBI account signup. Validates the email + organization name, emails a 6-digit verification code, and returns a pending_id. Call verify_email(pending_id, code) within 10 minutes to finish signup and receive an API key. Endpoint: https://claribi.com/mcp/v1/sse
- request_oauth_integration_url - Initiate an OAuth handoff to a vendor integration (Google Ads, GA4, Search Console, Sheets, Drive, BigQuery, Meta Ads, Jira, Confluence). Returns an authorization URL the user opens in a browser. After the user clicks Allow, the connection is created and you can poll check_integration_status(handoff_id) to find out when the data is ready. Endpoint: https://claribi.com/mcp/v1/sse
- run_analysis - Run a natural-language analytics question against your connected data sources. Consumes AI credits. Returns either the completed analysis result inline OR a job_id you can poll with get_analysis_status. If list_data_sources returns an empty list, ingest data first with upload_data_source (inline base64), ingest_url_data_source (public URL), or request_oauth_integration_url (Google / Meta / Jira / Confluence). Endpoint: https://claribi.com/mcp/v1/sse
- run_forecast - Run a forecast now. Reserves AI credits up front, dispatches the backtest + projection + correlation pipeline, and returns either the completed result inline (wait_seconds > 0 and the run finishes in time) or a run_id you can poll with get_forecast_run. Endpoint: https://claribi.com/mcp/v1/sse
- upload_data_source - Create a new data source from an inline base64-encoded file (CSV, TSV, JSON, Excel, TXT, PDF). The file goes through the same validation and preprocessing as a web upload. Returns the data_source_id you can pass to run_analysis as soon as preprocessing completes (poll get_data_source_schema for readiness or pass wait_seconds to block here). Endpoint: https://claribi.com/mcp/v1/sse
- verify_email - Complete clariBI signup by submitting the verification code plus a password. Returns an OAuth access_token for immediate use AND a long-lived MCP API key for persistent configuration. The new organization lands on the Trial tier (50 AI credits, 14 days). Endpoint: https://claribi.com/mcp/v1/sse

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.claribi
- Version: 1.0.0
- Runtime: Sse, Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 2, 2026
- Source: https://registry.modelcontextprotocol.io