Stox Mcp

io.github.nirajagarwal由 GitHub 帳號 nirajagarwal 發布v0.2.2更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器,為助理提供美股以百分位為基礎的個股輪廓、同業比較、主題分群與市場壓力背景資訊。

可以做什麼
取得單一股票的精簡輪廓:16 項百分位評分、綜合評分、精選同業與一句話解讀,每次呼叫約 550 個 token(fingerprint)。將 2 至 5 檔股票以評分矩陣並排比較(compare)。查詢股票真正的競爭同業,依業務區隔重疊而非產業分類精選(peers)。查看股票實際跟隨交易的統計主題,包括分群名稱、凝聚度、產業組成與成員代號(theme_cluster)。在標普 500 與納斯達克 100 範圍內依 16 項指標中的任一項設定上下限篩選,可限定單一產業(screen)。查看目前市場壓力:各指標區間、VIX 五年百分位與壓力確認標記(market_regime)。
適用情境
適合助理需要快速、可橫向比較的美股背景資訊,而非原始行情或財報資料時:評估某檔股票、權衡幾個候選標的、尋找真正競爭對手,或在討論股票前了解整體市場壓力。
執行需求
遠端 streamable HTTP 端點;未宣告本機執行環境、套件、帳號、API 金鑰或請求標頭。需要能連線至該端點的網路。
安裝前請注意
僅供參考:伺服器聲明只提供描述性統計,不構成投資建議,也不提供買賣推薦,且並非行情資料來源。評分為衍生指標並附有快照日期,應視為背景資訊而非權威資料。不要求任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Stox Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.nirajagarwal%2Fstox-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "stox": {
      "type": "http",
      "url": "https://mcp.stox.market/mcp"
    }
  }
}

README

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

bash
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.

來源:README.md,提交 93bf456

工具

6

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.

輸入參數as_ofticker必填

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.

輸入參數tickers必填

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.

輸入參數ticker必填

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.

輸入參數ticker必填

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).

輸入參數nsectorfilterssort_bymin_profitmin_performmin_persistmin_pressure

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.

無需輸入參數。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。