Yahoo Finance
This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options
What is Yahoo Finance?
Yahoo Finance is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is a model context protocol (mcp) server that provides comprehensive financial data from yahoo finance. it allows you to retrieve detailed information about stocks, including historical prices, c...
This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This is a Model Context Protocol (MCP) server that provides
Use Cases
Maintainer
Works with
Installation
NPM
npx -y yahoo-financeManual Installation
npx -y yahoo-financeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Yahoo Finance
The Yahoo Finance MCP server provides comprehensive financial data retrieval through an AI assistant interface, covering real-time and historical stock prices, company fundamentals, financial statements, analyst recommendations, options chains, and institutional holder information — all sourced from Yahoo Finance via the yfinance Python library. It enables users to conduct in-depth equity research and financial analysis by asking plain-English questions about any publicly traded company, without needing to write code or navigate financial websites directly.
Prerequisites
- Python 3.10+ and uv package manager installed (pip install uv)
- Git installed (for uvx from git installation method)
- An MCP-compatible client such as Claude Desktop or Claude Code
- No API key required — Yahoo Finance data is publicly accessible via yfinance
Install using uvx (recommended)
The recommended installation method uses uvx to run the server directly from the GitHub repository without a manual clone.
uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcpAlternative: Clone and run locally
For development or offline use, clone the repository and set up a virtual environment with uv.
git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
cd yahoo-finance-mcp
uv venv
source .venv/bin/activate
uv pip install -e .
uv run server.pyLocate the Claude Desktop config file
Open your claude_desktop_config.json. On macOS it is at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows at %AppData%\Claude\claude_desktop_config.json.
Add the server to your MCP client configuration
Insert the yfinance server block into your mcpServers object using the uvx command.
Restart Claude Desktop and verify
Restart the application and ask a stock question. A response with real financial data confirms the server is connected and working.
Yahoo Finance Examples
Client configuration
Claude Desktop config using uvx to pull and run the Yahoo Finance MCP server from GitHub.
{
"mcpServers": {
"yfinance": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
"yahoo-finance-mcp"
]
}
}
}Prompts to try
Example questions covering price history, financial statements, options, and analyst data.
- "Show me the historical stock prices for AAPL over the last 6 months"
- "Get the quarterly balance sheet for Microsoft (MSFT)"
- "What are the latest analyst recommendations for NVDA?"
- "Get the options chain for SPY with expiration date 2025-12-19 for calls"
- "Who are the major institutional holders of TSLA?"
- "Show me the annual income statement for Amazon"Troubleshooting Yahoo Finance
uvx command not found
Install uv with: pip install uv or curl -LsSf https://astral.sh/uv/install.sh | sh. Then confirm with: uvx --version.
Rate limit or empty data returned for certain tickers
Yahoo Finance applies rate limits to bulk requests. Add a short delay between multiple queries, or try again after a minute. Some tickers (especially non-US or delisted stocks) may have limited data in yfinance.
Server fails to start with module not found errors
If running locally, ensure the virtual environment is activated (source .venv/bin/activate) and dependencies are installed with: uv pip install -e . Run with uv run server.py, not python server.py, to ensure the correct environment.
Frequently Asked Questions about Yahoo Finance
What is Yahoo Finance?
Yahoo Finance is a Model Context Protocol (MCP) server that this is a model context protocol (mcp) server that provides comprehensive financial data from yahoo finance. it allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Yahoo Finance?
Install via npm with the command: npx -y yahoo-finance. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Yahoo Finance?
Yahoo Finance works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Yahoo Finance free to use?
Yes, Yahoo Finance is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Yahoo Finance Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Yahoo Finance? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Yahoo Finance in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Yahoo Finance?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.