mcp-server-yfinance 0.1.0.dev27

MCP server for yfinance

MCP Server Markets

A Model Context Protocol (MCP) server that provides stock market data using YFinance.

Features

• Get basic stock information (price, market cap, sector, etc.)
• Fetch historical price data with customizable periods
• Retrieve analyst recommendations
• Download data for multiple stocks simultaneously
• Access dividend history

Installation

pip install mcp-server-yfinance

Usage

Start the server:

python -m mcp_server_yfinance.server

Available Tools

1. get_stock_info(ticker: str)

   • Get basic information about a stock
   • Example: get_stock_info("AAPL")

2. get_historical_data(ticker: str, period: str = "1mo", interval: str = "1d")

   • Get historical price data
   • Periods: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
   • Intervals: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo

3. get_recommendations(ticker: str)

   • Get analyst recommendations for a stock

4. get_multiple_tickers(tickers: list[str], period: str = "1d")

   • Get data for multiple stocks at once
   • Example: get_multiple_tickers(["AAPL", "GOOGL"])

5. get_dividends(ticker: str)

   • Get dividend history for a stock

VS Code Integration

Add the following to your VS Code settings.json:

"mcp.servers.yfinance": {
  "type": "stdio",
  "command": "uvx",
  "args": [
    "run",
    "mcp-server-yfinance@latest"
  ]
}

License

AGPLv3+ License - see LICENSE for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a pull request