Skip to main content
Glama

stoquant-mcp

npm version MCP Registry License: MIT Tools

Model Context Protocol (MCP) server for StoQuant — gives Claude (and any MCP-compatible agent) direct, read-only access to StoQuant's quant signals, ML predictions, screening, ownership, and macro data.

Free to start. A free StoQuant API key runs the core tools (quotes, Q-Score, screeners, market regime) at 100 requests/day. Power removes the cap and unlocks the premium tools (ML, alt-data, insider clustering). Get a key at https://stoquant.com/account/api-keys.

Source & listings: GitHub · npm · Official MCP Registry (io.github.ohadf2015/stoquant-mcp) · Landing page

One-command install

npx -y stoquant-mcp install

You'll be prompted for your API key. The installer writes the right claude_desktop_config.json for your OS, backs up any existing config, then prints the next step.

After install, fully quit and relaunch Claude Desktop. Type list available tools to confirm the stoquant_* tools are loaded.

Manual install (alternative)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "stoquant": {
      "command": "npx",
      "args": ["-y", "stoquant-mcp", "serve"],
      "env": {
        "STOQUANT_API_KEY": "sk_live_…"
      }
    }
  }
}

Config locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Related MCP server: Financial Modeling Prep MCP Server

Tools (61)

Category

Tools

Prices

get_quote, get_quotes_batch, get_extended_quote, get_sparklines, get_benchmarks, get_sector_performers

Research

get_qscore, get_signals_v2, get_ml_prediction, explain_ml_prediction, get_strategic_edges, get_quant_analytics, get_evidence

Signals

get_market_regime, get_signal_accuracy, get_accuracy_summary

Discovery

get_top_conviction, get_hidden_gems, get_multibagger_candidates, get_related_stocks, get_signal_accuracy_heatmap

Screener

list_prebuilt_screens, run_prebuilt_screen, run_screener

Ownership

get_insider_trades, get_insider_cluster, get_big_insider_buys, get_institutional_holders, get_institutional_ratings, get_analyst_estimates, get_analyst_price_targets, get_analyst_changes, get_short_interest

Filings & News

get_sec_filings, get_news, get_news_events

Social

get_social_sentiment, get_social_trend, get_trending_social, get_social_momentum, get_source_credibility

Catalysts

get_catalysts, get_catalyst_watch

Alt-data

get_alt_signals (FDA, CPSC, SEC suite, clinical trials, GitHub, App Store, Hacker News, news tone — one call), get_alt_data (Google Trends, Wikipedia views, options IV)

Options flow

get_unusual_options

Portfolio

get_auto_portfolio_status, get_auto_portfolio_history, get_portfolio_health, optimize_portfolio

Backtest

list_backtest_templates, run_backtest, get_backtest, get_backtest_history

Strategy

get_strategy_performance, list_strategy_presets, get_strategy_preset_candidates

Macro

get_macro_indicator, get_macro_dashboard, get_macro_calendar, get_macro_themes

Most tools are read-only fetches. run_backtest persists a simulation run (no live or paper orders). There is no order placement, cash move, or holdings mutation. Each tool is annotated readOnlyHint so agents know it is safe to call.

Accuracy and the no-edge gate

get_accuracy_summary hits the public /public/accuracy/summary scorecard. Read excessSpreadPp (alpha spread) and dataSufficient — do not treat hitRate as skill. When dataSufficient && excessSpreadPp < 0, auto-portfolio buys are suppressed (gated:no_edge). Call this before any buy-oriented portfolio read.

Portfolio/backtest/strategy tools are evaluate/read/backtest/optimize. This server never places orders. POST /auto-portfolio/evaluate executes paper trades and is not exposed.

Two things to know

  • The Q-Score (get_qscore) is the headline 0-100 composite, computed on sector-residualized returns (sector beta removed). Start here for "is this a good stock".

  • The ML prediction (get_ml_prediction) returns the probability of outperforming the S&P 500 over a horizon (classification: bull|bear) — it is not a buy/hold/sell rating.

Resources

The server exposes reference docs an agent can read on demand:

  • stoquant://glossary — what Q-Score, ML outperformance, regimes, and signal accuracy mean, plus unit conventions.

  • stoquant://methodology — sector residualization, IC-weighting, ML health gating, and screener field semantics.

