Summary
Connects Claude or Cursor to StockMarketScan's API with 18 tools spanning screeners, chart patterns, options flow, and market momentum. You can ask which stocks appear in multiple screeners, pull options flow timelines, find stocks forming cup-and-handle patterns, or generate composite reports with technical and flow data in one shot. Requires a Basic or Pro plan at stockmarketscan.com and passes your API key via header. Options flow tools need the add-on. Useful when you want to filter, cross-reference, or research US equities inside your editor without switching to a web dashboard. Runs over SSE, installs via npx and mcp-remote, or you can self-host with Docker.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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 theX-API-Keyheader - 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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →