MCP Directory

How to add Yahoo Finance MCP Server to Windsurf

Query stock data, news, financials, options, and generate charts from Yahoo Finance via yfinance. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 158★ · stdio · no auth

Windsurf config for Yahoo Finance MCP Server

uvx yfmcp@latest
{
  "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.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Yahoo Finance MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Yahoo Finance MCP Server's tools become available to Cascade.

Before you start

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

What Yahoo Finance MCP Server can do in Windsurf

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.

Yahoo Finance MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Yahoo Finance MCP Server config there under the "mcpServers" key and restart the client.

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.

View repo Full Yahoo Finance MCP Server page