Yahoo Finance
Enables AI assistants to access real-time financial data, historical stock prices, company information, financial statements, options data, market news, and analyst recommendations through Yahoo Finance. Built with FastMCP v2 for efficient HTTP strea
What is Yahoo Finance?
Yahoo Finance is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to access real-time financial data, historical stock prices, company information, financial statements, options data, market news, and analyst recommendations through yahoo finan...
Enables AI assistants to access real-time financial data, historical stock prices, company information, financial statements, options data, market news, and analyst recommendations through Yahoo Finance. Built with FastMCP v2 for efficient HTTP strea
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to access real-time financial data, hi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx yahoo-finance-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Yahoo Finance
The Yahoo Finance MCP server (yfmcp) provides AI assistants with live and historical financial data from Yahoo Finance via the yfinance Python library, covering stock information, financial statements, price history, options chains, ownership data, sector rankings, news, and chart generation. It exposes dedicated tools for screening stocks, fetching OHLCV data, and generating candlestick and VWAP charts returned as WebP images. Investors, analysts, and developers who want to research stocks, run screeners, or build financial summaries directly inside an AI chat interface will find this server essential.
Prerequisites
- Python 3.10 or higher installed
- uv or pip package manager for Python
- An MCP-compatible client such as Claude Desktop
- No API key required — Yahoo Finance data is free to access through yfinance
Install the yfmcp package
Install the Yahoo Finance MCP server from PyPI using pip or uv.
pip install yfmcp
# or with uv
uv pip install yfmcpAdd the server to your MCP client configuration
Configure your MCP client to launch the server. No API key is needed — the server uses yfinance which accesses Yahoo Finance directly.
{
"mcpServers": {
"yahoo-finance": {
"command": "uvx",
"args": ["yfmcp"]
}
}
}Restart your MCP client
Save the configuration and restart Claude Desktop or your MCP client. The Yahoo Finance server will start automatically.
Query stock data using natural language
Ask the AI for stock information, price history, financial statements, or chart generation. The server covers all major US exchanges and many international markets.
Run stock screeners to discover investment opportunities
Use the built-in screeners such as day_gainers, or build custom equity screeners with filter conditions on price, volume, percent change, and market cap.
Yahoo Finance Examples
Client configuration
Claude Desktop configuration for the Yahoo Finance MCP server using uvx.
{
"mcpServers": {
"yahoo-finance": {
"command": "uvx",
"args": ["yfmcp"]
}
}
}Prompts to try
Example financial research queries you can run once the server is connected.
- "Get current stock information for Apple (AAPL)"
- "Show me NVIDIA's income statement for the last 4 quarters"
- "What is the options chain for Tesla expiring next month?"
- "Generate a candlestick chart for MSFT over the last 3 months"
- "Who are the top institutional holders of Amazon stock?"
- "Screen for US stocks with more than 3% gain today and volume above 500,000"Troubleshooting Yahoo Finance
Server fails to start with ModuleNotFoundError for yfinance
Ensure the yfmcp package is installed in the same Python environment that uvx resolves to. Run `uvx yfmcp` directly in a terminal to confirm it starts without errors. If using pip, verify with `pip show yfmcp`.
Stock data requests fail or return empty results
Yahoo Finance rate-limits unauthenticated requests. If you are making many requests in quick succession, add a short pause between queries. Some data types (options, intraday data) may be restricted for certain symbols or regions.
Chart generation returns no image or an error
Chart generation requires matplotlib and related plotting libraries to be installed. They are included as dependencies of yfmcp, but ensure the install completed without errors. Run `pip install yfmcp --upgrade` to get the latest version with all dependencies.
Frequently Asked Questions about Yahoo Finance
What is Yahoo Finance?
Yahoo Finance is a Model Context Protocol (MCP) server that enables ai assistants to access real-time financial data, historical stock prices, company information, financial statements, options data, market news, and analyst recommendations through yahoo finance. built with fastmcp v2 for efficient http strea It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Yahoo Finance?
Follow the installation instructions on the Yahoo Finance GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
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 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.