clariBI.com
clariBI exposes a Model Context Protocol server so external LLM clients (Claude Desktop, Cursor, ChatGPT custom GPTs, generic MCP-aware agents) can create accounts, upload CSV / Excel / JSON / PDF files (inline or by URL, with server-side SSRF guard), connect Google Ads / Analytics 4 / Search Console / Sheets / Drive / BigQuery / Meta Ads / Jira / Confluence via OAuth handoff, run natural-language analyses against connected sources, and generate reports. 19 tools, 3 resources, 2 prompts. OAuth 2.1 with Dynamic Client Registration and PKCE plus API-key fallback. Streamable HTTP and SSE transports. Python and TypeScript SDKs, codegen-driven from the live tool catalog.
How to connect
https://claribi.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(19)-
check_integration_statusPoll 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.
-
check_pricingList clariBI subscription tiers with prices, AI credits, data source limits, user limits, and headline features. No authentication required.
-
create_checkout_sessionCreate 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.
-
generate_reportCreate 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".
-
get_analysis_statusCheck the status of a previously-dispatched run_analysis job. Returns the analysis result if completed.
-
get_billing_statusGet the organization's billing status — tier, renewal date, and upgrade options.
-
get_dashboardFetch one dashboard by ID. Includes widget definitions, the most recent refresh data, and the web URL.
-
get_data_source_schemaFetch 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.
-
get_reportFetch one generated report by ID.
-
get_usageGet the organization's current AI credit usage, data source count, user count, and rate-limit headroom.
-
ingest_url_data_sourceCreate 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.
-
list_dashboardsList dashboards in your clariBI organization. Returns id, name, status, last refresh, and a URL you can open in a browser.
-
list_data_sourcesList the data sources connected to your clariBI organization. Returns id, name, source_type, status, last sync time, and the number of rows (when known).
-
list_reportsList generated reports in your clariBI organization. Returns id, title, status, output format, and download URL.
-
register_accountBegin 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.
-
request_oauth_integration_urlInitiate 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.
-
run_analysisRun 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).
-
upload_data_sourceCreate 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).
-
verify_emailComplete 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).