Yahoo Finance MCP Server

AModel Context Protocol(MCP) server for Yahoo Finance interaction. This server provides tools to get pricing, company information, and generate financial visualizations.

This project is a fork and extension ofmaxscheijen/mcp-yahoo-finance, with added visualization capabilities.

git clone https://github.com/leoncuhk/mcp-yahoo-finance.git cd mcp-yahoo-finance

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

{ "mcpServers": { "yahoo-finance": { "command": "uvx", "args": ["mcp-yahoo-finance"] } } }

{ "mcpServers": { "yahoo-finance": { "command": "docker", "args": ["run", "-i", "--rm", "IMAGE"] } } }

{ "servers": { "yahoo-finance": { "command": "uvx", "args": ["mcp-yahoo-finance"] } } }

Add this to your Cursor MCP configuration:

{ "mcp-servers": { "yahoo-finance": { "command": "uvx", "args": ["mcp-yahoo-finance"] } } }

After configuring, restart Claude Desktop or your preferred MCP client to load the server.

- get_current_stock_price: Get the current stock price for a symbol
- get_stock_price_by_date: Get the stock price for a specific date
- get_stock_price_date_range: Get stock prices for a date range
- get_historical_stock_prices: Get historical stock data with customizable periods
- get_dividends: Get dividend information for a stock
- get_income_statement: Get income statement data
- get_cashflow: Get cashflow statement data
- get_earning_dates: Get earning dates information
- get_news: Get recent news for a stock

- generate_market_dashboard: Create a market sentiment dashboard with real-time index performance
- generate_portfolio_report: Generate a portfolio performance tracking report
- generate_stock_technical_analysis: Create a technical analysis report for a stock

Here are some example prompts to try with Claude:
- "What is the current stock price of Apple?"
- "What is the difference in stock price between Apple and Google?"
- "How much did the stock price of Apple change between 2025-01-01 and 2025-3-31?"
- "Generate a market sentiment dashboard showing the performance of major indices."
- "Create a portfolio tracking report for tech stocks AAPL, MSFT, GOOGL, AMZN, and NVDA."
- "Show me a technical analysis chart for Tesla stock with moving averages and support/resistance levels."
- "Generate a market sentiment dashboard with S&P 500, Dow Jones, and NASDAQ."
- "Can you create a portfolio report for my energy stocks: XOM, CVX, BP, COP, and SLB?"
- "I need a detailed technical analysis for NVDA stock showing RSI and volume patterns."

This will generate example visualization images in theexamplesdirectory.

This project is licensed under the MIT License - see the LICENSE file for details.

- Original project byMax Scheijen
- Extended with visualization capabilities inspired bytooyipjee

Retrieve and process economic data from the International Monetary Fund (IMF) API, including datasets, time series, indicators, and countries.