StockMarketScan MCP Server

Stock screeners, chart patterns, options flow, and signals — 18 tools for US equities research, inside your LLM client.

Server URL: https://mcp.stockmarketscan.com/mcp
Transport: HTTP/SSE (Server-Sent Events)
Auth: BYOK — pass your personal sms_* API key as the X-API-Key header
Plan: Requires a Basic or Pro plan at stockmarketscan.com. Options flow tools require the Options Flow add-on.
Get your API key: stockmarketscan.com/settings
Full install guide & examples: stockmarketscan.com/mcp

What you get — 18 tools

Category	Tools
Screeners (3)	`list_screeners`, `get_screener_data`, `search_stocks_in_screeners`
Chart Patterns (2)	`get_chart_patterns`, `search_patterns`
Options Flow (4)	`get_options_flow_overview`, `get_options_flow_timeline`, `get_options_flow_signals`, `get_unusual_options_activity`
Stock Info (2)	`get_stock_info`, `get_candles`
Composite (2)	`get_stock_report`, `search_setups`
Market Context (3)	`get_market_momentum`, `get_trends`, `get_trend_connections`
Education (1)	`explain_concept`

Plus ping for liveness checks.

Install — Claude Desktop

Edit claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stockmarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.stockmarketscan.com/mcp"],
      "headers": {
        "X-API-Key": "sms_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You should see stockmarketscan in the tool picker.

Install — Cursor

Settings → Features → Model Context Protocol → Add New MCP Server:

{
  "name": "stockmarketscan",
  "url": "https://mcp.stockmarketscan.com/mcp",
  "headers": {
    "X-API-Key": "sms_your_key_here"
  }
}

Install — Continue (VS Code / JetBrains)

Edit ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "sse",
          "url": "https://mcp.stockmarketscan.com/mcp",
          "headers": {
            "X-API-Key": "sms_your_key_here"
          }
        }
      }
    ]
  }
}

Example prompts

Drop these straight into Claude Desktop or Cursor once the server is connected:

"Which stocks appear in both hot-prospects and golden-cross today?"
"Show me AMD's options flow history for the last 30 days."
"Find hot-prospects that are forming a cup and handle pattern."
"Build a full stock report for NVDA — screeners, patterns, options flow, market context."
"What are today's strongest bullish options flow signals?"
"Which contracts traded today at vol/OI > 3 with over $1M premium?"

How auth works (BYOK)

The MCP server does not hold its own API key. Each client passes your personal sms_* key, the server validates it once per session, and then proxies tool calls to api/v1/* on your behalf. You stay in control of rate limits and quota, and you can rotate the key any time in Settings.

Rate limits

Plan	Per Minute	Per Day	Options Flow
Free	—	—	—
Basic	15	500	—
Pro	30	2,000	✓

Support

Install guide: stockmarketscan.com/mcp
Contact: contact@stockmarketscan.com

Running from source

git clone https://github.com/stockmarketscan/mcp-server.git
cd mcp-server
npm install
STOCKMARKETSCAN_API_KEY=sms_your_key_here npm run dev   # stdio (for Claude Desktop local)
npm run dev:http                                        # HTTP/SSE on :3333

Docker

docker build -t stockmarketscan-mcp .
docker run -p 3333:3333 -e MCP_TRANSPORT=http stockmarketscan-mcp

The container listens on $PORT (Railway) or $MCP_PORT (local). Point your MCP client at http://localhost:3333/mcp and pass your X-API-Key header.

StockMarketScan