Back

StockMarketScan Stock Screener MCP Server

StockMarketScan is a stock screener MCP server for Claude Desktop, Claude Code, claude.ai, Cursor and any other Model Context Protocol client. Ask a question in plain language and the model pulls the live data itself.

20 tools. Connect with a personal connector URL, an API key, or by signing in with OAuth. Four tools work with no account at all so you can try it before subscribing.

What a stock screener MCP server gives you

Once connected, you stop copy-pasting screener rows into a chat. You ask, and the model calls the tools it needs, chains them, and answers from live data:

  • What's the ticker for Palantir, and which screeners does it appear in right now?
  • Which stocks appear in both hot-prospects and golden-cross today?
  • Build a full stock report for NVDA: screeners, patterns, options flow, market context.
  • Find hot-prospects that are forming a cup and handle.
  • Show me AMD's options flow history for the last 30 days.
  • Which contracts traded today at vol/OI above 3 with over $1M premium?

The server ships workflow guidance to the model on connect, so it picks the right tool instead of paging through data. Asking about one stock triggers a single get_stock_report call rather than four separate lookups.

Setup — choose your path

Pick the row that matches your client. The personal connector URL is the simplest and the safest: it carries the credential inside the URL, so no client ever needs to handle an API key, and you can revoke a single device without touching the others.

01

Claude Desktop

Recommended
  1. 1Open Settings → Claude Connectors and generate a connector URL. Name it after the device, for example MacBook.
  2. 2In Claude Desktop go to Settings → Developer → Edit Config.
  3. 3Paste the URL as the url field. No headers, no environment variables.
  4. 4Restart Claude Desktop. stockmarketscan appears in the tool picker.
{
  "mcpServers": {
    "stockmarketscan": {
      "url": "https://mcp.stockmarketscan.com/u/mct_your_token/mcp"
    }
  }
}

On macOS the file lives at ~/Library/Application Support/Claude/claude_desktop_config.json, on Windows at %APPDATA%\Claude\claude_desktop_config.json.

02

Claude Code (CLI)

Generate a connector URL in Settings, then add it in one command:

claude mcp add --transport http stockmarketscan \
  https://mcp.stockmarketscan.com/u/mct_your_token/mcp

Verify with claude mcp list. It should report stockmarketscan as connected with 20 tools.

03

claude.ai (web)

Custom connectors need a Pro, Max, Team or Enterprise account. Two ways in:

With a connector URL

  1. 1Settings → Connectors → Add custom connector.
  2. 2Paste your connector URL and save. Nothing else to configure.

By signing in (OAuth)

  1. 1Add https://mcp.stockmarketscan.com/mcp as a custom connector — the bare server URL, with no token in it.
  2. 2Claude registers itself and sends you to stockmarketscan.com. Sign in if you are not already.
  3. 3Approve the consent screen. You land back in Claude, connected. No key is ever shown or pasted.

OAuth 2.1 with PKCE and dynamic client registration. The access token issued to Claude is a normal sms_ API key bound to your account, so it shares your existing quota and you can rotate it in Settings.

04

Cursor, Continue and any other MCP client

Clients that do not accept a bare URL take the credential as a header. Generate an API key in Settings and send it as X-API-Key or as Authorization: Bearer.

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" }
}

Continue — ~/.continue/config.json

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

Try it without an account

Connect to https://mcp.stockmarketscan.com/mcp with no credential at all and four tools still answer. Everything else returns a clear NEEDS_SUBSCRIPTION error with a signup link rather than a bare 401, so the model can tell you what it needs instead of failing silently.

pinglist_screenersget_stock_infoexplain_concept

Available tools — 20

Tools in green need no account.

Connection (1)

Sanity check that the server is reachable and your credential is being read.

ping

Screeners (3)

Discover which stocks sit in each curated screener, and find confluence across several of them at once.

list_screenersget_screener_datasearch_stocks_in_screeners

Chart Patterns (2)

Pull 25+ detected patterns for a symbol, or search the screeners for stocks currently forming one.

get_chart_patternssearch_patterns

Options Flow (5)

Daily flow tables, per-symbol history, ranked entries, market sentiment and contract-level unusual activity. Pro plan.

get_options_flow_overviewget_options_flow_timelineget_options_flow_rankedget_options_flow_sentimentget_unusual_options_activity

Stock Info (3)

Resolve a ticker or company name, then pull quote data and raw OHLCV candles for any US symbol.

search_stocksget_stock_infoget_candles

Composite (2)

One call that fans out across several endpoints in parallel — a full stock report, or setups ranked by options flow.

get_stock_reportsearch_setups

Market Context (3)

Daily market momentum (advancers/decliners, new highs and lows) plus Trend Monitor output and ticker-to-ticker connections.

get_market_momentumget_trendsget_trend_connections

Education (1)

Plain-language definitions of platform-specific terms like strength_score, vol_oi_ratio or consecutive_days.

explain_concept

Plans and quota

MCP tool calls draw on the same monthly quota as direct REST API requests, one for one. A typical research question costs three to five calls. When the quota runs out, tools return the reset date rather than an opaque failure.

PlanPer minutePer dayPer monthOptions flow
No accountThe four free tools above
Basic1550010,000
Pro302,00050,000Included

FAQ and troubleshooting

The client connects but shows zero tools
Almost always an outdated client. Update it and reconnect. If it persists, call ping — if that answers, the transport is fine and the issue is on the client side.
"Missing credentials"
The credential is not reaching the server. With a connector URL, check that the full URL including the /u/mct_.../mcp segment was pasted. With an API key, set it as a header — several clients ignore the env block for HTTP transports.
"Invalid API key format"
Keys start with sms_ and connector tokens with mct_, both at least 20 characters. A truncated copy is the usual cause.
A tool returns TIER_UPGRADE_REQUIRED
You called a Pro tool on the Basic plan, in practice one of the options flow tools. Upgrade in Settings, or ask the model to stay on screener, pattern and market context tools.
claude.ai asks me to sign in again during setup
Expected. The OAuth consent screen runs on stockmarketscan.com and needs its own session. Sign in there once and approve; Claude takes it from there.
How do I revoke access?
Revoke the connector URL in Settings and that device stops working immediately while the others keep going. Rotating your API key cuts off every client using the key, including anything connected through OAuth.
Can I use more than one connector URL?
Yes, one per device or client is the point. Each is named and revoked on its own.
Does it work with clients other than Claude?
Yes. It is a standard MCP server speaking Streamable HTTP and SSE, tested with Claude Desktop, Claude Code, claude.ai and Cursor. Anything that speaks either transport will work.

Technical reference: MCP server for stock market data

Everything below is what you need to point a client we have not listed at the endpoint directly, or to run this MCP server for stock market data from source.

# Endpoint (Streamable HTTP and SSE)

https://mcp.stockmarketscan.com/mcp

# Personal connector URL

https://mcp.stockmarketscan.com/u/<mct_token>/mcp

# Credential, either header

X-API-Key: sms_your_key_here

Authorization: Bearer sms_your_key_here

# OAuth 2.1 discovery

https://mcp.stockmarketscan.com/.well-known/oauth-protected-resource

https://stockmarketscan.com/.well-known/oauth-authorization-server

Source is open at github.com/stockmarketscan/mcp-server. The REST API behind it is documented in the API docs.

Ready to connect?

Generate a connector URL, paste it into your client, and ask your first question. The whole stock screener MCP server is two minutes of setup.

Generate a connector URL