# TraderMatrix Free Gapper Scanner

> Free, keyless pre-market and after-hours low-float gapper scanner from TraderMatrix.

- name: pro.tradermatrix/free
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 70/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/pro.tradermatrix%2Ffree
- tools: https://api.protogrid.dev/v1/servers/pro.tradermatrix%2Ffree/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "free": {
      "type": "http",
      "url": "https://api.tradermatrix.pro/api/mcp/free"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-8d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 70/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_market_health_history (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_premarket_gappers (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_market_valuation (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,289 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 7 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,289 tokens to load them all
- tool set hash: d511748d86917a6e052adb0dec675840
- tools last changed: 2026-10-20T06:05:10.540Z
- badge: [![protogrid quality](https://protogrid.dev/badge/pro.tradermatrix/free.svg)](https://protogrid.dev/servers/pro.tradermatrix/free)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-20 `get_market_breadth` added
  - S&P 500 breadth, derived aggregates only: the percent of index members above their 20-, 50- and 200-day moving averages (0-100), a breadth zone for the 50- and 200-day readings (washed_out / weak / mixed / healthy / extended), advancers and decliners, new 52-week highs and lows with the net count, the member count, and a one-sentence read. The index level and its change are not published. stale is true when the live read failed and the last stored close is served. Self-caching. No parameters.
- 2026-10-20 `get_cross_asset_regime` added
  - Cross-asset regime read, derived values only: 60-session stock-bond and dollar-stock return correlations (-1..1), 20-session percent changes of the gold/S&P ratio, copper/gold ratio and WTI crude, the VIX/VIX3M ratio with a contango / backwardation word (above 1.0 = backwardation), and the MOVE/VIX ratio (rate vol vs equity vol). Raw index and commodity levels are not published; a leg that cannot be computed is null and named in unavailable[]. Self-caching (15 min). No parameters.
- 2026-10-20 `get_macro_liquidity` added
  - US-government macro and liquidity series: Fed net liquidity (balance sheet minus Treasury General Account minus reverse repo, USD trillions, weekly, with the 4-week percent change), 10-year real yield, 10-year breakeven inflation, 5y5y forward inflation and the effective fed funds rate (percent, each with its prior value and date), the Treasury yield curve (1M-30Y) with the 10Y-2Y spread history (percentage points, negative = inverted), private nonresidential fixed investment (CAPEX, USD billions SAAR) and CFTC E-mini S&P 500 positioning by trader class (net contracts). Federal Reserve, NY Fed, Treasury, BEA, CFTC and Chicago Fed sources only; third-party-licensed credit-spread series are not included. Self-caching (6 h). No parameters.
- 2026-10-20 `get_market_valuation` added
  - S&P 500 valuation verdict from a discounted-earnings (equity-risk-premium) model: verdict (Very cheap / Cheap / Fair value / Rich / Very rich), the equity risk premium the market currently implies (impliedErpPct, in percent — lower means richer), the zone on the ladder, how far the market sits above (+) or below (-) the Fair value band in percent, and five ERP bands each with its erpPct, its fair value relative to the Fair value band, and the market's percent distance from it. All values are percentages; index-point fair values, the index level and the earnings inputs are intentionally not published. A model, not a forecast. Self-caching (30 min). No parameters.
- 2026-10-20 `get_market_health_history` added
  - Market Health history: the composite risk-score snapshots for the last 30 days (hourly, with flips7d = label changes in the last 7 days), a ~30-session derived line series per detector (percent vs moving average, ratios vs their MAs, N-day percent changes and spreads — never raw prices), and signalChanges: which scored detectors changed status since the previous trading day's last snapshot. Every line carries a unit string. The junk-credit-spread detector has no lines (its source series is third-party licensed) and economic-calendar events are not included. Self-caching (15 min). No parameters.
- 2026-10-20 `get_premarket_gappers` changed (description)
  - before: Gapper Scanner (FREE preview) — 5-pillar low-float momentum gap scan (gap >=10%, price $1-$100, float <=100M, premarket volume >=50k; relative volume ranks the board and news is flagged; independent implementation, defaults differ from any educator's published criteria). Finds cheap small-cap stocks gapping up hard, flagging which have a news catalyst. This free, no-key endpoint auto-picks the live session — pre-market gappers during 04:00-09:30 ET, after-hours gainers during 16:00-20:00 ET — and returns the top 10 on the default filters (up >=10% vs the session's reference close, price $1-$100, float <=100M shares, extended-hours volume >=50k). Each gapper: symbol, name, sector, last (extended-hours price), changePct (TRUE gap vs the reference close), atr, rvol (DERIVED premarket relative volume = premarketVolume / avgVolume, i.e. what fraction of a normal FULL day's volume has already traded — NOT TradingView's regular-session relative volume, which is meaningless before the bell), premarketVolume (extended-hours volume), avgVolume, float, rsi, and hasNews (a boolean catalyst flag — headline text and article links are not served here). Ranked by cleared pillars first, then premarket relative volume descending. The result echoes 'session'. Want to force a session, tune the filters, pull up to 50 names, and unlock 24 more tools (live options flow, GEX magnet levels, unusual activity, wheel screeners)? Get a TraderMatrix API key — see the '_upgrade' field.
  - after: Gapper Scanner (FREE preview) — 5-pillar low-float momentum gap scan (gap >=10%, price $1-$100, float <=100M, premarket volume >=50k; relative volume ranks the board and news is flagged; independent implementation, defaults differ from any educator's published criteria). Finds cheap small-cap stocks gapping up hard, flagging which have a news catalyst. This free, no-key endpoint auto-picks the live session — pre-market gappers during 04:00-09:30 ET, after-hours gainers during 16:00-20:00 ET — and returns the top 10 on the default filters (up >=10% vs the session's reference close, price $1-$100, float <=100M shares, extended-hours volume >=50k). Each gapper: symbol, name, sector, last (extended-hours price), changePct (TRUE gap vs the reference close), atr, rvol (DERIVED premarket relative volume = premarketVolume / avgVolume, i.e. what fraction of a normal FULL day's volume has already traded — NOT TradingView's regular-session relative volume, which is meaningless before the bell), premarketVolume (extended-hours volume), avgVolume, float, rsi, and hasNews (a boolean catalyst flag — headline text and article links are not served here). Ranked by cleared pillars first, then premarket relative volume descending. The result echoes 'session'. Want to force a session, tune the filters, pull up to 50 names, and unlock the full 51-tool connector (live options flow, GEX magnet levels, unusual activity, wheel screeners)? Get a TraderMatrix API key — see the '_upgrade' field.
- 2026-10-15 `get_premarket_gappers` changed (description)
  - before: Gapper Scanner (FREE preview) — the Warrior Trading "5 pillars" low-float momentum screen. Finds cheap small-cap stocks gapping up hard on high relative volume with a news catalyst. This free, no-key endpoint auto-picks the live session — pre-market gappers during 04:00-09:30 ET, after-hours gainers during 16:00-20:00 ET — and returns the top 10 on the default filters (up >=10% vs the session's reference close, price $1-$100, float <=100M shares, extended-hours volume >=50k). Each gapper: symbol, name, sector, last (extended-hours price), changePct (TRUE gap vs the reference close), atr, rvol (DERIVED premarket relative volume = premarketVolume / avgVolume, i.e. what fraction of a normal FULL day's volume has already traded — NOT TradingView's regular-session relative volume, which is meaningless before the bell), premarketVolume (extended-hours volume), avgVolume, float, rsi, and hasNews (a boolean catalyst flag — headline text and article links are not served here). Ranked by extended-hours volume. The result echoes 'session'. Want to force a session, tune the filters, pull up to 50 names, and unlock 24 more tools (live options flow, GEX magnet levels, unusual activity, wheel screeners)? Get a TraderMatrix API key — see the '_upgrade' field.
  - after: Gapper Scanner (FREE preview) — 5-pillar low-float momentum gap scan (gap >=10%, price $1-$100, float <=100M, premarket volume >=50k; relative volume ranks the board and news is flagged; independent implementation, defaults differ from any educator's published criteria). Finds cheap small-cap stocks gapping up hard, flagging which have a news catalyst. This free, no-key endpoint auto-picks the live session — pre-market gappers during 04:00-09:30 ET, after-hours gainers during 16:00-20:00 ET — and returns the top 10 on the default filters (up >=10% vs the session's reference close, price $1-$100, float <=100M shares, extended-hours volume >=50k). Each gapper: symbol, name, sector, last (extended-hours price), changePct (TRUE gap vs the reference close), atr, rvol (DERIVED premarket relative volume = premarketVolume / avgVolume, i.e. what fraction of a normal FULL day's volume has already traded — NOT TradingView's regular-session relative volume, which is meaningless before the bell), premarketVolume (extended-hours volume), avgVolume, float, rsi, and hasNews (a boolean catalyst flag — headline text and article links are not served here). Ranked by cleared pillars first, then premarket relative volume descending. The result echoes 'session'. Want to force a session, tune the filters, pull up to 50 names, and unlock 24 more tools (live options flow, GEX magnet levels, unusual activity, wheel screeners)? Get a TraderMatrix API key — see the '_upgrade' field.

Full history: https://api.protogrid.dev/v1/servers/pro.tradermatrix%2Ffree/changes

## Remotes

- https://api.tradermatrix.pro/api/mcp/free (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `get_cross_asset_regime`: Cross-asset regime read, derived values only: 60-session stock-bond and
dollar-stock return correlations (-1..1), 20-session percent changes of the
gold/S&P ratio, copper/gold ratio and WTI crude, the VIX/VIX3M ratio with a
contango / backwardation word (above 1.0 = backwardation), and the MOVE/VIX ratio
(rate vol vs equity vol). Raw index and commodity levels are not published; a leg
that cannot be computed is null and named in unavailable[]. Self-caching
(15 min). No parameters.
- `get_macro_liquidity`: US-government macro and liquidity series: Fed net liquidity (balance sheet
minus Treasury General Account minus reverse repo, USD trillions, weekly, with the
4-week percent change), 10-year real yield, 10-year breakeven inflation, 5y5y
forward inflation and the effective fed funds rate (percent, each with its prior
value and date), the Treasury yield curve (1M-30Y) with the 10Y-2Y spread history
(percentage points, negative = inverted), private nonresidential fixed investment
(CAPEX, USD billions SAAR) and CFTC E-mini S&P 500 positioning by trader class
(net contracts). Federal Reserve, NY Fed, Treasury, BEA, CFTC and Chicago Fed
sources only; third-party-licensed credit-spread series are not included.
Self-caching (6 h). No parameters.
- `get_market_breadth`: S&P 500 breadth, derived aggregates only: the percent of index members above
their 20-, 50- and 200-day moving averages (0-100), a breadth zone for the 50- and
200-day readings (washed_out / weak / mixed / healthy / extended), advancers and
decliners, new 52-week highs and lows with the net count, the member count, and a
one-sentence read. The index level and its change are not published. stale is true
when the live read failed and the last stored close is served. Self-caching.
No parameters.
- `get_market_health_history`: Market Health history: the composite risk-score snapshots for the last 30
days (hourly, with flips7d = label changes in the last 7 days), a ~30-session
derived line series per detector (percent vs moving average, ratios vs their
MAs, N-day percent changes and spreads — never raw prices), and signalChanges:
which scored detectors changed status since the previous trading day's last
snapshot. Every line carries a unit string. The junk-credit-spread detector has
no lines (its source series is third-party licensed) and economic-calendar events
are not included. Self-caching (15 min). No parameters.
- `get_market_valuation`: S&P 500 valuation verdict from a discounted-earnings (equity-risk-premium)
model: verdict (Very cheap / Cheap / Fair value / Rich / Very rich), the equity
risk premium the market currently implies (impliedErpPct, in percent — lower
means richer), the zone on the ladder, how far the market sits above (+) or below
(-) the Fair value band in percent, and five ERP bands each with its erpPct, its
fair value relative to the Fair value band, and the market's percent distance
from it. All values are percentages; index-point fair values, the index level and
the earnings inputs are intentionally not published. A model, not a forecast.
Self-caching (30 min). No parameters.
- `get_premarket_gappers`: Gapper Scanner (FREE preview) — 5-pillar low-float momentum gap scan
(gap >=10%, price $1-$100, float <=100M, premarket volume >=50k; relative volume ranks the board and news is flagged; independent implementation, defaults differ from any educator's published
criteria). Finds cheap small-cap stocks gapping up hard, flagging which have a
news catalyst.

This free, no-key endpoint auto-picks the live session — pre-market gappers
during 04:00-09:30 ET, after-hours gainers during 16:00-20:00 ET — and returns
the top 10 on the default filters (up >=10% vs the session's
reference close, price $1-$100, float <=100M shares, extended-hours volume >=50k).

Each gapper: symbol, name, sector, last (extended-hours price), changePct (TRUE
gap vs the reference close), atr, rvol (DERIVED premarket relative volume =
premarketVolume / avgVolume, i.e. what fraction of a normal FULL day's volume has
already traded — NOT TradingView's regular-session relative volume, which is
meaningless before the bell), premarketVolume (extended-hours volume), avgVolume,
float, rsi, and hasNews (a boolean catalyst flag — headline text and article
links are not served here). Ranked by cleared pillars first, then premarket relative volume descending. The result echoes
'session'.

Want to force a session, tune the filters, pull up to 50 names, and unlock the
full 51-tool connector (live options flow, GEX magnet levels, unusual activity,
wheel screeners)? Get a TraderMatrix API key — see the '_upgrade' field.