An MCP server (Model Context Protocol) that enables your AI to interact with Yahoo Finance for comprehensive stock market data, news, financial metrics, price history, option chains, and earnings data.

Installation

uvx (recommended)

uvx yahoo-finance-server

pip

pip install yahoo-finance-server

From source

git clone https://github.com/AgentX-ai/AgentX-mcp-servers.git
cd AgentX-mcp-servers/yahoo_finance_server
pip install -e .

Available Tools

Tool	Description
get-ticker-info	Retrieve comprehensive stock information, including company details, financial metrics, and trading metrics
get-ticker-news	Fetch recent news articles for a given stock symbol
search	Search for stocks, ETFs, and other financial instruments with associated news results
get-top-entities	Retrieve top companies in a sector (companies, ETFs, mutual funds)
get-price-history	Retrieve historical price data with customizable periods and intervals
ticker-option-chain	Retrieve option chain data for stocks, including call and put options
ticker-earning	Retrieve earnings data, including historical and upcoming earnings reports

Features

• Stock Data - retrieve comprehensive ticker information, including company details, financial metrics, and trading metrics
• News Feed - fetch recent news articles for specific stock symbols
• Search - search for stocks, ETFs, and other financial instruments with news results
• Top Companies - get the best companies, ETFs, and mutual funds by sector
• Price History - retrieve historical price data with customizable periods and intervals
• Option Chain - retrieve option chain data for stocks, including call and put options
• Earnings - access earnings data, including upcoming earnings report dates
• Proxy Support - work with HTTP/HTTPS/SOCKS proxies
• Fast and Asynchronous - non-blocking operations using asyncio

Environment Variables

Optional

• PROXY_URL - Proxy server URL for improved reliability and to avoid rate limiting (supports HTTP/HTTPS/SOCKS)

Notes

Requires Python 3.11 or higher. Proxy configuration is recommended for improved reliability and to avoid rate limiting. Supports various sectors including technology, healthcare, financial services, and many others.