Connect via MCP

FocusAlpha ships a hosted Model Context Protocol server. Point an MCP-capable client at this URL and the model can search transcripts, pull financials, screen companies, and watch events — every dataset in the API, as tools:

https://mcp.focusalpha.ai/mcp

Connecting takes about a minute: paste the URL into your client, and when it asks you to sign in, log in with your FocusAlpha account and click Approve. That’s it — a dedicated API key is created for that client behind the scenes, so you never copy a key. Revoking that key in the dashboard instantly disconnects the client. Prefer to manage keys yourself (for scripts, agents, or shared configs)? The server also accepts a regular API key — created on the API keys page of your dashboard — as a header on every request:

Authorization: Bearer fa_live_...

Wherever this guide shows fa_live_your_key_here, it is a placeholder — replace it with your own key.

MCP tool calls are ordinary API calls underneath. They spend the same credits and count against the same rate limits as REST requests — see Plans & credits. A missing or invalid credential is rejected with 401 before any data is read.

Pick your client below — the Connect in … entries in the menu at the top right of every docs page jump straight to the matching section.

Claude

Claude on the web, Claude Desktop, and Cowork all connect the same way, through connectors:

Open Customize → Connectors in Claude’s settings.
Click Add custom connector (top-right corner), paste https://mcp.focusalpha.ai/mcp, and save. Leave the OAuth fields under Advanced settings empty.
Click Connect, then sign in with your FocusAlpha account when prompted and click Approve.

Claude Add custom connector dialog — The Add custom connector dialog

Custom connectors are available on every Claude plan, including Free (limited to one custom connector). On Team and Enterprise plans an owner adds the connector under Organization settings → Connectors, and each member then clicks Connect to authorize their own account.

Do not add the server to claude_desktop_config.json with "type": "http" — Claude Desktop silently skips remote servers configured that way. Use the Connectors settings in the Desktop app instead.

ChatGPT

In the ChatGPT desktop app:

Open Settings → Plugins, switch to the MCPs tab, and click Add servers.
Choose Streamable HTTP as the type, set Name to FocusAlpha, and paste https://mcp.focusalpha.ai/mcp into the URL field. Leave the bearer-token and header fields empty, then click Save.

ChatGPT desktop MCP server setup — Settings → Plugins → MCPs → Streamable HTTP

Click Authenticate next to the FocusAlpha server and sign in with your FocusAlpha account — the server won’t return data until you do.

Authenticate the FocusAlpha MCP server — Authenticate the server after saving

On ChatGPT web, custom MCP connectors require Developer mode and a paid plan:

Enable Developer mode in ChatGPT settings (under Advanced settings on most accounts; some show it under Security and login). On Business, Enterprise, and Edu plans a workspace admin has to allow developer mode first.
Open Settings → Connectors and click Create.
Name it FocusAlpha, set the MCP server URL to https://mcp.focusalpha.ai/mcp, choose OAuth as authentication, and save — then sign in with your FocusAlpha account and click Approve.
In a chat, click +, choose Developer mode, and enable the FocusAlpha connector for that conversation.

Every FocusAlpha tool is read-only, so plans that OpenAI restricts to read/fetch actions can still use all of them.

Cursor

One click — Cursor opens its MCP settings with the server pre-filled; click Connect (or Needs login) to sign in:

Or configure it by hand in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) — replace fa_live_your_key_here with a key from the API keys page, or drop the headers line entirely to use the sign-in flow:

{
  "mcpServers": {
    "focusalpha": {
      "url": "https://mcp.focusalpha.ai/mcp",
      "headers": { "Authorization": "Bearer fa_live_your_key_here" }
    }
  }
}

VS Code

One click — VS Code asks you to trust the server, then prompts for the sign-in: Install in VS Code Or add it by hand: run MCP: Add Server from the Command Palette, or create .vscode/mcp.json:

{
  "servers": {
    "focusalpha": {
      "type": "http",
      "url": "https://mcp.focusalpha.ai/mcp"
    }
  }
}

VS Code handles the sign-in flow for remote servers; add a "headers" object with the Authorization header if you prefer a pinned key.

Claude terminal

In the Claude Code terminal, one command adds the server:

claude mcp add --transport http focusalpha https://mcp.focusalpha.ai/mcp

Then run /mcp inside Claude Code and choose Authenticate — the sign-in opens in your browser, and you’re done. Alternatively, you can skip the sign-in by attaching an API key directly. fa_live_your_key_here is a placeholder — replace it with a real key, created on the API keys page of your dashboard:

claude mcp add --transport http focusalpha https://mcp.focusalpha.ai/mcp \
  --header "Authorization: Bearer fa_live_your_key_here"

Workbuddy (Tencent)

Open Workbuddy → MCP 服务管理, then Add MCP server (配置 MCP).
Paste this into mcp.json and click 保存 / Save:

{
  "mcpServers": {
    "focusalpha": {
      "type": "http",
      "url": "https://mcp.focusalpha.ai/mcp"
    }
  }
}

Reload Workbuddy — the FocusAlpha tools are picked up automatically.

Workbuddy MCP config editor — Workbuddy → MCP 服务管理 config editor

Other MCP clients

Any MCP client that speaks the streamable HTTP transport works: configure the URL, then either complete the sign-in flow (if the client supports MCP authorization) or attach the Authorization header. Nothing else is required.