Prompts

Pre-built workflows that chain the tools:

  • analyze_ticker(ticker) — full single-stock deep dive (Q-Score + ML + ownership + edges → verdict).

  • find_opportunities(style) — generate and vet a shortlist for a style (value, momentum, growth, hidden gems).

  • market_briefing — top-down snapshot (regime + macro + benchmarks + conviction).

Using the screener

run_screener filters on exact camelCase field names. An unknown field is treated as null server-side and silently excludes every stock, so use the documented names:

trailingPE, priceToBook, pegRatio, marketCap, debtToEquity, currentRatio, grossMargins, operatingMargins, revenueGrowth, earningsGrowth, rsi14, fiftyDayAverageChangePercent, twoHundredDayAverageChangePercent, fiftyTwoWeekHighChangePercent, shortPercentOfFloat, numberOfAnalystOpinions, sector, regularMarketPrice, regularMarketVolume, regularMarketChangePercent.

Margins/growth are decimals (0.25 = 25%); marketCap is raw USD (250000000 = 250M). Operators: gt, gte, lt, lte, eq, between (value: [low, high]), in (value: [string, …]).

The screener reads from StoQuant's cached daily fundamentals (fast, refreshed daily). Prefer run_prebuilt_screen (pre-tuned) or run_screener with universe: "sp500" and a few filters.

Example prompts

  • "Get the Q-Score for NVDA and explain the top features driving the ML call."

  • "Show me the top 10 conviction stocks and their current ML outperformance odds."

  • "What's the current market regime, and which sectors are leading?"

  • "Run the undervalued-gems prebuilt screen on the sp500 universe."

  • "Screen sp500 for trailingPE under 15 and debtToEquity under 0.5."

  • "Get insider activity for PLTR over the last quarter."

  • "What is the live accuracy grade and excessSpreadPp? Do not buy if the tail is inverted."

  • "Show auto-portfolio last eval and holdings. If gated:no_edge, do not recommend buys."

  • "List backtest templates and run momentum on sp500 for 2023."

Security

  • Server requires STOQUANT_API_KEY — fails fast on boot if missing or malformed.

  • All requests use HTTPS. Bearer token in Authorization header. Never logged.

  • Tickers are validated (^[A-Za-z0-9.\-^]{1,10}$) before any external use.

  • Client-side rate limit: 200 req/min (configurable via STOQUANT_RATE_LIMIT_RPM).

  • 30s per-request timeout (configurable via STOQUANT_TIMEOUT_MS).

  • Server-side: API key is hashed (SHA-256) at rest, prefix-indexed for fast lookup, timing-safe-compared on verify.

  • Revoke any key from https://stoquant.com/account/api-keys at any time.

Environment variables

Var

Default

Description

STOQUANT_API_KEY

— (required)

Your StoQuant API key (free or Power tier)

STOQUANT_BASE_URL

https://stoquant.com/api

API base URL

STOQUANT_RATE_LIMIT_RPM

200

Client-side rate limit (req/min)

STOQUANT_TIMEOUT_MS

30000

Per-request timeout

STOQUANT_DEV

0

Set 1 to allow http:// base URLs (local dev only)

License

MIT

Available Tools

49 tools
stoquant_explain_ml_predictionExplain ML predictionA
Read-only

Top feature contributions behind a ticker's ML outperformance prediction — which signals pushed the probability up or down, with signed magnitudes. Use after stoquant_get_ml_prediction when the user asks WHY the model is bullish/bearish. horizon must match the prediction you are explaining.

Inputs: ticker (required), top, horizon.

stoquant_get_accuracy_summaryGet platform accuracy summaryA
Read-only

Platform-wide model scorecard: letter grade, overall hitRate, sampleSize, top- vs bottom-quintile average 90-day returns and their spreadPp (the real edge), spyAvgReturn90d (Russell 2000 benchmark preferred via IWM/^RUT, SPY fallback), trend/trendDelta, a Wilson confidence interval, and dataSufficient. Use to gauge overall reliability of StoQuant's signals right now.

Inputs: no named parameters.

stoquant_get_alt_dataGet web alt-data (trends, IV, pageviews)A
Read-only

