English Français العربية

io.github.nirajagarwal/stox-mcp

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http stox-mcp 'https://mcp.stox.market/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "stox-mcp": {
            "type": "http",
            "url": "https://mcp.stox.market/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. stox-mcp
  2. Tools
  3. Design
  4. The human-readable twin

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/mcp

Tools

toolwhat it answers
fingerprintThe 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.
compareThe 16-score matrix for 2–5 tickers, side by side.
peersTRUE competitive peers — curated from segment overlap, not GICS (Costco → WMT/TGT/KR, not "Discount Stores").
theme_clusterWho a stock moves with: co-movement clusters from price behavior (market-removed residuals → random-matrix cleaning → Ward linkage).
screenMin/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_regimeMarket-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.

الأسئلة الشائعة

ما هو io.github.nirajagarwal/stox-mcp؟

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

كيف أثبّت io.github.nirajagarwal/stox-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http stox-mcp 'https://mcp.stox.market/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.nirajagarwal/stox-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.nirajagarwal/stox-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.nirajagarwal/stox-mcp؟

ينشره nirajagarwal. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.