# clariBI

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

- name: com.claribi/mcp-server
- version: 1.0.0
- connection class: unknown (unknown)
- trust: 59/100 flags: unreachable
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.claribi%2Fmcp-server
- tools: https://api.protogrid.dev/v1/servers/com.claribi%2Fmcp-server/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "claribi": {
      "type": "http",
      "url": "https://claribi.com/mcp/v1/"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 0
- freshness: 65
- provenance: 85
- drivers: +repository +dns-namespace +website -unreachable(4 failures) ~updated-140d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 26 of 26 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 12 of 26 tools declare all four hints; missing: get_analysis_status (destructiveHint); get_dashboard (destructiveHint); get_data_source_schema (destructiveHint); …
- pass `tools.token_cost`: about 5,165 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 26, about 5,165 tokens to load them all
- tool set hash: 6de44524924758dc6eea37c2064dc451
- badge: [![protogrid quality](https://protogrid.dev/badge/com.claribi/mcp-server.svg)](https://protogrid.dev/servers/com.claribi/mcp-server)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://claribi.com/mcp/v1/ (streamable-http, auth none, reachable false, uptime30d 0.96039605)
- https://claribi.com/mcp/v1/sse (sse, auth none, reachable false, uptime30d 0.9607843)

## Packages

_none_

## Tools (26)

- `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.
- `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.
- `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.
- `generate_report`: Generate a written report from a report template and your data sources, in the background. Uses AI credits. Returns a job id: poll get_analysis_status until it completes; the result names the new report, which get_report returns.
- `get_analysis_status`: Check the status of a previously-dispatched run_analysis job. Returns the analysis result if completed.
- `get_billing_status`: Get the organization's billing status — tier, renewal date, and upgrade options.
- `get_dashboard`: Fetch one dashboard by ID. Includes widget definitions, the most recent refresh data, and the web URL.
- `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.
- `get_forecast`: Fetch one forecast configuration by ID.
- `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.
- `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.
- `get_report`: Fetch one generated report by ID.
- `get_usage`: Get the organization's current AI credit usage, data source count, user count, and rate-limit headroom.
- `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.
- `list_dashboards`: List dashboards in your clariBI organization. Returns id, name, status, last refresh, and a URL you can open in a browser.
- `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).
- `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.
- `list_reports`: List generated reports in your clariBI organization. Returns id, title, status, output format, and download URL.
- `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.
- `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.
- `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.
- `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).
- `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.
- `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).
- `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).