Overview

The Yahoo Finance MCP Server brings the comprehensive financial data from Yahoo Finance to AI assistants via the Model Context Protocol. Powered by the widely-used yfinance Python library, this server provides access to stock quotes, historical prices, financial statements, dividends, splits, and institutional holders — covering global markets.

Community MCP Server:

Built on the popular yfinance library with over 20,000 GitHub stars

Key Features

💹

Real-Time Stock Quotes

Get current stock prices, bid/ask spreads, and pre/post-market data for global equities

📅

Historical Data

Download historical price data with configurable intervals from daily down to 1-minute

📋

Financial Statements

Access income statements, balance sheets, and cash flow statements for any publicly traded company

🏢

Institutional Holdings

View major institutional holders, insider transactions, and fund ownership data

💰

Dividends & Splits

Track dividend history, ex-dividend dates, payout ratios, and stock split events

🌍

Global Market Coverage

Access data from exchanges worldwide including NYSE, NASDAQ, LSE, TSE, ASX, and more

Available Tools

Quick Reference

Tool	Purpose
`get_stock_quote`	Get current stock price and trading information
`get_historical_data`	Download historical price data with configurable period and interval
`get_financials`	Access income statements, balance sheets, and cash flows
`get_institutional_holders`	View major institutional investors and holdings
`get_dividends`	Track dividend history and upcoming ex-dividend dates

Detailed Usage

get_stock_quote▶

Get current stock quote including price, change, volume, and market data for any ticker symbol.

{
  "symbol": "AAPL",
  "include_pre_post": true
}

get_historical_data▶

Download historical price data for any ticker with configurable period and interval.

{
  "symbol": "MSFT",
  "period": "1y",
  "interval": "1d"
}

get_financials▶

Access financial statements including income statement, balance sheet, and cash flow data.

{
  "symbol": "GOOGL",
  "statement_type": "income"
}

get_dividends▶

Track dividend history, ex-dividend dates, and payout information for any dividend-paying stock.

{
  "symbol": "JNJ",
  "years": 5
}

Installation

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": ["yfinance-mcp"]
    }
  }
}

Use Cases

Portfolio Analysis

Ask your AI assistant to analyze a portfolio of stocks, calculate returns, and compare performance against benchmarks.

Fundamental Research

Have AI read financial statements and summarize key metrics like revenue growth, profit margins, and debt levels.

Sector Comparisons

Compare valuation metrics across companies in the same sector to identify potential investment opportunities.

Dividend Tracking

Monitor dividend income, track ex-dividend dates, and identify reliable dividend growth stocks.

Yahoo Finance MCP Server