StockMarketScan MCP Server (com.stockmarketscan/mcp-server)

This Model Context Protocol (MCP) server provides tools for US equities research, including stock screeners, chart patterns, options flow, and related signals. It is designed to run inside an LLM client and exposes capabilities via HTTP/SSE, with authentication handled through a user-provided API key.

🛠️ Key Features

18 tools for US stock screeners, chart patterns, options flow signals, and equities research
HTTP/SSE transport (https://mcp.stockmarketscan.com/mcp)
BYOK authentication using the X-API-Key header with a personal sms_* API key
Options flow tools require the Options Flow add-on
Requires a Basic or Pro plan at stockmarketscan.com

🚀 Use Cases

Query US stock screeners from an LLM client
Retrieve chart pattern information
Access options flow signals for equities research

⚡ Developer Benefits

Tool-based access to finance features inside MCP-enabled applications
Stable integration via HTTP/SSE and header-based API key auth

⚠️ Limitations

Basic/Pro plan required
Options flow tooling limited to users with the Options Flow add-on

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

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:

json

{
  "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:

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

bash

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

bash

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.

slug	string	required	The screener slug, e.g. 'hot-prospects', 'golden-cross', 'rsi-oversold'
page	integer	optional	Page number (1-based)
limit	integer	optional	Rows per page (max 500)

screener_slugs	array	required	List of screener slugs to query (1-24)
mode	string	optional	intersection = stocks in ALL screeners; union = stocks in ANY screener
limit	integer	optional

symbol	string	required	Stock ticker, e.g. AAPL, TSLA, MSFT
interval	string	optional	Chart interval

screener_slugs	array	required	Screener slugs to search within
pattern_ids	array	optional	Pattern ids to filter by. Empty = all patterns. Valid ids: double_top, double_bottom, triple_top, triple_bottom, head_shoulders, inv_head_shoulders, round_bottom, cup_handle, asc_triangle, desc_triangle, sym_triangle, channel_up, channel_down, rectangle, flag, wedge_rising, wedge_falling, abcd, gartley, bat, butterfly, crab, impulse_wave, corrective_wave
interval	string	optional	Chart interval
limit	integer	optional	Max matching stocks per screener group (default 100)

date	string	optional	Trading day (YYYY-MM-DD). Default = latest available day.
sort	string	optional	Sort order: streak=longest streaks first, volume=highest volume, callput=most extreme C/P, premium=biggest dollar
limit	integer	optional	Rows to return (max 500)

date_from	string	optional	Start date (YYYY-MM-DD)
date_to	string	optional	End date (YYYY-MM-DD)
limit	integer	optional	Max signals returned (default 500)

query	string	required	Symbol prefix or part of the company name, e.g. 'Apple' or 'NVD'
limit	integer	optional	Max results (default 10)

side	string	optional	Side of setups to return
limit	integer	optional	Max setups to return

days	integer	optional
latest	boolean	optional
date	string	optional
limit	integer	optional	Max connections returned (default 200)

symbol	string	required	Stock ticker
interval	string	optional	Daily or weekly candles
range	string	optional	Range: 1d, 5d, 1y, 2y, 5y, max, or {N}mo (1-240)