Yahoo Finance MCP Server

Live company data and news inside Claude, by ticker. Python + official MCP SDK (FastMCP, stdio) + yfinance.

Building a new MCP server for a different site? Start from MCP_PLAYBOOK.md — a self-contained recipe (with the common failure modes) that uses this repo as the reference implementation.

Tools

Tool	What it returns
get_quote(tickers)	Price, day change, day/52w range, volume, market cap — accepts multiple tickers
get_history(ticker, period, interval, start, end)	OHLCV bars over a period or date range
get_financials(ticker, statement, period)	Condensed income / balance / cashflow, annual or quarterly, + Yahoo link
get_profile(ticker)	Sector, industry, description, employees, key stats
get_valuation(tickers)	P/E, fwd P/E, EV/EBITDA, EV/Rev, P/B, margins, growth, leverage — multi-ticker for comps
get_analyst_view(ticker)	Price targets, consensus, ratings breakdown, EPS/revenue estimates
get_news(ticker, limit)	Headlines with source, timestamp, link

Non-US listings need the exchange suffix: D05.SI (SGX), 0700.HK (HKEX), 7203.T (Tokyo).

Install

cd "D:\Documents\AI Automation\Claude Code Projects\Yahoo Finance"
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

(Already done — the venv in this folder is ready.)

Register in Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "D:\\Documents\\AI Automation\\Claude Code Projects\\Yahoo Finance\\.venv\\Scripts\\python.exe",
      "args": ["D:\\Documents\\AI Automation\\Claude Code Projects\\Yahoo Finance\\server.py"]
    }
  }
}

Register in Claude Code

claude mcp add yahoo-finance -s user -- "D:\Documents\AI Automation\Claude Code Projects\Yahoo Finance\.venv\Scripts\python.exe" "D:\Documents\AI Automation\Claude Code Projects\Yahoo Finance\server.py"

-s user makes it available in every project.

Register in Claude chat (claude.ai) — custom connector

claude.ai only accepts remote servers, so the server must be hosted at a public HTTPS URL. The same server.py serves this with the --http flag (Streamable HTTP at /mcp).

Deploy free on Render (~10 min, one time):

1. Push this folder to a GitHub repo (.venv is gitignored).
2. At https://render.com → New → Web Service → connect the repo. render.yaml is picked up automatically (build: pip install -r requirements.txt, start: python server.py --http, free plan).
3. Copy the service URL, e.g. https://yahoo-finance-mcp.onrender.com.

Then in any Claude account: Settings → Connectors → Add custom connector → paste https://<your-service>.onrender.com/mcp → Add (no authentication needed).

Notes:

• Render's free tier sleeps after ~15 min idle; the first tool call after a pause takes ~30–60 s to cold-start, then it's fast.
• The endpoint has no auth — anyone with the URL can query it. It only serves public market data, but don't post the URL anywhere.
• If tool calls fail from the cloud but work locally, Yahoo is rate-limiting the host's IP — redeploy or upgrade the instance.

Run manually (debugging)

.venv\Scripts\python.exe server.py          # stdio (Claude Desktop / Code)
.venv\Scripts\python.exe server.py --http   # Streamable HTTP on :8000/mcp (claude.ai)

Speaks MCP over stdin/stdout; logs go to stderr. Data is unofficial Yahoo Finance via yfinance — fine for screens and sanity checks, not a substitute for filings or CapIQ on anything that goes in a deliverable.