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 | |------|---------------| | yfin_get_historical_prices | OHLCV bars — any ticker, any period, any interval | | yfin_get_stock_info | Price, company profile, key statistics, financial health | | yfin_get_news | Latest news articles for a ticker | | yfin_get_stock_actions | Dividend payments and stock splits |

Financial Statements

| Tool | What it exposes | |------|----------------| | yfin_get_financial_statement | Income statement, balance sheet, cash flow (annual or quarterly) | | yfin_get_holder_info | Major holders, institutions, mutual funds, insider transactions |

Options Intelligence

| Tool | What it maps | |------|-------------| | yfin_get_option_dates | Available expiration dates for a ticker | | yfin_get_option_chain | Full calls or puts chain for a given expiration |

Analyst Signal

| Tool | What it surfaces | |------|----------------| | yfin_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.