com.claribi/mcp-server

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.

  shallow
• check_pricing

  List clariBI subscription tiers with prices, AI credits, data source limits, user limits, and headline features. No authentication required.

  shallow
• 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.

  shallow
• 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.

  shallow
• 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".

  shallow
• get_analysis_status

  Check the status of a previously-dispatched run_analysis job. Returns the analysis result if completed.

  shallow
• get_billing_status

  Get the organization's billing status — tier, renewal date, and upgrade options.

  shallow
• get_dashboard

  Fetch one dashboard by ID. Includes widget definitions, the most recent refresh data, and the web URL.

  shallow
• 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.

  shallow
• get_forecast

  Fetch one forecast configuration by ID.

  shallow
• 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.

  shallow
• 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.

  shallow
• get_report

  Fetch one generated report by ID.

  shallow
• get_usage

  Get the organization's current AI credit usage, data source count, user count, and rate-limit headroom.

  shallow
• 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.

  shallow
• list_dashboards

  List dashboards in your clariBI organization. Returns id, name, status, last refresh, and a URL you can open in a browser.

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

  shallow
• 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.

  shallow
• list_reports

  List generated reports in your clariBI organization. Returns id, title, status, output format, and download URL.

  shallow
• 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.

  shallow
• 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.

  shallow
• 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.

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

  shallow
• 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.

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

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

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/55874c87-568b-423c-b962-a50223f20766/badge.svg)](https://vouch.tools/servers/55874c87-568b-423c-b962-a50223f20766)