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 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. MCP uses OAuth 2.1, so there is no clf_ key to paste. The Data API uses clf_ keys; the MCP server does not.

Which plans include MCP access?

MCP is bundled with the paid plans: Plus (2,000 calls/month), Pro (20,000 calls/month), and API/Custom (per contract). The 14-day trial grants full Pro-level MCP access.

Which tools are Pro-only?

Two tools require Pro: document_summary and answer_reporting_standards. Every other tool — search, financials, screening, forecasts, valuation, visual cards — is available on Plus.

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

One-click Clarifo connector for Claude — Nordic and SEC EDGAR filings inside Claude, Cursor, and any MCP client via the Anthropic Connectors Directory.

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

No account yet? Pick Start free trial on that sign-in screen. You create the account, your 14-day trial starts, and you are returned to your MCP client with the connector live — no separate trip to the web app first.

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.

Plan	MCP calls / month	Pro-only tools
Plus	2,000	—
Pro	20,000	Document summaries, Reporting-standards Q&A
API / Custom	per contract	included

Two tools — document_summary and answer_reporting_standards — are gated to Pro. Everything else is available on Plus.

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
Filings	`search_filings`, `search_filing_content` (RAG, incl. `index="sp500"`), `get_filing_snapshot`
Financials	`get_company_financials`, `get_financial_statement`, `compare_companies`, `get_company_profile`, `get_company_snapshot`, `research_company`
Segments (US)	`segment_analysis` (list / financials / compare / screen modes)
Screening	`screen_companies`, `screen_companies_multi`, `screen_quality_growers`, `screen_metric_trend`
Geography	`get_revenue_geography`
Analytics	`forecast_financials`, `value_company` (DCF / reverse DCF / implied expectations / multiples), `detect_inflection_points`, `get_stock_price`
Documents (Pro)	`document_summary` (single / compare modes)
Standards (Pro)	`answer_reporting_standards` (IFRS / US GAAP / local GAAP)
Output	`generate_visual_cards`
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	Sign-in uses Google; you picked a different identity	Sign in with the same Google account you use on clarifo.com. The grant is per-account.
`access_denied` after sign-in	The account has no active plan	MCP requires Plus, Pro, API, or Custom (or a live 14-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	`document_summary` and `answer_reporting_standards` are Pro-only	Upgrade to Pro, or use the non-gated tools (e.g. `search_filing_content`) for the same source text.
`quota_exceeded` / calls stop working mid-month	Monthly MCP call limit reached (see Plans & limits)	Wait for the monthly reset or move to a higher plan.
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.