💹 MCP YFinance Stock Server

@Adity-star

About 💹 MCP YFinance Stock Server

Real-time stock API with Python, MCP server example, yfinance stock analysis dashboard

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-yfinance-server": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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`.