Generic cached alternative-data for a ticker under data, keyed by source: google_trends (search interest), wikipedia_pageviews (attention), options_iv (implied-vol metrics), openinsider (insider feed), edgar_8k. Each source carries its latest values and fetchedAt. Complements stoquant_get_alt_signals with retail-attention and options-positioning reads.

Inputs: ticker (required).

stoquant_get_alt_signalsGet alternative-data signalsA
Read-only

The full alternative-data dossier for a ticker in one call, under data. Aggregates 15 sources: sec8k (8-K event items + counts), secLate (NT-10K/Q late filings), sec13dg (13D/13G activist/passive ownership), secDilution (S-1/S-3/424B shelf + active-dilution flag), secGovernance (DEF 14A, Form 25 delisting, Form 15 deregistration flags), secInsiderIntent (Form 144/Form 3 counts), secS8 (employee stock plans), fdaEnforcement (Class I/II/III actions), cpscRecalls (consumer recalls), clinicalTrials (phase/recruiting — biotech), github (stars/forks/issues/push activity), appStore (iOS rank deltas), hackerNews (story velocity), gdelt (news tone). Sources with no recent activity for the ticker are null (e.g. clinicalTrials for a non-biotech). This is the platform's differentiated edge — use it to surface catalysts and red flags an ordinary data feed misses.

Inputs: ticker (required).

stoquant_get_analyst_changesGet analyst upgrades/downgradesA
Read-only

Recent analyst rating changes for a ticker — upgrades, downgrades, reiterations, and initiations — with a 90-day action breakdown. Use to see the direction of sell-side revisions (momentum in sentiment), not just the static consensus.

Inputs: ticker (required).

stoquant_get_analyst_estimatesGet analyst estimatesA
Read-only

Sell-side analyst forward estimates for a ticker under data (per fiscal period: estimated EPS avg/high/low, estimated revenue avg/high/low, number of analysts) with a count. Use for consensus expectations and dispersion. Some future periods may have null estimates until coverage fills in.

Inputs: ticker (required).

stoquant_get_analyst_price_targetsGet analyst price targetsA
Read-only

Analyst price targets for a ticker with a consensus block (avgTarget, highTarget, lowTarget, numAnalysts) and the underlying data. Use to gauge implied upside/downside vs the current price and the dispersion of targets.

Inputs: ticker (required).

stoquant_get_benchmarksGet index benchmarksA
Read-only

Current performance of major index ETFs (SPY, QQQ, IWM, and peers): 1-day and year-to-date return. Use to frame an individual stock against the market. Early in the trading day the response may be {error:'Benchmarks not yet computed'} until the daily compute runs — treat that as 'not ready', not a failure.

Inputs: no named parameters.

stoquant_get_big_insider_buysGet big insider buys (market-wide)A
Read-only

Market-wide list of tickers with large recent insider purchases (default >= $1M) under items, each with the buy detail plus a current quote and Q-Score. Use for 'where are insiders putting real money right now' discovery across the whole market.

Inputs: days, limit, minValue.

stoquant_get_catalystsGet catalystsA
Read-only

Upcoming and recent catalysts under data, each with ticker, type (e.g. earnings_soon, activist_stake, dilution, fda), date, label, direction (bullish/bearish/neutral), and source. Omit ticker for the market-wide feed; pass a ticker to filter to one name (may be empty if that stock has no tracked catalysts right now). Use to find date-driven, event-based opportunities.

Inputs: ticker.

stoquant_get_catalyst_watchGet catalyst watch (market-wide)A
Read-only

Cross-ticker hot list of the highest-impact near-term catalysts the platform is tracking (FDA decisions, activist stakes, dilution events, clinical readouts, etc.). Use for market-wide 'what's about to move' discovery, distinct from per-ticker stoquant_get_catalysts.

Inputs: no named parameters.

stoquant_get_evidenceGet named evidence (bull/bear case)A
Read-only

The named, two-sided evidence behind a ticker's Q-Score — the 'bull case vs bear case' as concrete facts rather than scores. Returns five grids (momentum, sentiment, earnings, valuation, risk), each with cells: every cell has a human-readable label (e.g. 'Price above 50-day average', 'Short interest'), a formatted value, and a tone ('bullish'|'bearish'|'neutral'|'unknown'). To assemble a balanced case, collect cells with tone 'bullish' (the bull case) and 'bearish' (the bear case) across all five grids. Use this AFTER stoquant_get_qscore when the user asks WHY the score is what it is, or wants the specific positives and negatives to weigh — it is the evidence layer the research page shows above the dimension breakdown.

