stox.market MCP
An MCP server providing percentile fingerprints, curated peers, theme clusters, and market-stress context for US stocks. It offers tools to analyze stock character, compare tickers, identify competitive peers, screen by metrics, and assess market regime, delivering judgment layer context rather than raw data.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.stox.market/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Analyze the character of a single stock using 16 percentile scores vs the S&P 500 cohort
- Compare 2-5 tickers side by side using a 16-score matrix
- Identify true competitive peers based on segment overlap rather than GICS
- Screen stocks using min/max bounds on metrics for momentum or fallen-leader queries
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- stox 0.2.2
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
fingerprint — Stock percentile fingerprint
The 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ticker"
],
"properties": {
"as_of": {
"type": "string",
"description": "RESERVED (phase 2): YYYY-MM-DD point-in-time snapshot; currently only the live snapshot is served"
},
"ticker": {
"type": "string",
"description": "US ticker, e.g. NVDA"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}compare — Compare fingerprints side by side
The 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tickers"
],
"properties": {
"tickers": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"description": "2-5 US tickers"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}peers — Curated competitive peers
The 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}theme_cluster — Co-movement theme cluster
The 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}screen — Metric screen (P3-sorted, min/max on all 16 scores)
Screen 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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"n": {
"type": "number",
"maximum": 25,
"minimum": 1,
"description": "max results (default 12)"
},
"sector": {
"type": "string",
"description": "GICS sector filter, e.g. 'Energy'"
},
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"metric"
],
"properties": {
"max": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"metric": {
"type": "string",
"description": "one of the 16 metric keys"
}
}
},
"description": "bounds on any metrics; entries AND together"
},
"sort_by": {
"type": "string",
"description": "'p3' (default) or any metric key; descending"
},
"min_profit": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min_perform": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min_persist": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min_pressure": {
"type": "number",
"maximum": 100,
"minimum": 0
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}market_regime — Market stress context
Where 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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 2 of 2 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 331 ms
- 95th percentile latency
- 331 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 331 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http stox-market-mcp https://mcp.stox.market/mcpCodex
codex mcp add stox-market-mcp --url https://mcp.stox.market/mcpCursor
{
"mcpServers": {
"stox-market-mcp": {
"url": "https://mcp.stox.market/mcp"
}
}
}Cline
{
"mcpServers": {
"stox-market-mcp": {
"type": "streamableHttp",
"url": "https://mcp.stox.market/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"stox-market-mcp": {
"type": "http",
"url": "https://mcp.stox.market/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http stox-market-mcp https://mcp.stox.market/mcpClaude Desktop
https://mcp.stox.market/mcpWindsurf
{
"mcpServers": {
"stox-market-mcp": {
"serverUrl": "https://mcp.stox.market/mcp"
}
}
}Let your agent find its tools
Find servers like stox.market MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.