How do I add Clarifo to Claude?

Open the Clarifo listing in the Anthropic Connectors Directory at claude.ai/directory/connectors/clarifo and click Connect. Sign in with the same account you use on clarifo.com when the OAuth window appears; Claude then stores the connector across web, desktop, and mobile.

Which MCP clients does Clarifo work with?

Any MCP client that supports OAuth 2.1. Confirmed clients include ChatGPT (the Clarifo app in the ChatGPT apps directory), Claude for web, Claude Desktop (macOS and Windows), Claude on iOS and Android, Claude Code, and Cursor. The endpoint is streamable HTTP at https://mcp.clarifo.com/mcp.

Do I need a Clarifo API key to use the MCP server?

No. Claude, ChatGPT, Cursor and other interactive clients connect with OAuth 2.1, so there is no key to paste. A Data API clf_ key also works as a Bearer token, for headless integrations that cannot run the OAuth sign-in; API keys come with Pro and Enterprise plans.

Which plans include MCP access?

MCP is included in both Standard and Pro, and in Enterprise plans. Normal use is not metered; fair-use limits only stop bulk extraction. Both plans can be tried free for 7 days (EUR 0 today, charged when the trial ends unless you cancel); the trial includes that plan's MCP access.

Which tools are Pro-only?

Four capabilities run Clarifo's own AI and require Pro (or a Team seat): document_summary, answer_reporting_standards, the intelligence brief (intelligence with op="brief") and score_ceo_sentiment_for_company. Every other tool — search, financials, screening, forecasts, valuation, Visual Story — is available on Standard.

Can the MCP server write to my Clarifo workspace?

No. The MCP server is read-only by design. It can read your workspace items via list_workspace_items and get_workspace_item, but there is no tool that creates, edits, or deletes data.

How are sources cited?

Every read tool returns page_id values. get_filing_snapshot resolves each page_id into a viewable page render for Nordic filings, or a SEC EDGAR link for US filings, so answers stay audit-grade.

Why does an MCP tool return available=false?

First North small caps do not file iXBRL/ESEF, so full statement tools return available=false for them. Use screen_companies for pre-aggregated metrics and search_filing_content for the qualitative text. Full statements exist for HEL/STO main-list and US issuers.

Get started

MCP server

Clarifo as a financial research tool in ChatGPT and Claude — SEC EDGAR and Nordic filings inside ChatGPT, Claude, Cursor and any MCP client.

The Clarifo MCP server exposes the same Nordic + US filings dataset that powers the Data API, but as Model Context Protocol tools instead of REST endpoints. Connect it once and your AI assistant — ChatGPT, Claude Desktop, Claude on the web, Cursor, or any MCP client — can search filings, pull financials, compare companies, screen the universe, and cite every number back to a source page.

Endpoint

The server speaks streamable HTTP at a single URL:

MCP URL

https://mcp.clarifo.com/mcp

Authentication is OAuth 2.1 — there are no clf_ keys to paste. On first connection your client opens a browser, you sign in with the same account you use on clarifo.com, and the client stores the grant. Works with any MCP client that supports OAuth.

For headless integrations that cannot run an interactive sign-in, the server also accepts a Data API key as a bearer token (Authorization: Bearer clf_...). API keys come with the Pro and Enterprise plans; see Authentication.

No account yet? Pick Start your 7-day free trial on that sign-in screen. You create the account, start the trial at Stripe Checkout (card required, EUR 0 today, cancel anytime before the first charge), and are returned to your MCP client with the connector live.

Connect

Claude (web & desktop)

Clarifo is in Anthropic's Connectors Directory, so no URL paste is needed:

Open the Clarifo listing in the directory.
Click Connect.
Sign in with your Clarifo account when the OAuth window appears.

Claude remembers the connection; Clarifo's tools then appear automatically and are called whenever your question needs data. The same link works on Claude for web, macOS, Windows, iOS, and Android — the connector is stored per-account, not per-device.

Config file (Cursor & others)

Clients that read a JSON config use the same URL with auth: "oauth":

Claude Desktop

{
  "mcpServers": {
    "clarifo": {
      "url": "https://mcp.clarifo.com/mcp",
      "auth": "oauth"
    }
  }
}

Restart the client after editing the config. The first request triggers the OAuth login.

Plans & limits

MCP access is bundled with the paid plans — there is no separate signup, and normal use is not metered.

Plan	Tools	Fair-use cap
Standard	All data tools	3,000 calls / 30 days
Pro	All tools, incl. the four below	20,000 calls / 30 days
Team	All tools, incl. the four below (every seat)	40,000 calls / 30 days
Enterprise	All data tools	per contract

A 7-day Pro trial has a cap of 20,000 calls and includes the four tools below. A Standard trial keeps the Standard cap and does not include them.

Every plan also has a burst cap of 120 calls per minute, which stops bulk extraction and is far above what an assistant does in a conversation.

