finnhub
Quotes, company profiles, fundamentals, earnings and IPO calendars, plus market and company news.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"finnhub": {
"url": "https://finnhub.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://finnhub.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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#"
}Comunidad
Evidencia