Stock Screener
Run daily stock screens, RS ratings and breadth data for 12 markets, no API keys
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"stockscreen-mcp": {
"command": "uvx",
"args": [
"stockscreen-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"stockscreen-mcp": {
"command": "uvx",
"args": [
"stockscreen-mcp"
]
}
}
}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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments