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…

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • 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
  • Check Pricing: List clariBI subscription tiers with prices, AI credits, data source limits, user limits, and headline features. No authentication required.
  • 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.

What data it sees

Do you need an account

No: the server works without sign-in

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

How to connect clariBI.com to Claude

The server address to paste into Claude settings:

https://claribi.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect clariBI.com to ChatGPT

The server address to paste into ChatGPT settings:

https://claribi.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect clariBI.com to Cursor

The server address to paste into Cursor settings:

https://claribi.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (19)

Raw names from tools/list. Only developers need these.

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