StockScreen

Stock screening provider for Claude Desktop using MCP

python

38

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "twolven-mcp-stockscreen": {
      "command": "python",
      "args": [
        "stockscreen.py"
      ]
    }
  }
}

The StockScreen MCP Server gives you automated stock screening capabilities powered by Yahoo Finance. It lets you filter stocks using technical, fundamental, and options criteria, manage watchlists, and store screening results for quick access and reuse with compatible MCP clients.

How to use

You run the StockScreen MCP Server as a local process and connect to it from your MCP client. Start by launching the server, then issue screening requests through your client to filter stocks by technical, fundamental, or options criteria, or save and reuse previous results. You can create and manage watchlists, run new screenings against those watchlists, and retrieve saved results for review.

How to install

Prerequisites: ensure you have Python 3.12 or newer installed on your system. You will also need access to a Python environment with network access to install dependencies.

Install dependencies and set up the server locally with these steps:

/usr/bin/python3 -V
Python 3.12.x

# Install Python dependencies
pip install -r requirements.txt

# Clone the stock screen MCP project
git clone https://github.com/twolven/mcp-stockscreen.git
cd mcp-stockscreen

# Start the stock screen server (stdio MCP endpoint)
python stockscreen.py

Configuration and usage with your MCP client

Configure your MCP client to connect to the StockScreen MCP Server as a stdio client. Use the following local command to run the server process, which your MCP client will interact with directly.

Available tools

run_stock_screen

Executes a stock screening run using the defined technical, fundamental, or options criteria and returns matching results, watchlist usage, and optional saved results.