Inputs: ticker (required).

stoquant_get_extended_quoteGet quote with technicalsA
Read-only

Quote plus computed technical indicators for one ticker: RSI(14), MACD, Bollinger Bands, and moving-average context. Use when you need momentum/overbought-oversold context, not just price. Heavier than stoquant_get_quote; can occasionally time out on cold cache — retry once if so.

Inputs: ticker (required), timezone.

stoquant_get_hidden_gemsGet hidden gemsA
Read-only

Undervalued small-caps with confirming signals (the 'hidden gem' screen: low valuation, healthy balance sheet, low analyst coverage, plus momentum/ML/insider confirmation). Returns {gems:[...], totalCount, lastScanAt}. freshness filters by how recently a gem's signals fired. Use for value-oriented idea generation distinct from momentum.

Inputs: limit, freshness.

stoquant_get_insider_clusterGet insider cluster metricsA
Read-only

Insider-buying cluster metrics for a ticker under data: distinctFilers14d, officerCount14d, purchaseCount90d, totalValue90d, clusterScore, and a clusterMomentum flag. Cluster buying by multiple insiders (especially officers, large dollar value) is a strong bullish signal — this scores it. Pairs with stoquant_get_insider_trades (the raw transactions).

Inputs: ticker (required).

stoquant_get_insider_tradesGet insider tradesA
Read-only

Recent insider (Form 4) transactions for a ticker under data, plus a summary (net buy/sell counts and dollar value). Cluster buying by officers/directors — especially large dollar buys — is a notable bullish signal. Use to check whether insiders are accumulating or distributing.

Inputs: ticker (required).

stoquant_get_institutional_holdersGet institutional holdersA
Read-only

Top institutional holders for a ticker: organization name, shares held, and percent ownership. Use to gauge institutional concentration and who the big holders are.

Inputs: ticker (required).

stoquant_get_institutional_ratingsGet institutional sentimentA
Read-only

Aggregated institutional sentiment for a ticker: holder additions vs reductions and a net signal direction. Use as a 'smart money' flow read distinct from analyst ratings.

Inputs: ticker (required).

stoquant_get_macro_calendarGet economic calendarA
Read-only

Forward (~14 day) economic calendar: scheduled releases with forecast, prior value, and expected market impact. Use to flag upcoming macro events (CPI, FOMC, jobs) that could move positions.

Inputs: no named parameters.

stoquant_get_macro_dashboardGet macro dashboardA
Read-only

Full top-down macro picture in one call: regime classification, key indicators, macroStress gauge, sectorRotation (which sectors are favored, with valid GICS sector names), forward calendar, and current themes. Best first call for 'what's the macro backdrop' before drilling into stocks.

Inputs: no named parameters.

stoquant_get_macro_indicatorGet macro indicator (FRED)A
Read-only

Latest values for one FRED macro series under data (recent observations) with a count. Common ids: DGS10 (10y Treasury yield), DGS2 (2y), T10Y2Y (10y-2y spread), UNRATE (unemployment), CPIAUCSL (CPI), VIXCLS (VIX), FEDFUNDS (fed funds). Use for a single specific indicator; for the full picture use stoquant_get_macro_dashboard.

Inputs: seriesId (required).

stoquant_get_macro_themesGet macro themesA
Read-only

Current macro investment themes with their related sectors — the narrative layer (e.g. rate-cut beneficiaries, AI capex). Use for thematic idea generation that ties stocks to a macro thesis.

Inputs: no named parameters.

stoquant_get_market_regimeGet market regimeA
Read-only

Current market-regime classification from the Hidden Markov Model over S&P 500 returns: regime label (e.g. Bull/Range/Bear) and the probability vector across states. Use to set top-down context before stock-level calls. If the model reports it could not fit, probabilities fall back to roughly uniform — read that as 'regime undetermined', not a confident Range call.

Inputs: no named parameters.

