Yahoo Finance

A Model Context Protocol (MCP) server for agentic retrieval of financial data from Yahoo Finance. This server leverages YFinance to provide a simple and efficient way to access historical stock prices, dividends, stock splits, company information, and other financial metrics.

This MCP server is designed to be used with various LLM applications that support the Model Context Protocol, such as Claude Desktop and Cursor. It allows users to retrieve financial data in a structured way, making it easy to integrate into AI applications.

Available Tools

This MCP server provides a variety of tools for retrieving financial data. Below is a list of available tools and their main arguments:

Stock Information

• get_stock_info(ticker: str)
  Get basic information about a stock.

Historical Data

• get_historical_data(ticker: str, period: str = "1mo", interval: str = "1d")
  Get historical price data for a stock.
• get_multiple_tickers(tickers: list[str], period: str = "1d")
  Get data for multiple stocks at once.
• download_bulk_data(tickers: list[str], period: str = "1mo", interval: str = "1d", ...)
  Download bulk historical data for multiple tickers.
• get_ticker_history_metadata(ticker: str)
  Get available periods, intervals, and metadata for a ticker.

Analyst Data

• get_recommendations(ticker: str)
  Get analyst recommendations for a stock.
• get_analyst_price_targets(ticker: str)
  Get analyst price targets.
• get_upgrades_downgrades(ticker: str)
  Get recent upgrades and downgrades.
• get_recommendations_summary(ticker: str)
  Get recommendations summary.

Corporate Actions

• get_dividends(symbol: str, period: str = "5y")
  Get dividend history for a stock.
• get_splits_history(symbol: str, period: str = "5y")
  Get stock split history.

Market Data

• get_market_status()
  Get current US market status.
• get_trending_tickers(region: str = "US", count: int = 10)
  Get trending/popular tickers.
• get_sector_performance()
  Get sector performance using ETFs.
• get_index_data(indices: list[str] = None)
  Get data for major market indices.

Calendar & Market Hours

• get_market_calendar_info(ticker: str)
  Get market calendar and session info.
• get_market_hours(ticker: str)
  Get market hours and session information.
• get_exchange_info(ticker: str)
  Get detailed exchange and trading information.

Screener & Search

• screen_stocks_by_criteria(...)
  Screen stocks by market cap, P/E, dividend yield, sector, etc.
• get_similar_stocks(ticker: str, count: int = 5)
  Find similar stocks by sector and market cap.
• get_top_performers(period: str = "1mo", sector: str = None, count: int = 10)
  Get top performing stocks.

Technical Analysis

• get_technical_indicators(ticker: str, period: str = "6mo")
  Get technical indicators (SMA, price position, etc.).
• get_volatility_metrics(ticker: str, period: str = "1y")
  Get volatility and risk metrics.
• get_support_resistance_levels(ticker: str, period: str = "6mo")
  Get support and resistance levels.

Options

• get_options_expiration_dates(ticker: str)
  Get available options expiration dates.
• get_option_chain(ticker: str, expiration_date: str = None)
  Get option chain for a ticker.
• get_options_volume_analysis(ticker: str, expiration_date: str = None)
  Analyze options volume and open interest.
• get_options_by_moneyness(ticker: str, expiration_date: str = None, moneyness_range: float = 0.1)
  Filter options by proximity to current price.

Financial Statements

• get_financials_summary(ticker: str)
  Get key financial metrics summary.

Funds & ETFs

• get_fund_profile(ticker: str)
  Get fund/ETF profile.
• get_fund_holdings(ticker: str, count: int = 20)
  Get top holdings of a fund/ETF.
• get_fund_sector_allocation(ticker: str)
  Get sector allocation of a fund/ETF.
• get_fund_performance(ticker: str)
  Get fund/ETF performance metrics.
• compare_funds(tickers: list[str])
  Compare multiple funds/ETFs.

Crypto

• get_crypto_info(crypto_symbol: str)
  Get cryptocurrency info.
• get_crypto_historical_data(crypto_symbol: str, period: str = "1mo", interval: str = "1d")
  Get historical data for a cryptocurrency.
• get_top_cryptocurrencies(count: int = 10)
  Get data for top cryptocurrencies.
• get_crypto_fear_greed_proxy(crypto_symbols: list[str] = None)
  Get a proxy for crypto fear/greed index.

Currency & Validation

• get_currency_data(base_currency: str = "USD", target_currencies: list[str] = None)
  Get currency exchange rates.
• validate_tickers(tickers: list[str])
  Validate if tickers are valid and available.

Legal

This project is not affiliated, endorsed, or vetted by Yahoo, Inc. It's an open-source tool that uses Yahoo's publicly available APIs, and is intended for research and educational purposes. You should refer to Yahoo!'s terms of use (here, here, and here) for details on your rights to use the actual data downloaded.