iflow-mcp_mcp-stockscreen

# StockScreen MCP Server A Model Context Protocol (MCP) server providing comprehensive stock screening capabilities through Yahoo Finance. Enables LLMs to screen stocks based on technical, fundamental, and options criteria, with support for watchlist management and result storage. ## Features ### Stock Screening - Technical Analysis Screening - Price and volume filters - Moving averages (20, 50, 200 SMA) - RSI indicators - Average True Range (ATR) - Trend analysis (1d, 5d, 20d changes) - MA distance calculations - Fundamental Screening - Market capitalization filters - P/E ratio analysis - Dividend yield criteria - Revenue growth metrics - ETF-specific metrics (AUM, expense ratio) - Options Screening - Implied Volatility (IV) filters - Options volume and open interest - Put/Call ratio analysis - Bid-ask spread evaluation - Earnings date proximity checks ### Data Management - Watchlist Creation and Management - Screening Result Storage - Default Symbol Categories - Mega Cap (>$200B) - Large Cap ($10B-$200B) - Mid Cap ($2B-$10B) - Small Cap ($300M-$2B) - Micro Cap (<$300M) - ETFs ## Installation ```bash # Install dependencies pip install -r requirements.txt # Clone the repository git clone https://github.com/twolven/mcp-stockscreen.git cd mcp-stockscreen ``` ## Usage 1. Add to your Claude configuration: In your `claude-desktop-config.json`, add the following to the `mcpServers` section: ```json { "mcpServers": { "stockscreen": { "command": "python", "args": ["path/to/stockscreen.py"] } } } ``` Replace "path/to/stockscreen.py" with the full path to where you saved the stockscreen.py file. ## Available Tools ## Available Tools 1. `run_stock_screen` ### Technical Screen Criteria ```python { "screen_type": "technical", "criteria": { "min_price": float, # Minimum stock price "max_price": float, # Maximum stock pr…