# Stock Screener

MCP server for daily stock screening, relative-strength ratings, and market breadth across 12 countries. Operates without any API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 396
- Author: xang1234
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xang1234/stock-screener/tree/HEAD/stockscreen-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/stock-screener

## What it does

The server fetches daily post-close snapshots published on GitHub Pages and caches them in memory. It requires no API tokens, accounts, or background database servers. Data spans 12 markets, including the US, Japan, Canada, and Germany. The compressed US market scan takes roughly 7 MB.

Six read-only tools handle market health, sector group rankings, and stock filtering. The package bundles 28 preset screening models, covering Minervini trend templates, CANSLIM, volatility contraction patterns, and cup-with-handle setups. Relative strength ratings run from 1 to 99 percentile within each local market, where 99 represents the top tier.

Intraday traders should look elsewhere: all records represent end-of-day snapshots and never pull streaming live quotes. Running the server requires Astral's `uv` package manager to supply the `uvx` command.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add stockscreen-mcp -- uvx stockscreen-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from stockscreen-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add stockscreen-mcp -- uvx stockscreen-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from stockscreen-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "stockscreen-mcp": {
            "command": "uvx",
            "args": [
                "stockscreen-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from stockscreen-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "stockscreen-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "stockscreen-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from stockscreen-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add stockscreen-mcp uvx stockscreen-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from stockscreen-mcp <command>

## When to use it
- screen US equities using Minervini trend criteria and sector rankings
- track market breadth indicators, distribution days, and exposure scores
- rank industry groups by relative strength and weekly momentum shifts
- inspect individual stock metrics, quarterly EPS growth, and chart setups

## Example prompts
- Check US market health right now, focusing on distribution days and breadth.
- List Hong Kong stocks with RS above 90 and quarterly EPS growth over 25%.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md