MCP YFinance Stock Server

@Adity-star

Repository Homepage

Basic information

About MCP YFinance Stock Server

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

#python #fastapi #yfinance #mcp-server

MCP YFinance Stock Server config

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

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

MCP YFinance Stock Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

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.

Comments

More Finance & Commerce MCP servers

AurasPay Merchant MCP

AurasPayOfficial

Official remote MCP server for AurasPay merchants to review scoped payment activity and prepare approval-gated crypto payment links from compatible AI clients.

RAVN

Cross-chain swap execution across 13 venues and 16 chains, including native (non-wrapped) Bitcoin as either source or destination. No signup, no API key, 0% protocol fee, same routing engine the RAVN app itself uses. Exp

fAlpha

fAlpha.ai, Inc.

Read-only US equity research for AI agents: fAlpha's model signal for a stock with the drivers behind it, signal history and flips, news sentiment, analyst coverage, SEC filings, FRED macro and fundamentals. Every result

BackPow PoW Oracle MCP Server

BackpowCom

Live Proof-of-Work mining data for AI agents: difficulty, hashrate, solo-mining odds, cost of production and hardware profitability for 126+ networks and 770+ ASIC/GPU/CPU models. Read-only, no API key.

CoinStats

CoinStats is a remote MCP server available at https://mcp.coinstats.app.