pegcheck-mcp

一个只读的 MCP 服务器，用于检查 Robinhood Chain 股票代币 当前是否以相对于其代表的现实世界股票的公平价格进行交易——设计为 由 AI 代理 在交易前调用，而不是由人类从仪表盘读取。

✅ Verdict: FAIR (deviation: 0.11%)

问题

Robinhood Chain 的 股票代币 是可自行托管的 ERC-20 代币，跟踪真实股票并在链上 DEX 上 24/7 交易。真实股票市场每天仅开放约 6.5 小时，每周 5 天。在这些时间之外，没有活跃市场将代币价格套利回公允价值，因此价格可能会漂移。

直接在链上交易这些代币的 AI 代理——持有钱包密钥并针对 DEX 池进行交换——没有内置的方法来知道它即将支付的价格是否可信。每一个暴露这一差距的现有工具（仪表盘、Telegram 警报机器人、交易终端）都是为 人类 查看而构建的。它们都不是为 由代理 在决策过程中调用而构建的。

解决方案

一个专注的 MCP 工具：check_stock_token_price。

给它一个股票代码。它会返回一个结构化的、感知会话的裁决，代理可以在签署交易之前采取行动——无论该交易是通过 Robinhood 自己的 Trading MCP 还是直接针对链上 DEX 进行。

{
  "symbol": "AAPL",
  "onchain": { "priceUsd": 310.32, "method": "liquidity-weighted-average", "poolsUsed": 10 },
  "reference": { "tokenEquivalentPriceUsd": 309.99, "isTradingHalt": false },
  "deviation": { "pct": 0.11, "direction": "premium" },
  "marketSession": { "state": "weekend" },
  "verdict": "fair",
  "warnings": []
}

此服务器是 只读 的。它从不持有私钥，从不签署交易，也从不进行交易。

工作原理

两个独立的数据源，进行比较：

1. 链上价格 — 来自 DexScreener 的公共 API 的该代币的所有已索引 Robinhood Chain 池，过滤为以稳定参考资产（USDG/USDC）报价且流动性至少为 500 美元的池，合并为 流动性加权平均值（因此一个深度池会主导几个浅而嘈杂的池）。如果没有通过过滤器的池，则回退到单个最深的池——标记为低置信度。

2. 参考价格 — Robinhood 自己的公共 股票代币 API（/rhj/prices/{symbol}），报告原始基础股票的买/卖价。这通过代币当前的 ERC-8056 multiplier（来自 /rhj/assets）进行缩放，以获得代币等值的公平价格，因为股息被再投资到乘数中，而不是以现金支付。

两者之间的偏差与一个 取决于当前美国市场会话的阈值表 进行比较（regular、pre-market、after-hours、weekend、holiday、closed），在本地计算，无外部依赖——周六晚上的 2% 差距是预期的；周二上午 11 点的相同差距则不是。会话检测包括完整的 NYSE 假日日历，通过算法计算（每月第 n 个工作日的规则、耶稣受难日的复活节计算以及标准的周末顺延规则），而不是从任何外部 API 获取，因此适用于任何年份，无需网络依赖、无需 API 密钥、也没有会过时的静态文件。已在 test/nyseHolidays.test.ts 中针对 NYSE 官方发布的 2026-2028 日历进行了验证。有关确切阈值，请参阅 src/config.ts，有关假日规则，请参阅 src/nyseHolidays.ts。

安装与运行

git clone https://github.com/kushal613/pegcheck-mcp.git
cd pegcheck-mcp
npm install
npm run build

无需 API 密钥，无需 .env 文件，无需钱包——使用的每个数据源都是免费、公共、无密钥的 API。

从终端尝试

npm run check -- AAPL
npm run check -- TSLA

连接到 MCP 客户端

Claude Desktop / Claude Code（claude_desktop_config.json 或 .mcp.json）：

{
  "mcpServers": {
    "pegcheck": {
      "command": "node",
      "args": ["/absolute/path/to/pegcheck-mcp/dist/index.js"]
    }
  }
}

Cursor（.cursor/mcp.json）：与上述形状相同。

连接后，告诉你的代理：“在购买任何 TSLA 股票代币之前，检查 pegcheck 以查看当前价格是否公平。”

工具参考

check_stock_token_price

架构

src/
  config.ts        Every tunable threshold, in one place
  types.ts         Shared types for the whole pipeline
  http.ts          Fetch wrapper with timeout + consistent errors
  robinhoodApi.ts  Reference leg: /rhj/assets + /rhj/prices (Robinhood's own APIs)
  dexscreener.ts   Onchain leg: liquidity-weighted price across Robinhood Chain pools
  marketSession.ts Local US-market-session calculation (no external dependency)
  nyseHolidays.ts  Algorithmic NYSE holiday calendar (no external dependency)
  pegCheck.ts       Combines both legs into one PegCheckResult
  server.ts        MCP tool registration
  index.ts         stdio entrypoint
  cli.ts           Standalone terminal usage (no MCP client needed)
scripts/
  smoke-test.mjs   End-to-end MCP protocol handshake test (initialize -> tools/list -> tools/call)

已知限制（v0.1）

• 无提前收盘处理。 NYSE 的下午 1:00 收盘（感恩节次日、工作日圣诞前夜）未被建模为独立会话——这些下午仍会在实际提前收盘几小时后报告 after-hours/closed。全天假日休市已完全覆盖。

• 无特定场所的滑点估算。 这报告的是聚合流动性加权价格，而不是“我的 500 美元交易针对 这个特定 池的成本”。这是 v0.1 的刻意范围边界（自然的 v0.2：一个 advanced 模式，接受交易规模和特定池/场所，并估算价格影响）。

• DexScreener 覆盖依赖。 如果 DexScreener 尚未索引一个非常新的池，onchain.method 将为 "none"，裁决将为 no_liquidity。这是“大声失败”，而不是静默的错误答案。

• 不能替代尽职调查。 请参阅下面的免责声明。

免责声明

本项目 与 Robinhood 无关联，也未获得其认可。它是一个独立的、信息性的工具。数据来源于 Robinhood 的公共 API 和 DexScreener 的公共 API，可能延迟、不完整或不准确。此处内容不构成财务建议。此服务器无法进行交易，也不持有资金或密钥。

许可证

MIT — 参见 LICENSE。