finnhub
Quotes, company profiles, fundamentals, earnings and IPO calendars, plus market and company news.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"finnhub": {
"url": "https://finnhub.usefulapi.io/mcp"
}
}
}Remote endpoints
https://finnhub.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢finnhub_quote(symbol)
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.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_symbol_search(q, exchange)
Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "Free-text query — a company name or ticker, e.g. 'apple' (required)."
},
"exchange": {
"description": "Restrict results to an exchange, e.g. 'US'.",
"type": "string"
}
},
"required": [
"q"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_company_profile(symbol, isin, cusip)
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.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"description": "Stock ticker symbol, e.g. 'AAPL'.",
"type": "string"
},
"isin": {
"description": "ISIN identifier (use instead of symbol/cusip).",
"type": "string"
},
"cusip": {
"description": "CUSIP identifier (use instead of symbol/isin).",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_company_news(symbol, from, to)
Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date, yyyy-mm-dd (required)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date, yyyy-mm-dd (required)."
}
},
"required": [
"symbol",
"from",
"to"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_market_news(category, minId)
General latest market news by category. Finnhub REST: GET /news.
Input Schema
{
"type": "object",
"properties": {
"category": {
"description": "News category — 'general' (default), 'forex', 'crypto' or 'merger'.",
"type": "string",
"enum": [
"general",
"forex",
"crypto",
"merger"
]
},
"minId": {
"description": "Only return news with an id greater than this (pagination).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_basic_financials(symbol, metric)
Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
},
"metric": {
"description": "Metric group to fetch — 'all' (default) returns every available metric.",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_recommendation_trends(symbol)
Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period. Finnhub REST: GET /stock/recommendation.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_earnings_surprises(symbol, limit)
Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
},
"limit": {
"description": "Limit the number of periods returned (most recent first).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_price_target(symbol)
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.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_peers(symbol, grouping)
Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
},
"grouping": {
"description": "Peer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default).",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_insider_transactions(symbol, from, to)
Insider transactions (Form 3/4/5 filings) for a company, optionally within a date range. Finnhub REST: GET /stock/insider-transactions.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Stock ticker symbol, e.g. 'AAPL' (required)."
},
"from": {
"description": "Start date, yyyy-mm-dd (optional).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "End date, yyyy-mm-dd (optional).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"symbol"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_stock_symbols(exchange, mic, securityType, currency)
List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.
Input Schema
{
"type": "object",
"properties": {
"exchange": {
"type": "string",
"minLength": 1,
"description": "Exchange code, e.g. 'US' (required)."
},
"mic": {
"description": "Filter by Market Identifier Code (MIC).",
"type": "string"
},
"securityType": {
"description": "Filter by security type, e.g. 'Common Stock'.",
"type": "string"
},
"currency": {
"description": "Filter by trading currency, e.g. 'USD'.",
"type": "string"
}
},
"required": [
"exchange"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_market_status(exchange)
Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.
Input Schema
{
"type": "object",
"properties": {
"exchange": {
"type": "string",
"minLength": 1,
"description": "Exchange code, e.g. 'US' (required)."
}
},
"required": [
"exchange"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_earnings_calendar(from, to, symbol)
Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.
Input Schema
{
"type": "object",
"properties": {
"from": {
"description": "Start date, yyyy-mm-dd (optional).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "End date, yyyy-mm-dd (optional).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"symbol": {
"description": "Filter the calendar to a single symbol, e.g. 'AAPL'.",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finnhub_ipo_calendar(from, to)
IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date, yyyy-mm-dd (required)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date, yyyy-mm-dd (required)."
}
},
"required": [
"from",
"to"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence