get_quoteLABSCO SUMMARY
Deploy it once, point several clients at it.
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.
What it is
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.
What you get
- 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
Requirements
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.
Setup effort
One command — npm install -g @mustafa.ramx/finmcp
USE CASES
01
Sizing up a company before a call
Pull the profile and key statistics, then the income statement and the analyst view, in one pass rather than four browser tabs.
02
Checking whether an earnings beat was real
Read the quarterly actuals against estimates, then the news around the print, before deciding what the move meant.
03
Finding candidates instead of checking one ticker
Filter by sector, market cap and P/E to get a list, and see what is moving on volume today.
04
Pricing an options position
Fetch the chain for an expiration with Greeks and implied volatility attached, filtered to in- or out-of-the-money strikes.
16 tools
Listed in project docs. Your client may show a different list.
get_historical_pricesget_historical_prices_multiget_quote_summaryget_balance_sheetget_income_statementget_cash_flow_statementget_earningsget_analysisget_major_holdersget_newsget_optionsget_trending_symbolsscreenerget_crypto_quoteget_forex_quoteBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
finmcp on PATH
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @mustafa.ramx/finmcpMCP Clients
Claude Desktop — npm, Cursor — npm, Cline — npm
JSON
{
"mcpServers": {
"finmcp": {
"command": "finmcp"
}
}
}
