stoquant-mcp
This MCP server gives Claude and other agents read-only access to StoQuant's quant research platform: stock quotes, AI/ML predictions, screening, ownership, macro data, and more — with no order placement or portfolio mutation.
Get real-time/delayed quotes, batch quotes, technical indicators, sparkline price history, benchmarks, and sector leaders/laggards.
Analyze individual stocks: Q-Score (0–100 quality composite), stage-adjusted signals, ML S&P 500 outperformance probability, ML explanations, competitive edges, quant analytics, and bull/bear evidence.
Read market context: market regime, signal hit-rates, platform accuracy scorecard, macro dashboard/indicators/calendar/themes.
Discover ideas: top-conviction picks, hidden gems, multibagger candidates, related/peer stocks, social trending/momentum, catalyst watch, and big insider buys.
Screen stocks: list/run prebuilt screens or build custom fundamental/technical screens over SP500, Russell 2000, or full universe.
Research ownership and sentiment: insider trades/clusters, institutional holders/ratings, analyst estimates/price targets/changes, short interest.
Monitor news and filings: SEC filings, news headlines, combined news/filings/earnings events.
Leverage alternative data: 15-source alt-signal dossier (FDA, CPSC, SEC, clinical trials, GitHub, App Store, Hacker News, news tone), Google Trends, Wikipedia pageviews, options IV.
Track unusual options flow and catalysts.
Evaluate portfolio/backtest/strategy performance: auto-portfolio status/history, portfolio health/optimization, backtest templates/runs, strategy presets and performance.
Use built-in prompts and resources for guided workflows like ticker deep-dives, opportunity finding, market briefings, and reference docs on methodology and screener fields.
Provides access to App Store alternative data such as ratings, reviews, and other metrics via the get_alt_signals tool.
Provides access to GitHub alternative data, including repository activity and other metrics, via the get_alt_signals tool.
Provides access to Google Trends data via the get_alt_data tool.
Provides access to Wikipedia page view statistics via the get_alt_data tool.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@stoquant-mcp Show me top conviction picks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
stoquant-mcp
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 installYou'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.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Related MCP server: Financial Modeling Prep MCP Server
Tools (61)
Category | Tools |
Prices |
|
Research |
|
Signals |
|
Discovery |
|
Screener |
|
Ownership |
|
Filings & News |
|
Social |
|
Catalysts |
|
Alt-data |
|
Options flow |
|
Portfolio |
|
Backtest |
|
Strategy |
|
Macro |
|
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
Authorizationheader. 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 |
| — (required) | Your StoQuant API key (free or Power tier) |
|
| API base URL |
|
| Client-side rate limit (req/min) |
|
| Per-request timeout |
|
| Set |
License
MIT
Available Tools
49 toolsstoquant_explain_ml_predictionExplain ML predictionARead-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 summaryARead-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)ARead-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 signalsARead-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/downgradesARead-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 estimatesARead-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 targetsARead-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 benchmarksARead-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)ARead-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 catalystsARead-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)ARead-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)ARead-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 technicalsARead-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_insider_clusterGet insider cluster metricsARead-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 tradesARead-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 holdersARead-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 sentimentARead-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 calendarARead-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 dashboardARead-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)ARead-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 themesARead-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 regimeARead-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 predictionARead-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 candidatesARead-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 headlinesARead-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 & earningsARead-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-ScoreARead-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 analyticsARead-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 quoteARead-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)ARead-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 filingsARead-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/laggardsARead-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 interestARead-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-ratesARead-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 heatmapARead-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 signalsARead-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 surgesARead-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 sentimentARead-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 trendARead-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 credibilityARead-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)ARead-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 intelligenceARead-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 picksARead-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_get_trending_socialGet trending tickers (social)ARead-only
Most-mentioned tickers across social platforms in the last few hours, each with mentionCount, prevMentionCount, deltaPercent, velocityScore, bullishPct, and platforms. Use for market-wide 'what is retail talking about right now' discovery and early momentum.
Inputs: no named parameters.
stoquant_list_prebuilt_screensList prebuilt screensARead-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 screenARead-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 screenARead-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
Scored across 49 tools
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.
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.
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).
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
Related MCP Connectors
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.12104MIT
- AlicenseNot gradedqualityNot gradedmaintenanceA 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.5MIT
- AlicenseBqualityCmaintenanceMCP server exposing Massive.com's REST Stocks API for querying stock market data via Claude Desktop/Code.31MIT
- FlicenseNot gradedqualityCmaintenanceModel Context Protocol (MCP) server for E*TRADE API, enabling LLMs like Claude to retrieve stock and options market data.-