{
  "markdown": "# StockMarketScan MCP Server\n\n**Stock screeners, chart patterns, options flow, and signals — 18 tools for US equities research, inside your LLM client.**\n\n- **Server URL:** `https://mcp.stockmarketscan.com/mcp`\n- **Transport:** HTTP/SSE (Server-Sent Events)\n- **Auth:** BYOK — pass your personal `sms_*` API key as the `X-API-Key` header\n- **Plan:** Requires a **Basic** or **Pro** plan at [stockmarketscan.com](https://stockmarketscan.com). Options flow tools require the Options Flow add-on.\n- **Get your API key:** [stockmarketscan.com/settings](https://stockmarketscan.com/settings)\n- **Full install guide & examples:** [stockmarketscan.com/mcp](https://stockmarketscan.com/mcp)\n\n## What you get — 18 tools\n\n| Category | Tools |\n|---|---|\n| **Screeners (3)** | `list_screeners`, `get_screener_data`, `search_stocks_in_screeners` |\n| **Chart Patterns (2)** | `get_chart_patterns`, `search_patterns` |\n| **Options Flow (4)** | `get_options_flow_overview`, `get_options_flow_timeline`, `get_options_flow_signals`, `get_unusual_options_activity` |\n| **Stock Info (2)** | `get_stock_info`, `get_candles` |\n| **Composite (2)** | `get_stock_report`, `search_setups` |\n| **Market Context (3)** | `get_market_momentum`, `get_trends`, `get_trend_connections` |\n| **Education (1)** | `explain_concept` |\n\nPlus `ping` for liveness checks.\n\n## Install — Claude Desktop\n\nEdit `claude_desktop_config.json`:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"stockmarketscan\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.stockmarketscan.com/mcp\"],\n      \"headers\": {\n        \"X-API-Key\": \"sms_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see **stockmarketscan** in the tool picker.\n\n## Install — Cursor\n\nSettings → Features → Model Context Protocol → Add New MCP Server:\n\n```json\n{\n  \"name\": \"stockmarketscan\",\n  \"url\": \"https://mcp.stockmarketscan.com/mcp\",\n  \"headers\": {\n    \"X-API-Key\": \"sms_your_key_here\"\n  }\n}\n```\n\n## Install — Continue (VS Code / JetBrains)\n\nEdit `~/.continue/config.json`:\n\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServers\": [\n      {\n        \"transport\": {\n          \"type\": \"sse\",\n          \"url\": \"https://mcp.stockmarketscan.com/mcp\",\n          \"headers\": {\n            \"X-API-Key\": \"sms_your_key_here\"\n          }\n        }\n      }\n    ]\n  }\n}\n```\n\n## Example prompts\n\nDrop these straight into Claude Desktop or Cursor once the server is connected:\n\n- *\"Which stocks appear in both hot-prospects and golden-cross today?\"*\n- *\"Show me AMD's options flow history for the last 30 days.\"*\n- *\"Find hot-prospects that are forming a cup and handle pattern.\"*\n- *\"Build a full stock report for NVDA — screeners, patterns, options flow, market context.\"*\n- *\"What are today's strongest bullish options flow signals?\"*\n- *\"Which contracts traded today at vol/OI > 3 with over $1M premium?\"*\n\n## How auth works (BYOK)\n\nThe 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](https://stockmarketscan.com/settings).\n\n## Rate limits\n\n| Plan | Per Minute | Per Day | Options Flow |\n|---|---|---|---|\n| Free | — | — | — |\n| **Basic** | 15 | 500 | — |\n| **Pro** | 30 | 2,000 | ✓ |\n\n## Support\n\n- **Install guide:** [stockmarketscan.com/mcp](https://stockmarketscan.com/mcp)\n- **Contact:** contact@stockmarketscan.com\n\n## Running from source\n\n```bash\ngit clone https://github.com/stockmarketscan/mcp-server.git\ncd mcp-server\nnpm install\nSTOCKMARKETSCAN_API_KEY=sms_your_key_here npm run dev   # stdio (for Claude Desktop local)\nnpm run dev:http                                        # HTTP/SSE on :3333\n```\n\n### Docker\n\n```bash\ndocker build -t stockmarketscan-mcp .\ndocker run -p 3333:3333 -e MCP_TRANSPORT=http stockmarketscan-mcp\n```\n\nThe container listens on `$PORT` (Railway) or `$MCP_PORT` (local). Point your\nMCP client at `http://localhost:3333/mcp` and pass your `X-API-Key` header.\n",
  "bytes": 4224,
  "sha": "e64adfc91bfc88a3fb89e6821ef5775d1c2e2325045ca727a12c011a55de102e",
  "repo_slug": "stockmarketscan/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_stockmarketscan_mcp_server_9cf1db42/readme"
}