Yahoo Fianace MCP

Name: Yahoo Fianace MCP
Author: a05031113

@a05031113

Repository

About Yahoo Fianace MCP

No overview available yet

#yahoo-finance #yfinance #stock #finance #mcp #tool #financial-data

Basic information

Config

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

{
  "mcpServers": {
    "yahoo_finance_engine": {
      "command": "/path/to/your/yahoo-finance/.venv/bin/python",
      "args": [
        "/path/to/your/yahoo-finance/main.py"
      ]
    }
  }
}

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 Yahoo Finance MCP?

Yahoo Finance MCP is a Model Context Protocol (MCP) server that exposes functions from the yfinance library as individual tools, enabling MCP clients like Claude Desktop to query Yahoo Finance data.

How to use Yahoo Finance MCP?

Clone the repository, create and activate a virtual environment with uv, install dependencies from requirements.txt, then run python main.py. Configure your MCP client to execute the Python interpreter with the main.py script as a command.

Key features of Yahoo Finance MCP

Provides 20+ tools for stock and financial data.
Covers current price, historical data, dividends, and splits.
Includes income statement, cash flow, and balance sheet.
Offers news, company info, and analyst recommendations.
Supports option chains, sustainability, and holder data.

Use cases of Yahoo Finance MCP

Retrieve real-time and historical stock prices for analysis.
Access financial statements for fundamental research.
Fetch earnings dates and analyst price targets.
Get news and company information for due diligence.
Query option expiration dates and chains for trading.

FAQ from Yahoo Finance MCP

What data does Yahoo Finance MCP access?

It accesses Yahoo Finance data through the yfinance library, covering stocks, financials, news, options, and more.

What are the runtime requirements?

Python 3.8+ and the uv package manager are required. Dependencies are listed in requirements.txt.

How does the server communicate?

It uses standard input/output (stdio) for JSON-RPC requests, as expected by the MCP protocol.

Does it require authentication or API keys?

No authentication or API keys are mentioned in the README; it relies on the public yfinance library.

What tools are available?

Tools include get_current_stock_price, get_historical_stock_prices, get_income_statement, get_news, get_option_chain, and many more (see the full list in the README).