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
`yfinance_get_ticker_info`	Get company information, financials, and trading metrics
`yfinance_get_price_history`	Fetch historical price data and optionally generate charts
`yfinance_get_financials`	Fetch income statements, balance sheets, and cash flow data
`yfinance_get_holders`	Fetch major holders, institutional holders, mutual fund holders, and insider data

Detailed Usage

yfinance_get_ticker_info▶

Retrieve company information, financials, trading metrics, and governance data.

{
  "symbol": "AAPL"
}

yfinance_get_price_history▶

Fetch historical price data for a ticker with an optional period and interval.

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

yfinance_get_financials▶

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

{
  "symbol": "GOOGL",
  "frequency": "annual"
}

yfinance_get_holders▶

Fetch major, institutional, and mutual fund holders, plus insider data.

{
  "symbol": "AAPL",
  "max_rows": 10
}

Installation

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": ["yfmcp@latest"]
    }
  }
}

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