💹 MCP YFinance Stock Server

What is MCP YFinance Stock Server?

MCP YFinance Stock Server is a stock price server powered by the Yahoo Finance (YFinance) API and built for integration with the Model Context Protocol (MCP). It allows AI agents or clients to retrieve real-time stock data, manage a watchlist, perform full stock analysis, and run technical indicators.

How to use MCP YFinance Stock Server?

Set up the environment using uv, install the project with uv pip install -e ., and start the server with uv run main.py. Configure the server by adding an entry to your mcp.config.json file pointing to the project directory and main script. For testing, use python run test_server_fun.py or inspect with mcp dev source/yf_server.py.

Key features of MCP YFinance Stock Server

• Retrieve real-time stock prices
• Manage a personal watchlist (add, view prices)
• Perform 1-month technical trend analysis (RSI, MACD, MAs)
• Generate comprehensive technical summaries with indicators
• Analyze trend shifts, patterns, and divergences
• Compare stock prices for relative performance analysis

Use cases of MCP YFinance Stock Server

• Dynamic watchlist management
• Trend and momentum detection
• Deep-dive technical analysis for investment decisions
• Volatility-based risk assessment
• Powering stock-focused autonomous agents or dashboards

FAQ from MCP YFinance Stock Server

What are the dependencies or runtime requirements?

The server requires Python 3.10 and uses the uv package manager. Dependencies are defined in pyproject.toml and installed via uv pip install -e ..

How do I configure the server for Claude Desktop?

Add an entry to your mcp.config.json with the command uv, arguments ["--directory", "/ABSOLUTE/PATH/TO/YOUR/mcp-yfinance-server", "run", "main.py"], and then restart Claude Desktop.

How many tools does the server expose?

The server exposes 18 tools, including add_to_watchlist, analyze_stock, get_technical_summary, get_watchlist_prices, get_trend_analysis, get_stock_price, get_volatility_analysis, and compare_stocks.

What data source does the server use?

It uses the Yahoo Finance (YFinance) API to fetch stock data. No other data sources are mentioned.

Is the server free and open source?

Yes, the project is licensed under MIT and uses the publicly available Yahoo Finance API. Contributions and forks are welcome.