Yahoo Finance MCP Server

Query stock data, news, financials, options, and generate charts from Yahoo Finance via yfinance.

Unverified

stdio (local)

No auth

Python

View repo 158

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

uvx yfmcp@latest

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "yahoo-finance-mcp-server": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Python >= 3.12
uv package manager (for the recommended uvx/uv install) or Docker

About Yahoo Finance MCP Server

Yahoo Finance MCP Server (PyPI package yfmcp) lets AI assistants query Yahoo Finance data via the yfinance library. It covers comprehensive stock data, income statement / balance sheet / cash flow financials, financial news, search across quotes and news, sector top-rankings, predefined and custom screeners (including a purpose-built bullish-gappers screener), historical OHLCV price data, options expiration dates and chains, and major/institutional/mutual-fund/insider ownership data. Price history can be returned as markdown tables or as candlestick, VWAP, and volume-profile charts encoded as Base64 WebP images for efficient token usage.

Tools & capabilities (11)

yfinance_get_ticker_info

Retrieve comprehensive stock data including company info, financials, valuation metrics, trading info, dividends, and governance data for a given symbol.

yfinance_get_ticker_news

Fetch recent news articles and press releases for a specific stock, returned as a JSON array with title, summary, publication date, provider, URL, and thumbnail.

yfinance_search

Search Yahoo Finance for stocks, ETFs, and news articles; search_type can be 'all', 'quotes', or 'news'.

yfinance_get_top

Get top-ranked financial entities within a market sector (top_etfs, top_mutual_funds, top_companies, top_growth_companies, or top_performing_companies).

yfinance_screen

Run Yahoo Finance screeners using predefined screener keys (e.g. 'day_gainers') or custom equity/fund query trees with operator/operands nodes.

yfinance_screen_gappers

Run a purpose-built custom screener for opening-session bullish gappers, filterable by percent change, price, volume, market cap, and region.

yfinance_get_price_history

Fetch historical OHLCV price data over a period/interval as a markdown table, or generate a price_volume, vwap, or volume_profile chart returned as a Base64-encoded WebP image.

yfinance_get_financials

Fetch income statement, balance sheet, and cash flow statements with historical data at annual, quarterly, or ttm frequency.

yfinance_get_holders

Fetch major holders, institutional holders, mutual fund holders, insider transactions/purchases/roster, with a configurable per-section row limit.

yfinance_get_option_dates

Fetch available option expiration dates for a stock as a JSON array in YYYY-MM-DD format.

yfinance_get_option_chain

Fetch option chain data (calls and/or puts) for a stock, including strike, last price, bid/ask, volume, open interest, implied volatility, and ITM status, keyed by expiration date.

When to use it

Pull a stock's company info, valuation metrics, and key financials directly in an AI chat
Generate candlestick, VWAP, or volume-profile charts for technical analysis
Screen the market for bullish gappers or custom equity/fund criteria
Inspect option chains, expiration dates, and implied volatility for a ticker
Review institutional, mutual fund, and insider ownership for a company

Yahoo Finance MCP Server FAQ

Does it require an API key?

No. The server pulls public data via the yfinance library, so no authentication or API key is configured in the README.

How are charts returned?

When a chart_type is requested on yfinance_get_price_history, the server returns a Base64-encoded WebP image for efficient token usage; otherwise price data comes back as a markdown table.

How do I run it?

Add it to your MCP client config with command 'uvx' and args ['yfmcp@latest'] (recommended), or use the Docker image narumi/yfinance-mcp, or run from a cloned source checkout with uv.

#finance #yahoo-finance #stocks #yfinance #options #charts #python

Alternatives to Yahoo Finance MCP Server

Compare all alternatives →

Stripe MCP Server (Agent Toolkit)

Finance & Payments

1.9k

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured

Verified

stdio (local)

API key

TypeScript

12 tools

Updated 1 month agoRepo

Coinbase AgentKit MCP Extension

Finance & Payments

900

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 1 month agoRepo

Alpaca MCP Server

Finance & Payments

820

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified

stdio (local)

API key

Python

12 tools

Updated 1 month agoRepo

Compare Yahoo Finance MCP Server with:

vs Stripe MCP Server (Agent Toolkit)vs Coinbase AgentKit MCP Extension vs Alpaca MCP Server vs MetaTrader MCP Server