v0.1.0: Initial release — real-time US-equity market data via Finnhub
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-categoriesresource — 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.