yfinance-mcp-server

# YFinance MCP Server A fully-featured **Model Context Protocol (MCP)** server that exposes nearly all of Yahoo Finance’s capabilities through simple, typed MCP tools. Built with [FastMCP](https://gofastmcp.com) so you can plug it straight into any LLM workflow, agent framework, or the official MCP client SDK. --- ## Features * 25+ tools covering: * Price history (single & multiple tickers) * Financial statements (income, balance sheet, cash-flow) * Analyst data (recommendations, price targets, earnings estimates) * Ownership & insider transactions * Dividends, splits & actions * Options chains * News & earnings calendar * Fund / ETF holdings * ESG & sustainability metrics * Stock screeners & search utilities * Batch operations & yfinance global configuration * Pure-Python, zero external services required. * Exposes both **STDIO** (default) and **HTTP/SSE** transports if you want to serve over the network. --- ## Requirements * Python 3.10+ * **pipx** (for MCP client integration) All dependencies are listed in `requirements.txt` (generated below). ``` pandas yfinance fastmcp ``` > If you already installed packages manually you can skip the next step. ### Installing pipx If you don't have pipx installed, install it first: **macOS:** ```bash brew install pipx ``` **Linux/Ubuntu:** ```bash sudo apt install pipx # or python3 -m pip install --user pipx ``` **Windows:** ```bash python -m pip install --user pipx ``` After installation, ensure pipx is in your PATH: ```bash pipx ensurepath ``` --- ## Installation ### Option 1: Install from PyPI (Recommended) ```bash pip install yfinance-mcp-server ``` ### Option 2: Install from source ```bash # 1) Clone the repository git clone https://github.com/itsmejay80/yfinance-mcp-server.git cd yfinance-mcp-server # 2) (Optional) create a virtual environment python3 -m venv .venv source .venv/bin/activate # 3) Install dependencies pip install -r requirements.txt ``` --- ## Running the …