Financial

Finnhub MCP Server

Connect your account, then chat with AI to run tools.

Ask an AI agent for live stock quotes, company profiles, earnings results, market headlines, and filing timelines — connect your Finnhub account once in MCPBundles and research tickers from chat.

Best forEquity AnalystsInvestment ResearchersFinancial AdvisorsMarket Intelligence

Try this workflow

Ticker morning brief

Give me a morning brief on Apple and Microsoft using Finnhub — live prices, company profiles, latest headlines, and analyst recommendation trends in plain language.

Managed
11 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

What you can do with Finnhub

Built for

Equity Analysts, Investment Researchers, Financial Advisors, Market Intelligence Teams

Example workflows

Ticker morning brief

Combines quotes, profiles, news, and recommendations for a daily watchlist.

Try this

Give me a morning brief on Apple and Microsoft using Finnhub — live prices, company profiles, latest headlines, and analyst recommendation trends in plain language.

Earnings season check

Earnings and estimate comparison for post-report analysis.

Try this

For Harbor Analytics portfolio holding NVDA, pull Finnhub earnings history — actual versus estimated EPS, surprise percentages, and what the last four quarters suggest about momentum.

Insider activity scan

Insider sentiment and transaction reads for governance research.

Try this

Review Finnhub insider sentiment and recent insider transactions for Tesla over the past six months and flag any months where selling dominated buying.

Filing timeline

Regulatory filing timeline for compliance and research workflows.

Try this

List recent SEC filings for Amazon from Finnhub — 10-K, 10-Q, and 8-K with dates — and summarize which forms landed in the last 90 days.

Context to know first

What is Finnhub MCP?

It lets AI agents in Cursor, Claude, or ChatGPT read Finnhub market data — stock quotes, company profiles, news, earnings, insider activity, and SEC filings — after you connect your Finnhub account in MCPBundles.

Who is this for?

Analysts and researchers who want ticker lookups, earnings checks, and headline monitoring from chat instead of jumping between dashboards.

Which markets does it cover?

Finnhub supports US and international equities, broad market news categories, and company-scoped reads when you supply a valid ticker symbol.

Related editorial

Finnhub Market Data Workflows with AI

How AI agents assemble morning briefs, earnings checks, insider scans, and filing timelines so researchers answer ticker questions from chat.

Read article

AI Skill
SKILL.md

Domain knowledge for Finnhub — workflow patterns, data models, and gotchas for your AI agent.

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.

Tools in this Server (11)

Finnhub Get Company News

Get news articles about a specific company within a date range. Returns headline, source, URL, summary, and timestamp for each article. Requires 'symb...

Finnhub Get Company Profile

Get a company profile including name, industry, market cap, IPO date, logo URL, exchange, and share outstanding. Requires 'symbol' (e.g. AAPL). The st...

Finnhub Get Earnings

Get historical earnings surprises for a company — actual EPS vs analyst estimate, surprise percentage, and period. Requires 'symbol'. Useful for earni...

Finnhub Get Financials

Get basic financial reports (revenue, net income, EPS, etc.) for a company. Returns standardized financial data from SEC filings. Requires 'symbol' (e...

Finnhub Get Insider Sentiment

Get aggregated insider sentiment (net buying/selling) by month for a company. Shows monthly share purchase ratio (MSPR) and change values. Requires 's...

Finnhub Get Insider Txns

Get individual insider trading transactions — names, titles, shares bought/sold, prices, and SEC filing dates. Requires 'symbol'. Shows whether execut...

Finnhub Get Market News

Get latest market news by category — general, forex, crypto, or merger. Returns headline, source, URL, image, summary, and timestamp. Does not require...

Finnhub Get Quote

Get real-time stock price quote — current price, open, high, low, previous close, and timestamp. Requires 'symbol' (e.g. AAPL). The most-used endpoint...

Finnhub Get Recommendations

Get analyst recommendation trends for a stock — counts of strong buy, buy, hold, sell, and strong sell ratings by month. Requires 'symbol'. Shows how ...

Finnhub Get Sec Filings

Get SEC/regulatory filings for a company — 10-K (annual), 10-Q (quarterly), 8-K (events), and more. Returns form type, filed date, accepted date, and ...

Finnhub List Symbols

List all stock symbols for an exchange. Returns ticker, company name, currency, and type for each symbol. Requires 'exchange' code (e.g. 'US'). Use th...

Frequently Asked Questions

What is Finnhub MCP?

It lets AI agents in Cursor, Claude, or ChatGPT read Finnhub market data — stock quotes, company profiles, news, earnings, insider activity, and SEC filings — after you connect your Finnhub account in MCPBundles.

Who is this for?

Analysts and researchers who want ticker lookups, earnings checks, and headline monitoring from chat instead of jumping between dashboards.

Which markets does it cover?

Finnhub supports US and international equities, broad market news categories, and company-scoped reads when you supply a valid ticker symbol.

Is the data read-only?

Yes. Agents pull market data, news, and filings for research and reporting. Nothing is traded or changed in your brokerage account through this integration.

How do I connect?

Open the Finnhub skill page in MCPBundles, add your connection, and paste the access key from your Finnhub account settings. Usage follows your Finnhub plan limits.

How do I connect Finnhub to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/finnhub. Authentication is handled automatically.

How many tools does Finnhub provide?

Finnhub provides 11 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Finnhub require?

Finnhub uses API Key. Finnhub requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Finnhub to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/finnhub

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Finnhub and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Finnhub will appear under Not connected — select it and click Connect to complete OAuth.
Name: Finnhub
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/finnhub
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Finnhub?

Sign in to connect your credentials and start running tools from the chat.

Finnhub MCP Server