io.github.nirajagarwal/stox-mcp
Percentile fingerprints, curated peers, theme clusters & market-stress context for US stocks.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http stox-mcp 'https://mcp.stox.market/mcp'{
"mcpServers": {
"stox-mcp": {
"type": "http",
"url": "https://mcp.stox.market/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
stox-mcp
Give your AI the numbers that matter. An MCP server over the stox.market metric layer — context, not data: every finance feed hands a model raw bars and statements, and the model still can't answer "is this number good?". This server ships the judgment layer instead.
Live endpoint: https://mcp.stox.market/mcp (streamable HTTP) ·
Demo & docs: stox.market/mcp
claude mcp add --transport http stox https://mcp.stox.market/mcpTools
| tool | what it answers |
|---|---|
fingerprint | The character of one stock: 16 percentile scores vs the S&P 500 cohort across four panels (Market Beat, Trend Persistence, Business Growth, Pressure), the P3 composite, curated peers, a one-line read. ~550 tokens. |
compare | The 16-score matrix for 2–5 tickers, side by side. |
peers | TRUE competitive peers — curated from segment overlap, not GICS (Costco → WMT/TGT/KR, not "Discount Stores"). |
theme_cluster | Who a stock moves with: co-movement clusters from price behavior (market-removed residuals → random-matrix cleaning → Ward linkage). |
screen | Min/max bounds on any of the 16 metrics — momentum and fallen-leader queries in one call — optionally per sector, sorted by the P3 composite or any single metric. |
market_regime | Market-stress stance, per-indicator bands, the VIX 5-yr percentile (the one input validated as predicting forward risk), and the S2 stress-confirmation badge. |
Design
- Token economy — compact JSON, score + band + a one-line read; a fingerprint is ~550 tokens where a statements dump is 20,000.
- Percentiles, not raw numbers — every score is a cross-sectional rank against the real cohort (100 = best), so "is it good?" is answered by construction.
- Provenance — snapshot dates on scores, links back to the full picture.
- Informational only — descriptive statistics; never investment advice, no buy/sell recommendations. Derived metrics only; this is not a market-data feed.
The human-readable twin
The same metric layer renders as editorial leaderboards at
stox.market/lists — 31 boards plus sector
slices and frozen earnings-season editions, refreshed on automated weekly
lanes. A board is where a name catches your eye; fingerprint is how your
agent vets it in one call.
Universe: S&P 500 + NASDAQ-100 + curated ETFs. Coverage and metric definitions: stox.market.
Frequently asked questions
What is io.github.nirajagarwal/stox-mcp?
Percentile fingerprints, curated peers, theme clusters & market-stress context for US stocks.
How do I install io.github.nirajagarwal/stox-mcp?
It runs as a remote server. In Claude Code: claude mcp add --transport http stox-mcp 'https://mcp.stox.market/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.nirajagarwal/stox-mcp need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.nirajagarwal/stox-mcp open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.nirajagarwal/stox-mcp?
It is published by nirajagarwal. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.