Four capabilities run Clarifo's own AI and are gated to Pro (and Team seats): document_summary, answer_reporting_standards, the narrated brief of intelligence (op="brief") and score_ceo_sentiment_for_company. Everything else is available on Standard, including the other intelligence operations.

What the AI can call

The model chooses the right tool from your question; you do not call these directly. The catalog mirrors the Data API plus several AI-native composites:

Area	Tools
Companies	`resolve_entities` (names / tickers to canonical companies), `discover_companies` (by business profile), `get_sector_peer_set`
Filings	`search_filings` (also `mode="calendar"` for scheduled report dates and `mode="season"` for how an earnings season is going), `search_filing_content` (RAG, incl. `index="sp500"` and `include_adjacent_pages`; falls back to keyword search when a company's pages are not in the semantic index yet), `get_filing_snapshot` (`include_text` for the full page text, `highlight` to open the page at a cited figure), `fetch_edgar_filing_on_demand` (US fallback)
Financials	`get_company_financials`, `get_financial_statement`, `compare_companies`, `get_company_profile`, `get_company_snapshot`, `research_company`, `dd_quickscan` (pre-due-diligence pack)
Segments (US)	`get_segment_financials` (one company with the segments it reports, or 2-5 side by side), `screen_segments`
Screening	`screen_companies`, `screen_companies_multi`, `screen_quality_growers`, `screen_metric_trend`
Geography	`get_revenue_geography`
Valuation & analytics	`value_company` (DCF / reverse DCF / implied expectations / multiples), `get_valuation_history`, `get_industry_valuation_benchmark`, `forecast_financials`, `detect_inflection_points`, `get_stock_price`
US filings data	`company_events` (8-K), `governance` (DEF 14A proxy), `insider_activity` (Form 4), `ownership` (13F)
Signals	`intelligence` (anomaly signals; the narrated `op="brief"` is Pro), `get_ceo_barometer`, `score_ceo_sentiment_for_company` (Pro)
Documents & standards	`document_summary` (Pro, single / compare), `answer_reporting_standards` (Pro, IFRS / US GAAP / local GAAP), `reporting_change` (IASB / EFRAG projects)
Output	`generate_visual_cards`, `get_visual_cards_guide`, `render_chart` (PNG fallback)
Workspace	`list_workspace_items`, `get_workspace_item`

Every read tool returns page_id values; get_filing_snapshot resolves each into a viewable page render (Nordic) or a SEC EDGAR link (US) for audit-grade citations.

Example prompts

Once connected, ask in natural language:

"Compare NVIDIA and AMD data-center segment revenue and gross margin across the last four quarters."
"Get Nokia Q1 2026 revenue and compare it to Ericsson for the same quarter."
"Summarize the AI risk factors in Microsoft's latest 10-K and compare them to Alphabet's."
"List S&P 500 software companies with revenue growth above 20% and FCF margin above 25% in 2025."

Troubleshooting

Symptom	Cause	Fix
Connection fails / "couldn't connect"	URL is missing the `/mcp` path	The endpoint is `https://mcp.clarifo.com/mcp`, not the bare domain. Re-paste the full URL including `/mcp`.
OAuth window opens but won't complete	You signed in with a different account or sign-in method than the one you use on Clarifo	Sign in with the same account and method (Google or email and password) you use on clarifo.com. The grant is per-account.
`access_denied` after sign-in	The account has no active plan	MCP requires Standard, Pro or Enterprise (or a live 7-day trial). Upgrade at clarifo.com/pricing and reconnect with the same account.
Tools don't appear after connecting	Client hasn't refreshed the tool list	Restart the client (Cursor/Claude Desktop read tools on launch). In Claude on the web, remove and re-add the connector.
A financials tool returns `available=false`	First North small caps don't file iXBRL/ESEF	Use `screen_companies` for pre-aggregated metrics and `search_filing_content` for the qualitative text. Full statements exist only for HEL/STO main-list and US issuers.
A tool says it needs a higher plan	The four AI-narrated capabilities (see Plans & limits) are Pro-only	Upgrade to Pro, or use the non-gated tools (e.g. `search_filing_content`) for the same source text.
"Too many Clarifo tool calls in a short time"	Burst cap of 120 calls per minute	Wait a minute. Normal conversations never reach it; it stops bulk extraction.
`usage_limit_exceeded` / calls stop working	Fair-use cap for the rolling 30 days reached (see Plans & limits)	Calls free up as older ones leave the 30-day window, or move to Pro.
Live price looks stale	`get_stock_price` is web-sourced with a ~15-minute delay	Expected — quotes are delayed, not real-time, and every observation is timestamped.

Reporting a security issue

Found a security vulnerability in the Clarifo MCP server? Report it to support@clarifo.com. We investigate every report, acknowledge receipt, and ask that you give us reasonable time to remediate before public disclosure. Please do not include third-party personal data in your report.