This is the data server. Separately, https://docs.focusalpha.ai/mcp serves this documentation site itself over MCP (search and read the docs) — no API key required. Connect both if you want an agent that can look up the docs and pull the data.

If you use the header method, your API key travels in the client configuration. Keep the config file out of source control, and revoke the key in the dashboard if it leaks. Sign-in (OAuth) connections avoid this entirely — each client gets its own key, visible and revocable in the dashboard.

Available tools

Tools map one-to-one onto the REST API. The model can also call list_datasets and list_coverage at any time to discover what is available and how fresh it is.

Dataset	Tools	REST docs
Earnings call transcripts	`retrieve`, `list_documents`, `get_document`, `get_document_segments`	Semantic retrieval
Agent-ready indexed filings	`get_filings`, `get_filing_items`	Filings, Filing items
Financial statements	`get_income_statements`, `get_balance_sheets`, `get_cash_flow_statements`, `get_all_financials`	Financials
Financial metrics	`get_financial_metrics`	Financial metrics
Segmented financials	`get_segmented_financials`	Segments
Company facts	`get_company_facts`	Company facts
Company search & profile	`search_companies`, `get_company`	Company registry
Discovery	`list_datasets`, `list_coverage`	Coverage & freshness
Institutional holdings (13F)	`get_institutional_holdings`	13F holdings
Insider trades	`get_insider_trades`	Insider trades
Executive compensation & proxy ownership	`get_executive_compensation`, `get_proxy_ownership`	Executive compensation, Proxy ownership
Short interest	`get_short_interest`	Short interest
Adviser directory & profile	`search_institutions`, `get_institution_profile`	Form ADV directory, ADV brochure
Market data & benchmarks	`get_market_data`, `get_benchmark_prices`	Prices, Benchmarks
Macro series & economic calendar	`search_macro_series`, `get_macro_series`, `get_economic_calendar`	Macro data, Series, Economic calendar
Taiwan datasets	`get_taiwan_financials`, `get_taiwan_monthly_revenue`, `get_taiwan_foreign_ownership`	Taiwan financials
Korea datasets	`get_korea_financials`, `get_korea_report_sections`	Korea financials
Form 20-F	`get_adr_20f_notes`, `get_adr_20f_data`	Form 20-F
Japan datasets	`get_japan_financials`, `get_japan_segments`, `get_japan_officers`, `get_japan_ownership`, `get_japan_report_sections`	Japan financials
Japan IR website	`get_japan_transcript`, `get_japan_presentation_deck`, `get_japan_ir_web_disclosure`	Japan IR transcripts, Japan decks, Japan IR disclosures
Taiwan investor conferences, cash flow and ownership	`get_taiwan_earnings`, `get_taiwan_cashflow`, `get_taiwan_ownership`	Taiwan investor conferences
Hong Kong and mainland China financials	`get_hk_financials`, `get_china_financials`, `get_china_report_timing`	Hong Kong financials, China financials
US presentation decks	`get_us_presentation_deck`	US presentation decks
Company screener	`screen_companies`	Company screening
Adviser screener	`screen_institutions`	Adviser screening
ETF screener	`screen_etfs`	ETF screening
ETF directory & profile	`search_etfs`, `get_etf`, `get_etf_taxonomy`	ETF data, Taxonomy
ETF daily series & holdings	`get_etf_history`, `get_etf_holdings`	NAV & shares, Holdings
Real-time company events	`get_company_events`	News events
Real-time company news	`get_company_news`	Company news
Real-time macro news	`get_macro_news`	News themes
Real-time US events and filings	`get_8k_events`, `get_8k_raw_filings`	8-K events, 8-K exhibits
Real-time guidance and changes	`get_guidance`, `get_guidance_changes`	Guidance, Guidance changes
Real-time earnings result analysis	`get_8k_earnings_results`	Earnings results
Prediction-market consensus	`get_prediction_markets_quote`, `get_prediction_markets_consensus`	Prediction markets, Earnings consensus
Exchange disclosures, all markets	`get_company_disclosures`	Global disclosures
Japan, Hong Kong and mainland China disclosures	`get_japan_disclosure`, `get_hong_kong_disclosure`, `get_mainland_china_disclosure`	Japan EDINET, Hong Kong, Mainland China
Company calendar	`get_company_calendar`	Company calendar
8-K company measures and segments	`get_8k_company_measures`, `get_8k_segments`	Company measures, 8-K segments
Outside research	`get_research`	Research
VC investor search	`search_vc_investors`	Venture investors

Every tool is available on every plan; plans differ in credits and rate limits (see Plans and credits). When your credits run out, tools return a clear message rather than data.

Authentication

Creating and managing the API key your MCP client uses.

Plans & credits

What each plan unlocks and how tool calls are metered.

Get started

Core concepts

WebSocket streaming

Screening tools

ETF data

Company essentials

Macro data

Ownership & incentives

Advisers & investors

Real-time events

Account

Claude

ChatGPT

Cursor

VS Code

Claude terminal

Workbuddy (Tencent)

Other MCP clients

Available tools

Authentication

Plans & credits

​Claude

​ChatGPT

​Cursor

​VS Code

​Claude terminal

​Workbuddy (Tencent)

​Other MCP clients

​Available tools

​Related pages

Authentication

Plans & credits

Claude

ChatGPT

Cursor

VS Code

Claude terminal

Workbuddy (Tencent)

Other MCP clients

Available tools

Related pages