mcp server

StockMarketScan

18 tools for US stock screeners, chart patterns, options flow signals and equities research.

Description as published by the maintainer. Source

• version 1.0.5
• slowing
• retrieval

slowing — Most recent push to the repository was 2026-04-14. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

20 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

explain_concept(term)

Return a plain-language explanation of a platform-specific term, metric, or screener. Use ONLY for terms that are specific to StockMarketScan (e.g. 'strength_score' which is our internal scoring, or 'hot_prospects' which is our curated screener). Do NOT use for generic finance terms the model already knows — answer those directly. Returns { term, title, explanation, interpretation, related_terms }. Required: term.

get_candles(range, symbol, interval)

Return OHLCV price candles for a single stock. Use when you need price history to compute indicators or answer 'how much is X up this month'. time is a Unix epoch in seconds (UTC midnight for daily). Default range is 6mo. Use larger ranges like '1y' or '2y' only when the user explicitly asks for long history — max range is 20 years. Returns { symbol, interval, range, count, data: [{time, open, high, low, close, volume}] }. Required: symbol.

get_chart_patterns(symbol, interval)

Return all chart patterns currently detected for a single stock symbol. Detectable pattern 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. Use when the user asks 'what patterns does X have' or 'is X forming a head and shoulders'. Requires a Basic or Pro API key. Returns { symbol, interval, computedAt, candleCount, patterns: [...] }. Empty patterns array if none detected. Required: symbol.

get_market_momentum(date, date_to, date_from)

Return NYSE and NASDAQ market breadth data — advancing/declining issues, new highs/lows, percent advancing. Use when the user asks 'how's the market today' or 'is breadth strong'. Default (no params): last 7 trading days. Returns { dates, count, data: [{exchange, advancing_issues, declining_issues, new_highs, new_lows, percent_advancing_issues, data_date}] }. Two rows per date (NYSE + NASDAQ). Tier: Basic+.

get_options_flow_overview(date, sort, limit)

Return the daily options flow table for one trading day — aggregated call/put volume, premium, implied volatility, and consecutive-day streaks for every notable symbol. Use when the user asks 'what's the options flow today' or 'show me the top premium plays'. Each row includes call_put_volume_ratio (bullish if > 1.0), consecutive_days (streak length), total_premium (dollar size), call_avg_iv/put_avg_iv. Returns { date, sort, limit, data: [...], stats, dates }. Tier: Pro only — Basic users get 403.

get_options_flow_ranked(limit, date_to, date_from)

Return ranked options flow entries for a date range — the entries that stand out by long consecutive-day streaks, large premium, and screener confluence. Each entry includes data-only performance tracking measured from a realistic entry reference: entry_price = open of the trading day AFTER signal_date (the close of signal_date is unreachable for live trading). max_gain_pct/max_drawdown_pct/price_change_pct are computed against entry_price; if that day's US open hasn't happened yet, these fields and entry_price are null ('pending'). This is descriptive market data for your own research, not a recommendation. If date_from/date_to omitted, returns last 60 days. Returns { count, signals: [...] }. Tier: Pro only.

get_options_flow_sentiment(date_to, date_from)

Return daily options market sentiment — one row per trading day. Combines NYSE/NASDAQ market breadth (advance/decline + new highs/lows) with the market-wide call/put ratio. Each row includes market_breadth_score (0-100), market_call_put_ratio, the daily filter context (bullish_only/bearish_only/mixed), bullish_count/bearish_count of signals that day, plus a derived sentiment_score (0-100) and sentiment_label (bullish/neutral/bearish). Use when the user asks 'what's market sentiment today', 'how bullish is the market', 'show me sentiment over the last week'. If date_from/date_to omitted, returns last 60 days. Returns { dateFrom, dateTo, count, data: [...] }. Tier: Pro only.

get_options_flow_timeline(limit, symbol)

Return the historical options flow for a single stock — most recent days first. Use when the user asks 'show me X's options flow history' or 'how long has X been bullish'. Returns { symbol, limit, count, data: [daily rows, newest first] }. Tier: Pro only. Required: symbol.

get_screener_data(page, slug, limit)

Return the current rows of a single stock screener for its latest data date. Use this when the user asks about a specific screener like 'hot prospects' or 'golden cross'. Common slugs: hot-prospects, golden-cross, death-cross, rsi-oversold, rsi-overbought, defensive-stocks, dividend-prospects, j-pattern, nearing-6-month-highs, week-52-high-top-picks, top-penny-pops, strong-volume-gains, top-tech-stocks, fundamentally-fine, income-and-growth, best-reits. If you don't know the slug, call list_screeners first. Returns { screener, pagination, data: [stock rows] }. Required: slug.

get_stock_info(symbol)

Return basic metadata for a stock — full company name, exchange, industry, last close price, and percent change. Use this when you first encounter a symbol and need to identify it. Lighter than get_stock_report (composite) or get_candles (full history). Returns { symbol, symbol_name, last_price, percent_change, exchange, industry }. Returns NOT_FOUND for unknown tickers. Required: symbol.

get_stock_report(symbol, interval)

Return a comprehensive report on a single stock in one call — metadata, screener appearances, chart patterns, options flow, signal status, price summary, and upcoming earnings. THIS IS THE PREFERRED FIRST TOOL when a user asks about a single stock. It replaces 5-7 separate tool calls (get_stock_info + get_chart_patterns + get_options_flow_timeline + get_options_flow_ranked + screener lookups + get_candles). Do NOT also call the primitives after calling this — the composite already has everything. Parallel fetch under the hood, graceful partial failures (if one source errors, that section returns null with a note). Returns { symbol, info, screeners, patterns, options_flow, signal, candle_summary, upcoming_earnings, overall_bias }. overall_bias is a heuristic hint, not financial advice. Required: symbol.

