@fre4x/yahoo-finance

yahoo-finance — The Market Claw

Markets are not fair. They are fast. The agent that reads prices, filings, and options chains in milliseconds does not lose. It waits.

Part of FRE4X-B1TE — a monorepo of MCP servers built for autonomous agents.

Price history, balance sheets, insider moves, analyst upgrades, options flow — the full operational picture of any publicly traded entity. No API key. No subscription. No delay that matters. This B1TE bites through the noisiest market on earth.

Tools

Price & Market Data

Tool	What it tracks
get_quotes	Batch real-time quotes for multiple tickers
get_historical_prices	OHLCV bars — any ticker, any period, any interval
get_stock_info	Price, company profile, key statistics, financial health
get_news	Latest news articles for a ticker
get_stock_actions	Dividend payments and stock splits

Financial Statements

Tool	What it exposes
get_financial_statement	Income statement, balance sheet, cash flow (annual or quarterly)
get_holder_info	Major holders, institutions, mutual funds, insider transactions

Options Intelligence

Tool	What it maps
get_option_dates	Available expiration dates for a ticker
get_option_chain	Full calls or puts chain for a given expiration

Analyst Signal

Tool	What it surfaces
get_recommendations	Consensus recommendations or firm upgrade/downgrade history

All list tools support pagination via limit / offset. No API key required.

Mock Mode

Run without any API key (returns fixture data of identical shape):

MOCK=true npx @fre4x/yahoo-finance

Deploy

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "npx",
      "args": ["-y", "@fre4x/yahoo-finance"]
    }
  }
}

Development

npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests

License

MIT — WE ARE THE FRE4X.