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

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

Basic information

More Finance & Commerce MCP servers

SavePropTax

atifnayeem-oss

Check whether a California home qualifies for a Proposition 8 property tax reduction from recent comparable sales, then start a filing the owner completes themselves. Hosted remote server, no API key. Flat $29, paid by t

Velarion — Executive Compensation Intelligence

Velarion

Velarion exposes deterministic executive-compensation and governance intelligence for ~3,000 US public companies as callable MCP tools — sourced from SEC proxy filings, not LLM guesses. Nine tools: look up CEO/NEO pay an

Capital.com MCP

capital-com-sv

CFDs are complex instruments and come with a high risk of losing money rapidly due to leverage. 81.31% of retail investor accounts lose money when trading CFDs with this provider. You should consider whether you understa

GallanDigital Marketplace

GallanDigital

Read-only discovery server for GallanDigital, a B2B marketplace of credentialed operational systems and tools for PE operating partners, boutique consultants, and business owners. Exposes search, listing detail, contribu

MobileMRR

BuildWithxAI

Find mobile apps for sale using real marketplace data from MobileMRR. Search and filter listings by MRR, asking price, category, platform, and revenue verification, compare acquisition opportunities, view verified revenu