Finnhub MCP Server

Finnhub

Real-time financial market data covering stocks, company fundamentals, news, insider activity, and regulatory filings. Most company- and equity-scoped reads require a stock ticker symbol.

Entity Domains

Company Data (requires symbol)

• Company Profile — name, industry, market cap, IPO date, logo URL, exchange, shares outstanding. The starting point for any company research.
• Financial Reports — standardized financial data from SEC filings (revenue, net income, EPS). Use freq for annual or quarterly.
• Earnings — actual EPS vs analyst estimate, surprise percentage per quarter. Use for earnings season analysis.

Market Data (requires symbol)

• Stock Quote — real-time price, open, high, low, previous close, timestamp. The default first check on a ticker.
• Recommendations — analyst buy/hold/sell/strong-buy/strong-sell counts by month.

News

• Market News — broad market news by category (general, forex, crypto, merger). Does NOT require a symbol.
• Company News — company-specific news. Requires symbol + from_date + to_date (YYYY-MM-DD).

Insider Activity (requires symbol)

• Insider Sentiment — monthly aggregated insider buying/selling (MSPR metric).
• Insider Transactions — individual insider trades with names, titles, shares, prices.

Regulatory (requires symbol)

• SEC Filings — 10-K, 10-Q, 8-K filings with form type, date, and URL. Filter by form type.

Reference

• Stock Symbols — all symbols for an exchange. Requires exchange (e.g. US, L, T, HK). Use to discover valid symbols.

Workflows

• Company deep dive: profile → live quote → financial statements → insider sentiment → filings timeline
• Earnings analysis: reported results vs estimates, then analyst recommendation trends
• News monitoring: broad market headlines first, then ticker-scoped stories with a bounded date window
• Symbol lookup: enumerate an exchange’s symbols, then reuse those tickers in downstream pulls

Gotchas

• symbol is the key parameter: most equity reads need a US ticker symbol (e.g. AAPL, MSFT, TSLA). Discover valid codes via the exchange symbol listing tools.
• Exchange codes: US (US stocks), L (London), T (Tokyo), HK (Hong Kong), SS (Shanghai).
• Vendor throttling: Default access is capped around 60 calls/minute; some datasets require vendor premium entitlements.
• Date params: company news, insider sentiment, insider transactions, and SEC filings accept from_date/to_date in YYYY-MM-DD format.
• Market news: category is required (general, forex, crypto, merger). Paginate with minId.