stoquant_get_ml_predictionGet ML outperformance predictionA
Read-only

ML model's probability that the ticker will OUTPERFORM the S&P 500 over the horizon (NOT a buy/hold/sell call). Returns data.prediction with: probability (0-1, chance of outperformance), classification ('bull' = predicted to outperform, 'bear' = underperform), modelVersion, modelAuc, plainLanguage (headline/summary/topDrivers), and isHeuristic (true when the trained model is gated for distribution drift and a heuristic fallback is used — weight it less). Use stoquant_explain_ml_prediction for the feature-level 'why'. horizon is in trading days. Note: early in the US trading day (before ~10am ET), the prediction may not yet be refreshed with intraday data — a null or empty prediction should be treated as 'not yet computed' rather than an error.

Inputs: ticker (required), horizon.

stoquant_get_multibagger_candidatesGet multibagger candidatesA
Read-only

Small/mid-caps flagged with high (>5x) upside potential: revenue acceleration, improving fundamentals, and pre-discovery setups. Higher risk/variance than hidden gems. Use for aggressive growth idea generation.

Inputs: limit.

stoquant_get_newsGet news headlinesA
Read-only

Recent news headlines for a ticker under items: each with publishedAt, headline, source/provider, category, and a sentiment label. Use for the latest narrative around a stock. For news plus filings plus earnings in one combined view, use stoquant_get_news_events.

Inputs: ticker (required), days, limit.

stoquant_get_news_eventsGet news, filings & earningsA
Read-only

Combined event view for a ticker under data: news (headlines), filings (SEC), and earnings (calendar). The single best call for 'what is happening with this stock' — recent coverage, regulatory activity, and upcoming/just-reported earnings together.

Inputs: ticker (required).

stoquant_get_qscoreGet Q-ScoreA
Read-only

The Q-Score is StoQuant's headline 0-100 composite for a ticker, blending fundamentals, momentum/technicals, ML, analyst, and 'hidden gem' value dimensions on SECTOR-RESIDUALIZED forward returns (sector beta removed). Returns: score (0-100), signal ('strong_buy'|'buy'|'hold'|'sell'|'strong_sell'|'unrated'), per-dimension components (each with rawValue, normalizedScore, weight, and an available flag — unavailable dims contribute 0), confidence/confidenceInterval, dimensionContributions, a verdict and plainLanguage summary, and riskAlerts. This is the best single tool for 'is this a good stock right now'. period selects the scoring horizon. Note: early in the US trading day (before ~10am ET), the score may not yet be refreshed with intraday data — a null or empty score should be treated as 'not yet computed' rather than an error.

Inputs: ticker (required), period.

stoquant_get_quant_analyticsGet quant analyticsA
Read-only

Quantitative analytics for a ticker under data: factor exposures, correlation/quality metrics, and risk decomposition. Use for portfolio-construction and factor-tilt questions. Complements stoquant_get_qscore (verdict) with the underlying quant detail.

Inputs: ticker (required).

stoquant_get_quoteGet stock quoteA
Read-only

Real-time quote for ONE ticker: last price, day change (absolute and percent), bid/ask, day high/low, and volume. Use for a single symbol; for 2+ symbols use stoquant_get_quotes_batch (one call, far fewer requests). Prices are delayed per the data vendor, not tick-by-tick.

Inputs: ticker (required).

stoquant_get_quotes_batchGet quotes (batch)A
Read-only

Current quotes for up to 50 tickers in a single call. Preferred over calling stoquant_get_quote in a loop — same data, one request, stays well under rate limits. Returns one quote object per ticker (price, change, volume).

Inputs: tickers (required).

stoquant_get_sec_filingsGet SEC filingsA
Read-only

Recent SEC filings for a ticker under items (with count/total), unioning the whole suite: 8-K events (with item labels like 'Item 2.02 Results of Operations'), NT-10K/Q late filings, 13D/13G activist/passive ownership, S-1/S-3/424B dilution, DEF 14A / Form 25 / Form 15 governance, and Form 144/3 insider intent. Each item has accession, formType, filedDate, category, and a human-readable label. Use to read the actual regulatory record behind a thesis.

Inputs: ticker (required), days, limit.

stoquant_get_sector_performersGet sector leaders/laggardsA
Read-only

