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
- Fundamental Screening
- Options Screening
Data Management
- Watchlist Creation and Management
- Screening Result Storage
- Default Symbol Categories
Installation
Usage
- Add to your Claude configuration:
In your
claude-desktop-config.json, add the following to themcpServerssection:
Replace "path/to/stockscreen.py" with the full path to where you saved the stockscreen.py file.
Available Tools
Available Tools
run_stock_screen
Technical Screen Criteria
Fundamental Screen Criteria
Options Screen Criteria
News Screen Criteria
Custom Screen Criteria
Category Values
Ava1ilable market cap categories for filtering:
- "mega_cap": >$200B
- "large_cap": $10B-$200B
- "mid_cap": $2B-$10B
- "small_cap": $300M-$2B
- "micro_cap": <$300M
- "etf": ETF instruments
manage_watchlist
get_screening_result
Response Formats
Technical Screen Response
Usage Prompt for Claude
"I've enabled the stockscreen tools which provide stock screening capabilities. You can use three main functions:
- Screen stocks with various criteria types:
- Manage watchlists:
- Access saved screening results:
All functions include error handling, detailed market data, and comprehensive responses."
Requirements
- Python 3.12+
- MCP Server
- yfinance
- pandas
- numpy
- asyncio
Limitations
- Data sourced from Yahoo Finance with potential delays
- Rate limits based on Yahoo Finance API restrictions
- Options data availability depends on market hours
- Some financial metrics may be delayed or unavailable
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Author
Todd Wolven - (https://github.com/twolven)
Acknowledgments
- Built with the Model Context Protocol (MCP) by Anthropic
- Data provided by Yahoo Finance
- Developed for use with Anthropic's Claude
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
- Fundamental Screening
- Options Screening
Data Management
- Watchlist Creation and Management
- Screening Result Storage
- Default Symbol Categories
Installation
Usage
- Add to your Claude configuration:
In your
claude-desktop-config.json, add the following to themcpServerssection:
Replace "path/to/stockscreen.py" with the full path to where you saved the stockscreen.py file.
Available Tools
Available Tools
run_stock_screen
Technical Screen Criteria
Fundamental Screen Criteria
Options Screen Criteria
News Screen Criteria
Custom Screen Criteria
Category Values
Ava1ilable market cap categories for filtering:
- "mega_cap": >$200B
- "large_cap": $10B-$200B
- "mid_cap": $2B-$10B
- "small_cap": $300M-$2B
- "micro_cap": <$300M
- "etf": ETF instruments
manage_watchlist
get_screening_result
Response Formats
Technical Screen Response
Usage Prompt for Claude
"I've enabled the stockscreen tools which provide stock screening capabilities. You can use three main functions:
- Screen stocks with various criteria types:
- Manage watchlists:
- Access saved screening results:
All functions include error handling, detailed market data, and comprehensive responses."
Requirements
- Python 3.12+
- MCP Server
- yfinance
- pandas
- numpy
- asyncio
Limitations
- Data sourced from Yahoo Finance with potential delays
- Rate limits based on Yahoo Finance API restrictions
- Options data availability depends on market hours
- Some financial metrics may be delayed or unavailable
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Author
Todd Wolven - (https://github.com/twolven)
Acknowledgments
- Built with the Model Context Protocol (MCP) by Anthropic
- Data provided by Yahoo Finance
- Developed for use with Anthropic's Claude