protogrid

Search / io.github.nirajagarwal/stox-mcp

stox-mcp

R0· no sign-in

Percentile fingerprints, curated peers, theme clusters & market-stress context for US stocks.

v0.2.2 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality85good
Trust91of 100
Uptime, 30 days100%
Latency p50244 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "stox-mcp": {
      "type": "http",
      "url": "https://mcp.stox.market/mcp"
    }
  }
}
claude mcp add --transport http stox-mcp https://mcp.stox.market/mcp
[mcp_servers.stox-mcp]
url = "https://mcp.stox.market/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stox-mcp": {
      "type": "remote",
      "url": "https://mcp.stox.market/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "stox-mcp": {
      "type": "http",
      "url": "https://mcp.stox.market/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=stox-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnN0b3gubWFya2V0L21jcCJ9"
}
{
  "servers": {
    "stox-mcp": {
      "type": "http",
      "url": "https://mcp.stox.market/mcp"
    }
  }
}
{
  "mcpServers": {
    "stox-mcp": {
      "httpUrl": "https://mcp.stox.market/mcp"
    }
  }
}
extensions:
  "stox-mcp":
    enabled: true
    name: "stox-mcp"
    type: streamable_http
    uri: "https://mcp.stox.market/mcp"
    timeout: 300

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations6 of 6 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: fingerprint (idempotentHint); compare (idempotentHint); peers (idempotentHint); …
  • pass
    tools.token_costabout 1,149 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

6 tools, about 1,149 tokens to load them all · tool set eeaea31c0eb0 · checked 2026-10-20 10:03 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80
liveness100
freshness85
hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% ~updated-51d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.stox.market/mcp streamable-httpnoneyes100%244 ms2025-11-252026-10-20

Tools (6)

compareread-onlyThe 16 percentile scores + P3 + 1Y price change for 2-5 tickers as one compact matrix (rows = metrics, columns = tickers). Use when weighing names against each other; percentiles make the comparison fair across sectors and sizes.
fingerprintread-onlyThe character of one stock in ~550 tokens: 16 percentile scores (vs the S&P 500 cohort) across four panels — Market Beat, Trend Persistence, Business Growth, Pressure (money flow) — plus the composite P3 score (the validated 3-factor form), curated competitive peers (not GICS), a one-line character read, and the price line. Use for 'is this number good?' and quick company character.
market_regimeread-onlyWhere market stress sits right now: the dashboard's 8-indicator stance, each indicator's traffic-light band, the VIX 5-year percentile (the ONE input validated as predicting forward risk — blended composites tested worse), and the S2 stress-confirmation badge (SPY below its 40-week average AND VIX above its 80th percentile of the trailing year). Descriptive context, not a market call.
peersread-onlyThe stock's TRUE competitive cluster — LLM-curated from segment overlap (who it actually competes with for revenue), not GICS classification. Costco's peers are WMT/TGT/KR, not 'Discount Stores'. Each peer carries its P3 score. Honest empty list for monopolies/private-rival cases.
screenread-onlyScreen the S&P 500 + NDX universe on ANY of the 16 percentile scores, with minimum AND maximum bounds, optionally within one GICS sector, sorted by the validated P3 composite or by any single metric. Metric keys: marketBeat1Y/1M/1W/1D (price vs SPY), rankPersistence52W/26W/13W + trendPersistence (rank stability), businessBeat + revGrowthYoy + marginGrowthYoy + fcfGrowthYoy (business growth), accumDistFlow/30/5/2 (money flow 60/30/5/2-day). Examples: momentum — {sort_by:'marketBeat1M', filters:[{metric:'businessBeat', min:70}]}; fallen leaders — {filters:[{metric:'rankPersistence52W', min:80},{metric:'marketBeat1Y', max:40}]}. Legacy min_perform/min_persist/min_profit/min_pressure still work (the four headline scores).
theme_clusterread-onlyThe statistical theme a stock actually trades with: clusters built from years of price co-movement (market-removed residuals → random-matrix cleaning → Ward linkage), not sector labels. Returns the cluster's name, description, cohesion, sector mix and up to 20 member tickers. Different question from `peers` (business competition) — this is who it MOVES with.

Schemas: list_tools.

Similar MCP servers

More from io.github.nirajagarwal

Official server.json
{
  "name": "io.github.nirajagarwal/stox-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.stox.market/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.2.2",
  "repository": {
    "url": "https://github.com/nirajagarwal/stox-mcp",
    "source": "github"
  },
  "description": "Percentile fingerprints, curated peers, theme clusters & market-stress context for US stocks."
}