Top and bottom performing stocks within a GICS sector, by recent return. Use to find what is leading or lagging inside a sector. sector must be a full GICS name (see stoquant_get_macro_dashboard sectorRotation for valid names), e.g. 'Technology', 'Health Care', 'Financials'.

Inputs: sector (required), limit.

stoquant_get_short_interestGet short interestA
Read-only

Short-interest history for a ticker: append-only snapshots plus a summary (latestFloat = % of float short, latestRatio = days-to-cover, and window deltas). Rising short interest with a price squeeze can signal a short squeeze; falling can signal covering. Use for crowded-short reads.

Inputs: ticker (required).

stoquant_get_signal_accuracyGet signal hit-ratesA
Read-only

Historical track record per signal type: an array of records with signalType, hitRate (0-1), totalObservations, avgReturnPercent, precision, and windowDays. Use to weight how much to trust a given signal before acting on it — prefer signals with high hitRate AND large totalObservations.

Inputs: no named parameters.

stoquant_get_signal_accuracy_heatmapGet accuracy heatmapA
Read-only

Hit-rate heatmap of signals over time/ticker for a date range — which signal types worked when. Use for backtest-style 'has this signal been reliable lately' questions. Dates are YYYY-MM-DD; omit for the default recent window.

Inputs: endDate, startDate.

stoquant_get_signals_v2Get stage-adjusted signalsA
Read-only

Returns both the raw Q-Score (originalQScore) and a stage/regime-adjusted variant (adjusted) for a ticker. Use this when you want the score adjusted for the stock's lifecycle stage and current market regime rather than the raw composite. For the full breakdown use stoquant_get_qscore.

Inputs: ticker (required).

stoquant_get_social_momentumGet social momentum surgesA
Read-only

Tickers with a sharp (2x+) surge in social mentions in the last hour vs the prior hour — the earliest social-momentum signal, with sentiment and a recent post snippet per name. Use to catch breakouts in attention before they are widely noticed.

Inputs: no named parameters.

stoquant_get_social_sentimentGet social sentimentA
Read-only

Current social-media buzz for a ticker: totalMentions, recentPostCount24h, sentimentBreakdown (bullish/bearish/neutral), topPlatforms, and a sample of recentPosts. Use to read retail attention and crowd sentiment. Sources are credibility-weighted platform aggregates, not raw noise.

Inputs: ticker (required).

stoquant_get_social_trendGet social sentiment trendA
Read-only

Daily social mention-volume and sentiment trend for a ticker over the last ~30 days. Use to see whether attention and bullishness are building or fading, not just the current snapshot.

Inputs: ticker (required).

stoquant_get_source_credibilityGet social source credibilityA
Read-only

Leaderboard of social sources ranked by true directional accuracy (Wilson lower-bound on their calls). Use to judge how much weight to give a platform or author's sentiment — high-credibility sources earn more trust than raw mention volume.

Inputs: limit.

stoquant_get_sparklinesGet price history (sparklines)A
Read-only

Historical price series (~90 days) for up to 50 tickers, for charting or trend/return computation. interval controls granularity (1d daily, 1wk weekly, 1mo monthly). Returns an array of close prices per ticker, not full OHLCV.

Inputs: tickers (required), interval.

stoquant_get_strategic_edgesGet competitive intelligenceA
Read-only

Qualitative competitive intelligence for a ticker: economic moats, structural weaknesses, upcoming catalysts, and peer comparison. Best for mid/small-caps; mega-caps and thinly-covered names may return {data:null} (no edges computed) — treat that as 'no data', not an error.

Inputs: ticker (required).

stoquant_get_top_convictionGet top-conviction picksA
Read-only

StoQuant's current highest-conviction names: the stocks with the strongest Q-Scores backed by multiple corroborating signals. Use as the starting point for 'what does the platform like right now'. May be empty between scans ({stocks:{}}).

Inputs: limit.

stoquant_list_prebuilt_screensList prebuilt screensA
Read-only

