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 分

    请在仓库或注册中心条目中声明许可证。