Skip to content
MCP server

Stock Screener

Run daily stock screens, RS ratings and breadth data for 12 markets, no API keys

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.4.0
Listing updated
3 days ago

About Stock Screener

Stock Screener is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Stockscreen-mcp reads the snapshot that the open-source stock-screener project publishes after each market close, so there is no server to run and nothing to sign up for. Markets covered are the United States, Canada, Germany, Hong Kong, mainland China, Japan, Korea, Taiwan, India, Singapore, Malaysia and Australia.

The tools are all read-only. You can list the 28 preset screens with their exact rules (Minervini, CANSLIM, VCP, cup with handle, high tight flag, momentum, IPOs and more), run a preset or your own filters over a market, pull one stock's relative-strength ratings, stage and growth fields, or audit a watchlist of up to 50 symbols to see which screens each passes and which are one rule short.

A command-line mode prints screens as tables or JSON and can write a comma-separated TradingView watchlist; TradingView caps watchlists at 1,000 symbols and symbols are derived rather than verified. Install with uvx stockscreen-mcp.

Install

Run in a terminal

claude mcp add stockscreen-mcp -- uvx stockscreen-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "stockscreen-mcp": {
      "command": "uvx",
      "args": [
        "stockscreen-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "stockscreen-mcp": {
      "command": "uvx",
      "args": [
        "stockscreen-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "stockscreen-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "stockscreen-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stockscreen-mcp": {
      "command": "uvx",
      "args": [
        "stockscreen-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "stockscreen-mcp": {
      "command": "uvx",
      "args": [
        "stockscreen-mcp"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

list_markets
Lists markets in the current publish with data date, status and features.
list_screens
Lists the 28 preset screens and their exact rules.
describe_fields
Explains scan fields, units and ranges with counts from a market's rows.
run_screen
Runs a preset and/or custom filters over a market's scan, sorted, with match count.
get_stock
Returns one stock's RS ratings, stage, scores, growth, group rank and screens passed.
audit_stocks
Checks a watchlist of up to 50 symbols against the preset screens and reports near misses.

What it does

12 markets
Covers the US, Canada, Germany, Hong Kong, China, Japan, Korea, Taiwan, India, Singapore, Malaysia and Australia.
28 preset screens
Includes Minervini, CANSLIM, VCP, cup with handle and high tight flag.
Custom filters
Combines a preset with your own filters, sorted, with the match count.
Stock detail
Returns RS ratings, stage, growth, group rank and the screens a stock passes.
Watchlist audit
Checks up to 50 symbols and flags near misses.
TradingView export
CLI writes a comma-separated watchlist file.
Field descriptions
Explains each scan field with exact counts per market.

Good for

  • List US stocks passing the Minervini trend template today
  • Find Hong Kong stocks with RS above 90 in stage 2
  • Check a watchlist for stocks one rule away from a screen
  • Review market breadth and leading industry groups
  • Export screen results to a TradingView watchlist

Pricing

Open source

Free and open source

Prices change. Check xang1234.github.io before you buy.

Stock Screener FAQ

Do I need API keys?

No. The README says no API keys and no server to run.

How fresh is the data?

It is a snapshot published after each market close.

Can I use it without an AI assistant?

Yes, the CLI prints screens as tables or JSON.

How do I install it?

Run uvx stockscreen-mcp.

Is it read-only?

Yes, all tools are read-only.

Is Stock Screener free?

Yes. Stock Screener is open source, so you can use and self-host it for free.

How do I add Stock Screener to Claude Code?

Run this command in your terminal: claude mcp add stockscreen-mcp -- uvx stockscreen-mcp

What are the best alternatives to Stock Screener?

The closest alternatives to Stock Screener are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Stock Screener

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments