Most finance servers assume one laptop; this one ships an HTTP transport and a Dockerfile so a single instance can serve a team, with `YF_MCP_API_KEY` as the door. The data is Yahoo's, which shows in the labelling: the crypto and forex tools are marked best-effort and can be rate-limited upstream, and the balance-sheet tool notes validation errors on some symbols.
A TypeScript server over Yahoo Finance covering market data, company financials, sentiment and cross-asset quotes. It ships a Dockerfile and an HTTP transport, so the same server runs locally over stdio or as a deployed endpoint several clients connect to.
- Real-time quotes for up to 100 symbols per request, each response carrying a completeness score and its cache age — `get_quote`
- OHLCV history over a date range at daily, weekly or monthly intervals, with gap and split detection — `get_historical_prices`, `get_historical_prices_multi`
- Company financial statements, annual or quarterly — `get_balance_sheet`, `get_income_statement`, `get_cash_flow_statement`
- Earnings history with actual-versus-estimate surprises and the next earnings date — `get_earnings`
- Analyst ratings and target prices, plus institutional, fund and insider ownership — `get_analysis`, `get_major_holders`
- Options chains with Greeks, filterable to ITM or OTM — `get_options`
- A company overview, its news, trending symbols by region, and a screener over sector, market cap, P/E, dividend yield and beta — `get_quote_summary`, `get_news`, `get_trending_symbols`, `screener`
- Crypto and currency-pair quotes, both marked best-effort by the project — `get_crypto_quote`, `get_forex_quote`
No Yahoo account or key. `npm install -g @mustafa.ramx/finmcp`, then run `finmcp`; or build the bundled Dockerfile. For a cloud deployment the start command is `node dist/http.js` — the server reads `PORT` and defaults to 3333, and `YF_MCP_API_KEY` optionally locks a public endpoint behind `...?key=YOUR_SECRET`. Rate limits, cache TTLs and circuit-breaker thresholds come from a `config.json`.
One command — npm install -g @mustafa.ramx/finmcp