Financial

Finnhub MCP Server

Use Studio chat to drive this server — credentials stay in your workspace.

Finnhub provides a real-time financial market data API offering stock, forex, and crypto data, news, and market insights for financial analysis and reporting. It is primarily used by developers and financial analysts to integrate financial data into applications and systems.

11 tools
Agent guide included
API Key
Start Chatting

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

Browse all tools

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 the Finnhub MCP server?

Finnhub provides a real-time financial market data API offering stock, forex, and crypto data, news, and market insights for financial analysis and reporting. It is primarily used by developers and financial analysts to integrate financial data into applications and systems. It provides 11 tools that AI agents can use through the Model Context Protocol (MCP).

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

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

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to chat with Finnhub?

Same flow: Studio opens on this server after sign-in. Keep chatting to call tools from the conversation.

Finnhub MCP Server & Skill — 11 Tools