Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Vertex AI MCP Server
  • Perplexity MCP Server
  • Gemini MCP Image Generation Server
  • Surf MCP Server
  • Xano MCP Server
Back to MCP Servers
StockScreen MCP Server

StockScreen MCP Server

Public
twolven/mcp-stockscreen

Provides Model Context Protocol (MCP) stock screening with technical, fundamental, and options criteria, enabling watchlist management and result storage using comprehensive Yahoo Finance market data.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with StockScreen MCP Server

MCP Server

Unlock the full potential of StockScreen MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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 ($200B
  • "large_cap": $10B-$200B
  • "mid_cap": $2B-$10B
  • "small_cap": $300M-$2B
  • "micro_cap": <$300M
  • "etf": ETF instruments
  1. manage_watchlist
{ "action": str, # Required: "create", "update", "delete", "get" "name": str, # Required: watchlist name (1-50 chars, alphanumeric with _ -) "symbols": List[str] # Required for create/update: list of stock symbols }
  1. get_screening_result
{ "name": str # Required: name of saved screening result }

Response Formats

Technical Screen Response

{ "screen_type": "technical", "criteria": dict, # Original criteria used "matches": int, # Number of matching stocks "results": [ # List of matching stocks { "symbol": str, "price": float, "volume": float, "rsi": float, "sma_20": float, "sma_50": float, "sma_200": float, "atr": float, "atr_pct": float, "price_changes": { "1d": float, # 1-day price change % "5d": float, # 5-day price change % "20d": float # 20-day price change % }, "ma_distances": { "pct_from_20sma": float, "pct_from_50sma": float, "pct_from_200sma": float } } ], "rejected": [ # List of stocks that didn't match { "symbol": str, "rejection_reasons": List[str] } ], "timestamp": str }

Usage Prompt for Claude

"I've enabled the stockscreen tools which provide stock screening capabilities. You can use three main functions:

  1. Screen stocks with various criteria types:

    • Technical: Price, volume, RSI, moving averages, ATR
    • Fundamental: Market cap, P/E, dividends, growth
    • Options: IV, volume, earnings dates
    • Custom: Combine multiple criteria types
  2. Manage watchlists:

    • Create and update symbol lists
    • Delete existing watchlists
    • Retrieve watchlist contents
  3. Access saved screening results:

    • Load previous screen results
    • Review matched symbols and criteria

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
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Vertex AI MCP Server
    Vertex AI MCP Server

    Provides a Model Context Protocol server enabling advanced interaction with Google Cloud's Vertex AI...

    20 tools
    Added May 30, 2025
  • Perplexity MCP Server
    Perplexity MCP Server

    Provides a Python-based Model Context Protocol interface to the Perplexity API, enabling expert prog...

    Added May 30, 2025
  • Gemini MCP Image Generation Server
    Gemini MCP Image Generation Server

    Provides image generation capabilities via Google's Gemini 2 API using the Model Context Protocol, e...

    1 tools
    Added May 30, 2025
  • Surf MCP Server
    Surf MCP Server

    Provides tide information by location and date using latitude, longitude, and time zone data via Mod...

    1 tools
    Added May 30, 2025
  • Xano MCP Server
    Xano MCP Server

    Python-based Model Context Protocol server enabling AI assistants to securely interact with Xano ins...

    Added May 30, 2025