List the curated prebuilt screens with their id, name, and description. Available screens: 'undervalued-gems' (low P/E, P/B value plays), 'momentum-leaders' (strong price momentum), 'oversold-bounce' (RSI reversal setup), 'ml-outperform' (ML-predicted S&P 500 outperformance), 'hidden-gems' (small-cap value with confirmation signals), 'growth-explosion' (high-growth micro/mid-caps before discovery), 'pre-explosion' (multibagger pattern: revenue acceleration + insider + fundamentals). Call this first, then run one with stoquant_run_prebuilt_screen — it is faster and better-tuned than hand-built filters.

Inputs: universe.

stoquant_run_prebuilt_screenRun a prebuilt screenA
Read-only

Run one curated screen by its id (from stoquant_list_prebuilt_screens) and get the ranked matching stocks. Prefer this over stoquant_run_screener for common intents (value, momentum, oversold, ML picks, hidden gems, growth) — the filters are pre-tuned. universe defaults to sp500; use 'full' for the broadest set. Result count is fixed by the screen definition.

Inputs: screenId (required), universe.

stoquant_run_screenerRun a custom screenA
Read-only

Run a custom stock screen. Read-only — nothing is mutated. All filters are AND-combined; returns an ARRAY of matching stocks (ticker, name, price, plus the requested metrics and overlays like valueScore/qScore/mlProbability). Valid filter fields (camelCase, case-sensitive): trailingPE, forwardPE, priceToBook, marketCap, epsTrailingTwelveMonths, dividendYield, bookValue, regularMarketPrice, fiftyDayAverage, twoHundredDayAverage, fiftyDayAverageChangePercent, twoHundredDayAverageChangePercent, regularMarketChangePercent, fiftyTwoWeekHighChangePercent, regularMarketVolume, averageDailyVolume3Month, sector, industry, rsi14, twentyDayAverageChangePercent, oneHundredFiftyDayAverageChangePercent, shortPercentOfFloat, grossMargins, operatingMargins, profitMargins, returnOnEquity, returnOnAssets, debtToEquity, revenueGrowth, earningsGrowth, pegRatio, currentRatio, numberOfAnalystOpinions. Additional sort-only fields: valueScore, qScore, marginOfSafety, mlProbability. Margins/growth are decimals (0.25 = 25%); marketCap is raw USD (250M = 250000000). An unknown field is rejected with a suggestion (it would otherwise silently return zero matches). For per-field units and typical ranges, read the stoquant://screener-fields resource. Tip: a full-universe scan can be slow and time out — prefer universe='sp500' and a handful of filters, or use stoquant_run_prebuilt_screen.

Inputs: filters (required), limit, universe, sortField, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 49 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (e.g., quote vs. extended quote vs. sparklines), but the social suite is crowded: stoquant_get_social_trend, stoquant_get_social_sentiment, stoquant_get_trending_social, and stoquant_get_social_momentum overlap in domain and could be confused without careful reading of descriptions. Similarly, stoquant_get_catalysts and stoquant_get_catalyst_watch are different (per-ticker vs. market-wide) but the names are close.

    Naming Consistency4/5

    The naming convention is overwhelmingly consistent: a fixed 'stoquant_' prefix followed by a verb (get, run, list, explain) and a noun or noun phrase with underscores (e.g., stoquant_get_quote, stoquant_run_screener, stoquant_list_prebuilt_screens). Minor deviations include version suffixes (stoquant_get_signals_v2) and the use of 'explain' instead of 'get', but these are semantically appropriate and do not break the overall pattern.

    Tool Count2/5

    With 49 tools, the server is heavily overloaded. While the breadth of stock research, macro data, social sentiment, and alternative data can justify many endpoints, 49 exceeds the threshold where an agent can easily navigate or remember the full surface. The count feels like the server tries to expose every feature as a separate tool rather than consolidating related functionality (e.g., multiple social tools could be merged).

    Completeness5/5

    The tool set is remarkably comprehensive for a stock analysis/quant research domain. It covers quotes, technicals, fundamentals, ML predictions, analyst estimates/ratings, insider trading, institutional holders, SEC filings, social sentiment, macro indicators, catalysts, alternative data, and screening. There are no obvious dead ends—each workflow has supporting tools, and the availability of both breadth (dashboard, news_events) and depth (explain_ml_prediction, evidence) makes the surface feel complete.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
      12
      104
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
      5
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP server exposing Massive.com's REST Stocks API for querying stock market data via Claude Desktop/Code.
      31
      MIT