Metadata-Version: 2.1
Name: yfinance-mcp
Version: 0.1.2
Summary: MCP Server for Yahoo Finance API - AI-friendly financial data tools
Project-URL: Homepage, https://github.com/ranaroussi/yfinance
Project-URL: Repository, https://github.com/ranaroussi/yfinance
Author: YFinance MCP Contributors
License-Expression: Apache-2.0
Keywords: ai,financial-data,mcp,stocks,yahoo-finance,yfinance
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: yfinance>=0.2.40
Description-Content-Type: text/markdown

# YFinance MCP Server

MCP Server for Yahoo Finance API - provides AI-friendly financial data tools.

## Installation

```bash
# Using uvx (recommended)
uvx yfinance-mcp

# Or install with pip
pip install yfinance-mcp
```

## Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "yfinance": {
      "command": "uvx",
      "args": ["yfinance-mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `get_ticker_info` | Get basic stock information |
| `get_price_history` | Get historical price data |
| `get_financials` | Get financial statements |
| `get_holders` | Get holder information |
| `get_earnings` | Get earnings data |
| `get_analyst_data` | Get analyst data |
| `get_options` | Get options chain |
| `get_dividends_splits` | Get dividends/splits history |
| `get_sustainability` | Get ESG data |
| `get_ticker_calendar` | Get calendar/news/SEC filings |
| `download` | Batch download historical data |
| `get_tickers_info` | Batch get stock info |
| `search` | Search stocks/news |
| `lookup` | Lookup financial instruments |
| `get_market_calendar` | Get market calendar |
| `screen_stocks` | Stock screening |
| `get_sector_data` | Get sector data |
| `get_industry_data` | Get industry data |

## License

Apache-2.0
