mcp server

clariBI

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

Description as published by the maintainer. Source

• version 1.0.0
• archived

archived — The linked repository returns 404. It was deleted, renamed or made private.

What this server can do

26 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

check_integration_status(handoff_id)

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. Required: handoff_id.

check_pricing(tier)

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

create_checkout_session(tier, billing_period)

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. Required: tier.

create_forecast(name, source_id, transform, aggregation, description, granularity, metric_path, source_type, horizon_days, non_negative, method_override, include_anomalies, narration_enabled, non_negative_auto, schedule_frequency, include_changepoints, include_correlations, schedule_day_of_week, schedule_day_of_month)

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. Required: name, source_type, source_id, metric_path.

generate_report(title, template_id, output_format)

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". Required: title.

get_analysis_status(job_id)

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

get_billing_status

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

get_dashboard(dashboard_id)

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

get_data_source_schema(data_source_id)

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. Required: data_source_id.

get_forecast(forecast_id)

Fetch one forecast configuration by ID. Required: forecast_id.

get_forecast_run(run_id, forecast_id)

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. Required: forecast_id, run_id.

get_forecast_trust(forecast_id)

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. Required: forecast_id.

get_report(report_id)

Fetch one generated report by ID. Required: report_id.

get_usage

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

ingest_url_data_source(url, name, format, description, wait_seconds)

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. Required: name, url.

list_dashboards(limit, offset, search)

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

list_data_sources(limit, offset, source_type)

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

list_forecasts(limit, offset, is_active)

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.

list_reports(limit, offset, status)

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

regenerate_forecast_narrative(run_id, forecast_id)

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. Required: forecast_id, run_id.

register_account(email, last_name, first_name, accept_terms, organization_name)

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. Required: email, organization_name, accept_terms.

request_oauth_integration_url(provider, integration_type)

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. Required: provider.

run_analysis(question, session_id, wait_seconds)

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). Required: question.

run_forecast(forecast_id, wait_seconds)

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. Required: forecast_id.

upload_data_source(name, format, data_base64, description, wait_seconds)

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). Required: name, format, data_base64.

verify_email(code, password, pending_id)

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). Required: pending_id, code, password.

Last successful function declaration observed on 2026-08-13. Source: https://claribi.com/mcp/v1/. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://claribi.com/mcp/v1/.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/ICS-cz/Claribi
• Website — https://claribi.com
• Remote endpoint (streamable-http) — https://claribi.com/mcp/v1/
• Remote endpoint (sse) — https://claribi.com/mcp/v1/sse