MCP Server
finnhub
io.usefulapi/finnhub
What this MCP does
Provides stock quotes, company profiles, financial metrics, earnings, analyst data, calendars, transactions, and market news.
Capabilities
Tools
15
tools
finnhub_basic_financials
Basic financials
Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'metric': {'type': 'string', 'description': "Metric group to fetch — 'all' (default) returns every available metric."}, 'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_company_news
Company news
Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol', 'from', 'to'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End date, yyyy-mm-dd (required).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start date, yyyy-mm-dd (required).'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_company_profile
Company profile
General company profile — name, country, currency, exchange, industry, market cap, share outstanding, IPO date, logo and more. Provide at least one of `symbol`, `isin` or `cusip`. Finnhub REST: GET /stock/profile2.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'isin': {'type': 'string', 'description': 'ISIN identifier (use instead of symbol/cusip).'}, 'cusip': {'type': 'string', 'description': 'CUSIP identifier (use instead of symbol/isin).'}, 'symbol': {'type': 'string', 'description': "Stock ticker symbol, e.g. 'AAPL'."}}}
finnhub_earnings_calendar
Earnings calendar
Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End date, yyyy-mm-dd (optional).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start date, yyyy-mm-dd (optional).'}, 'symbol': {'type': 'string', 'description': "Filter the calendar to a single symbol, e.g. 'AAPL'."}}}
finnhub_earnings_surprises
Earnings surprises
Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Limit the number of periods returned (most recent first).'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_insider_transactions
Insider transactions
Insider transactions (Form 3/4/5 filings) for a company, optionally within a date range. Finnhub REST: GET /stock/insider-transactions.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End date, yyyy-mm-dd (optional).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start date, yyyy-mm-dd (optional).'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_ipo_calendar
IPO calendar
IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End date, yyyy-mm-dd (required).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start date, yyyy-mm-dd (required).'}}}
finnhub_market_news
Market news
General latest market news by category. Finnhub REST: GET /news.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'minId': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Only return news with an id greater than this (pagination).'}, 'category': {'enum': ['general', 'forex', 'crypto', 'merger'], 'type': 'string', 'description': "News category — 'general' (default), 'forex', 'crypto' or 'merger'."}}}
finnhub_market_status
Market status
Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['exchange'], 'properties': {'exchange': {'type': 'string', 'minLength': 1, 'description': "Exchange code, e.g. 'US' (required)."}}}
finnhub_peers
Company peers
Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}, 'grouping': {'type': 'string', 'description': "Peer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default)."}}}
finnhub_price_target
Price target
Analyst price targets for a symbol — high / low / median / mean target. Note: this is a premium-tier Finnhub endpoint (may return 403 on the free plan). Finnhub REST: GET /stock/price-target.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_quote
Real-time quote
Real-time quote for a stock — current price (c), change (d), percent change (dp), high (h), low (l), open (o), previous close (pc) and unix timestamp (t). Finnhub REST: GET /quote.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_recommendation_trends
Recommendation trends
Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period. Finnhub REST: GET /stock/recommendation.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'minLength': 1, 'description': "Stock ticker symbol, e.g. 'AAPL' (required)."}}}
finnhub_stock_symbols
Stock symbols
List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['exchange'], 'properties': {'mic': {'type': 'string', 'description': 'Filter by Market Identifier Code (MIC).'}, 'currency': {'type': 'string', 'description': "Filter by trading currency, e.g. 'USD'."}, 'exchange': {'type': 'string', 'minLength': 1, 'description': "Exchange code, e.g. 'US' (required)."}, 'securityType': {'type': 'string', 'description': "Filter by security type, e.g. 'Common Stock'."}}}
finnhub_symbol_search
Symbol search
Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': "Free-text query — a company name or ticker, e.g. 'apple' (required)."}, 'exchange': {'type': 'string', 'description': "Restrict results to an exchange, e.g. 'US'."}}}
History
Recent tool changes
Changed
finnhub_ipo_calendar
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_earnings_calendar
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_market_status
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_stock_symbols
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_insider_transactions
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_peers
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_price_target
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_earnings_surprises
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_recommendation_trends
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_basic_financials
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_market_news
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_company_news
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_company_profile
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_symbol_search
Oct. 1, 2026, 2:50 a.m.
Changed
finnhub_quote
Oct. 1, 2026, 2:50 a.m.
Added
finnhub_ipo_calendar
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_earnings_calendar
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_market_status
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_stock_symbols
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_insider_transactions
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_peers
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_price_target
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_earnings_surprises
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_recommendation_trends
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_basic_financials
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_market_news
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_company_news
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_company_profile
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_symbol_search
Sept. 17, 2026, 12:53 p.m.
Added
finnhub_quote
Sept. 17, 2026, 12:53 p.m.
Discover
Similar MCP servers
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…
DFX Real Estate Intelligence
io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…
simplefunctions
io.github.spfunctions/simplefunctions
Provides prediction-market data, thesis analysis, market signals, portfolio tracking, and automated intent-based trading workflow…
EventTrader MCP
com.cymetica/event-trader-mcp
Provides prediction-market research and trading capabilities, including real-time event-market data, CLOB execution paths, fund i…
Signal8
ai.signal8/mcp
Provides SEC filings, dilution data, insider and institutional ownership, and political-trade data.