# Stock Screener

> Stock Screener is an open-source MCP server for finance and payments. Run daily stock screens, RS ratings and breadth data for 12 markets, no API keys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://xang1234.github.io/stock-screener/
- **Repository:** https://github.com/xang1234/stock-screener/tree/HEAD/stockscreen-mcp
- **MCP Registry name:** io.github.xang1234/stockscreen-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add stockscreen-mcp -- uvx stockscreen-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/stock-screener