get_trend_connections(date, days, limit, latest)

Return AI-computed connections between trending topics across categories (tech → patents, tech → funding, etc). Useful for spotting meta-trends. Use when the user asks 'what trends are connected' or 'show me cross-category signals'. Returns { count, connections: [{source_category, source_topic, target_category, target_topic, strength, rationale}] }. Tier: Pro only.

get_trends(date, days, latest, category)

Return AI-detected trending topics in tech & science, patents, or funding events. Use when the user asks 'what's trending in tech' or 'show me patent trends'. Returns { category, count, trends: [{date, topic, weight}] } where weight is 0-1. Tier: Pro only.

get_unusual_options_activity(side, limit, symbol, max_dte, min_vol_oi, min_premium_usd)

Return individual options contracts flagged as unusual (Vol/OI > 1.5). Each row is one contract, not one stock. Use when the user wants contract-level detail. Filter by symbol, side (call/put/both), minimum vol/oi, minimum premium, or max days to expiration. For aggregated stock-level flow use get_options_flow_overview instead. Returns { date, count, contracts: [...] }.

list_screeners

Return metadata for all 24 stock screeners on the platform, including each screener's slug, name, description, category, and tier. Use this to discover which screeners are available before calling get_screener_data. Call this once per session — the list changes very rarely. Returns { tier, total, accessible, screeners: [...] }.

ping

Minimal sanity check. Returns { status, version, timestamp, cache_size }. No auth needed. Use this to verify the MCP server is reachable and responsive.

search_patterns(limit, interval, pattern_ids, screener_slugs)

Find all stocks across one or more screeners that currently exhibit specific chart patterns. Much faster than calling get_chart_patterns in a loop. Use when the user asks 'which stocks have a cup and handle' or 'find me hot prospects with bullish reversal patterns'. Requires a Basic or Pro API key. Results are capped per screener group via `limit` (default 100); capped groups carry `truncated: true`. Returns { interval, selectedPatterns, totalUniqueStocks, groups: [...] }. Required: screener_slugs.

search_setups(side, limit)

Find the strongest trading setups today by combining options flow signals and screener confluence into a ranked list. Use when the user asks 'what should I trade today', 'best setups', 'top bullish plays'. Returns a ranked list with a composite score (signal strength + screener confluence + streak length). Present the top 3-5 to the user with narrative context, don't dump the raw JSON. Use get_stock_report if the user wants to dig deeper into any specific result. Returns { side, date, count, setups: [{symbol, score, signal, screeners_hit, ...}] }.

search_stocks(limit, query)

Search for stocks by ticker prefix or company name. THE tool to use when the ticker is unknown ('what's the symbol for Palantir?') or ambiguous — resolve the name to a symbol here, then use get_stock_info / get_stock_report with the symbol. No API key required. Returns { query, count, data: [{symbol, name}] } ordered by best match. Required: query.

search_stocks_in_screeners(mode, limit, screener_slugs)

Find stocks that appear in multiple screeners simultaneously. Powerful for high-confidence picks where the user wants confluence across strategies. Use when the user asks 'which stocks are in both X and Y' or 'find stocks in 3+ bullish screeners'. Returns { screeners_queried, mode, count, symbols: [{symbol, screeners, match_count}] }. Intersection mode returns only stocks in ALL listed screeners; union returns stocks in ANY. Required: screener_slugs.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.stockmarketscan.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.stockmarketscan.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/stockmarketscan/mcp-server
• Website — https://stockmarketscan.com/mcp
• Remote endpoint (sse) — https://mcp.stockmarketscan.com/mcp

Related, by what their authors tagged them

• mrmarket.ai — last commit 2026-06-19, shares finance, stocks
  Analytical engine for US-listed equities: screens, rankings, and event studies in plain English.
• com.boothcheck/boothcheck — last commit 2026-07-10, shares finance, stocks
  What a stock's price is betting on: implied growth, duration, margin from SEC filings. Free tools.
• TickerDB — last commit 2026-08-06, shares finance, stocks
  Pre-computed market data that improves agent reasoning, reduces token usage, and replaces pipelines.
• io.github.adididitagain/finance-mcp — last commit 2026-08-06, shares finance, stocks
  Live stock, crypto, SEC filings, insider trades, FX and macro data for LLM agents.
• io.github.AdityaSBisht/finance-mcp — last commit 2026-08-06, shares finance, stocks
  Live stock, crypto, SEC filings, FX and macro data for LLM agents. No API keys.
• 13FLOW — last commit 2026-08-04, shares finance, stocks
  Source-linked SEC 13F research, quality checks, watchlists and audit trails for agents.
• Stock Price API — last commit 2026-07-19, shares finance, stocks
  Real-time stock quotes — price, change, volume, market cap. x402 micropayment.
• io.github.cyanheads/finnhub-mcp-server — last commit 2026-07-30, shares finance, stocks
  Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and news via Finnhub.
• eToro MCP Server — last commit 2026-04-29, shares finance, stocks
  Connect AI assistants to eToro for portfolio analysis, market research, and trading.
• Chart Library — Pattern Intelligence — last commit 2026-06-10, shares finance, stocks
  Historical chart-pattern intelligence for AI agents. 25M+ embeddings, 19K+ symbols, 10y history.

These share tags the maintainers applied themselves, such as finance, stocks. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

Also from stockmarketscan

• OptionsBell Options Flow — last commit 2026-07-03
  Unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment, sectors.
• EarningsCalls.dev
  177,000+ earnings call transcripts for AI - speaker segments & full-text search.

How the author describes it

Topics the maintainer set on GitHub: chart-patterns, claude, cursor, finance, llm-tools, mcp, model-context-protocol, options-flow, screeners, stocks.