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

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

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.