MCP Directory

How to add Yahoo Finance MCP Server to Cursor

Query stock data, news, financials, options, and generate charts from Yahoo Finance via yfinance. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Yahoo Finance MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Yahoo Finance MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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