Skip to content

v0.1.0: Initial release — real-time US-equity market data via Finnhub

Choose a tag to compare

@cyanheads cyanheads released this 14 Jun 08:47
· 16 commits to main since this release
3ff385c

Initial release — real-time US-equity market data via Finnhub

First release of finnhub-mcp-server, built on @cyanheads/mcp-ts-core. Wraps the Finnhub REST API (v1): start from a company name, resolve it to a US ticker, then pull a live quote, company context, earnings, news, and analyst consensus. Free tier covers US equities only and requires a free FINNHUB_API_KEY.

Added:

  • finnhub_search_symbols — resolve a company name or partial ticker to US symbols, best US match first; each result carries isLikelyUS so an agent avoids spending a call on an unreachable international symbol.
  • finnhub_get_quote — real-time quote paired with /stock/market-status, so priceIsLive states whether the price is live or the prior close; all-zero sentinel surfaces as symbol_not_found.
  • finnhub_get_company — one-call company context (profile + fundamentals + peers); nullable fundamentals surfaced honestly, metrics/peers degrade to partial on sub-fetch failure.
  • finnhub_get_earnings — history (past quarters with surprise %) and calendar (upcoming releases in a date window) modes.
  • finnhub_get_news — company (one symbol over a date range) and market (headlines by category) modes.
  • finnhub_get_recommendations — analyst recommendation trends per month, newest first; empty coverage surfaces as no_coverage.
  • finnhub://news-categories resource — the four valid market-news categories.

The API key rides the token query parameter and is stripped from every thrown error and log line; a bad or missing key fails loud as ConfigurationError, never as 'no data'.

40 tests pass; bun run devcheck clean.