About stox-mcp
stox-mcp provides derived metrics and market context for US stocks to AI clients. It emphasizes cohort percentiles, curated peers, co-movement clusters, and market-stress indicators rather than raw market data.
Key features
- 0116 percentile scores across four panels
- 02Side-by-side comparison of 2–5 tickers
- 03Curated competitive peers
- 04Price co-movement clusters
- 05Metric-based stock screening
- 06Market-stress indicators and context
Use cases
- 01Assess a stock against its S&P 500 cohort
- 02Compare metrics across several tickers
- 03Find competitors or stocks moving together
- 04Screen for momentum or fallen leaders
- 05Review market stress alongside stock metrics
MCP support
The MCP server exposes stock fingerprints, comparisons, peer and theme analysis, metric screening, and market-regime context as tools for MCP clients. Its endpoint supports streamable HTTP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.stox.market/mcpclaude mcp add --transport http nirajagarwal-stox https://mcp.stox.market/mcp{"mcpServers":{"nirajagarwal-stox":{"type":"http","url":"https://mcp.stox.market/mcp"}}}Open in Cursor{"servers":{"nirajagarwal-stox":{"type":"http","url":"https://mcp.stox.market/mcp"}}}Open in VS Code{"mcpServers":{"nirajagarwal-stox":{"type":"http","url":"https://mcp.stox.market/mcp"}}}{"mcpServers":{"nirajagarwal-stox":{"serverUrl":"https://mcp.stox.market/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
6| Parameter | Type | Required | Description |
|---|---|---|---|
| as_of | string | No | RESERVED (phase 2): YYYY-MM-DD point-in-time snapshot; currently only the live snapshot is served |
| ticker | string | Yes | US ticker, e.g. NVDA |
Details
From the project READMEstox-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/mcp
Tools
| 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.