MCP 서버

stox-mcp

io.github.nirajagarwal/stox-mcp
데이터 및 분석 금융 및 투자 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

Analyzes US stocks using percentile fingerprints, competitive peers, statistical co-movement clusters, market-stress indicators, and metric screens.

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'}}}
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'}}}
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': {}}
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'}}}
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}}}
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'}}}
추가됨
market_regime
2026년 9월 17일 12:45 PM
추가됨
screen
2026년 9월 17일 12:45 PM
추가됨
theme_cluster
2026년 9월 17일 12:45 PM
추가됨
peers
2026년 9월 17일 12:45 PM
추가됨
compare
2026년 9월 17일 12:45 PM
추가됨
fingerprint
2026년 9월 17일 12:45 PM