Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and news via Finnhub.
If you already use Finnhub, the finnhub mcp server is the piece that lets your assistant work with it directly. Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and news via Finnhub.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
finnhub_search_symbols — Resolve a company name or partial ticker to US stock symbols, best US match first. The entry point for every other toolfinnhub_get_quote — Real-time price quote for one US symbol, paired with live market-status so the response states whether the price is live or the prior closefinnhub_get_company — Full company context in one call — profile, headline fundamentals (P/E, EPS, margins, growth), and sector peersfinnhub_get_earnings — Earnings in two modes: a symbol's past quarters with actual-vs-estimate surprises (history), or market-wide upcoming releases in a date windowfinnhub_get_news — Financial news in two modes: recent articles for one symbol over a date range (company), or broad market headlines by category (market)finnhub_get_recommendations — Analyst recommendation trends for one US symbol — strong-buy / buy / hold / sell / strong-sell counts per month, newest firstPrerequisites — The Prerequisites tool exposed by this serverInstallation — The Installation tool exposed by this serverConfiguration is passed through the environment: MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, FINNHUB_API_KEY, FINNHUB_BASE_URL, MCP_HTTP_ENDPOINT_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
.TO or .DE) and candle/forex endpoints are paid-tier and return a clear error.Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.
Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Finnhub's toolset — finnhub_search_symbols, finnhub_get_quote, finnhub_get_company and 5 more — is a fair guide to whether it matches your workflow. It is maintained by cyanheads; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| finnhub_search_symbols | Resolve a company name or partial ticker to US stock symbols, best US match first. The entry point for every other tool. |
| finnhub_get_quote | Real-time price quote for one US symbol, paired with live market-status so the response states whether the price is live or the prior close. |
| finnhub_get_company | Full company context in one call — profile, headline fundamentals (P/E, EPS, margins, growth), and sector peers. |
| finnhub_get_earnings | Earnings in two modes: a symbol's past quarters with actual-vs-estimate surprises (history), or market-wide upcoming releases in a date window (calendar). |
| finnhub_get_news | Financial news in two modes: recent articles for one symbol over a date range (company), or broad market headlines by category (market). |
| finnhub_get_recommendations | Analyst recommendation trends for one US symbol — strong-buy / buy / hold / sell / strong-sell counts per month, newest first. |
| Prerequisites | The Prerequisites tool exposed by this server. |
| Installation | The Installation tool exposed by this server. |
{
"mcpServers": {
"finnhub-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/finnhub-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"FINNHUB_API_KEY": "your-api-key"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
.TO or .DE) and candle/forex endpoints are paid-tier and return a clear error.| Variable | Description | Required |
|---|---|---|
| MCP_TRANSPORT_TYPE | Configuration value read at startup. | Optional |
| MCP_LOG_LEVEL | Configuration value read at startup. | Optional |
| FINNHUB_API_KEY | Credential the server authenticates with. | Yes |
| FINNHUB_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| MCP_HTTP_ENDPOINT_PATH | Filesystem location the server is allowed to use. | Optional |
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.