Get started

MCP server

Use the full Clarifo dataset — Helsinki, Stockholm, and SEC EDGAR — directly inside Claude, Cursor, and any MCP-compatible client. One OAuth connection, no API client to build.

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.

Connect

Claude (web & desktop)

Open claude.ai/customize/connectors.
Click Add custom connector and paste https://mcp.clarifo.com/mcp.
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.

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 — get_document_summary / compare_document_summaries 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)	`get_segment_financials`, `list_company_segments`, `compare_segments`, `screen_segments`
Screening	`screen_companies`, `screen_companies_multi`, `screen_quality_growers`, `screen_metric_trend`
Geography	`get_revenue_geography`
Analytics	`forecast_financials`, `value_company` (DCF / reverse DCF), `detect_inflection_points`, `get_stock_price`, `get_valuation_multiples`
Documents (Pro)	`get_document_summary`, `compare_document_summaries`
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	`get_document_summary`, `compare_document_summaries` 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.