pegcheck-mcp

読み取り専用のMCPサーバーで、Robinhood Chain Stock Tokenが、それが表す現実の株式と比較して現在公正な価格で取引されているかをチェックします。これは、人間がダッシュボードで読むためではなく、AIエージェントが取引する直前に呼び出されるように設計されています。

✅ Verdict: FAIR (deviation: 0.11%)

問題

Robinhood ChainのStock Tokensは、実際の株式に連動する自己管理可能なERC-20であり、オンチェーンDEXで24時間365日取引されています。実際の株式市場は、1日約6.5時間、週5日しか開いていません。その時間外には、トークン価格を公正価値に戻すための活発な市場が存在しないため、価格が乖離する可能性があります。

これらのトークンをオンチェーンで直接取引するAIエージェント（ウォレットキーを保持し、DEXプールとスワップする）には、支払おうとしている価格が信頼できるかどうかを知る組み込みの方法がありません。このギャップを表面化する既存のツール（ダッシュボード、Telegramアラートボット、取引端末）はすべて、人間が見るために作られています。そのどれもが、意思決定の途中でエージェントによって呼び出されるようには作られていません。

解決策

1つの焦点を絞った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": []
}

このサーバーは読み取り専用です。秘密鍵を保持することも、トランザクションに署名することも、取引を行うこともありません。

仕組み

比較される2つの独立したデータソース：

1. オンチェーン価格 — トークンのインデックス化されたすべてのRobinhood ChainプールをDexScreenerの公開APIから取得し、安定した参照資産（USDG/USDC）で見積もられ、流動性が少なくとも$500あるプールにフィルタリングし、流動性加重平均にまとめます（そのため、1つの深いプールが、いくつかの浅くノイズの多いプールを支配します）。フィルタを通過するものがない場合は、単一の最も深いプール（低信頼性としてフラグ付け）にフォールバックします。

2. 参照価格 — Robinhood自身の公開Stock Token API（/rhj/prices/{symbol}）で、原資産の生のビッド/アスクを報告します。これは、トークンの現在のERC-8056 multiplier（/rhj/assetsから）でスケーリングされ、トークン相当の公正価格を取得します。配当は現金で支払われるのではなく、マルチプライヤーに再投資されるためです。

2つの間の乖離は、現在の米国市場セッションに依存するしきい値テーブル（regular、pre-market、after-hours、weekend、holiday、closed）と比較されます。これは外部依存なしでローカルに計算されます。土曜の夜の2%のギャップは予想されますが、火曜日の午前11時の同じギャップは予想されません。セッション検出には完全なNYSE祝日カレンダーが含まれており、外部APIから取得するのではなく、アルゴリズムで計算されます（月の第n曜日のルール、聖金曜日のためのイースター計算、標準的な週末の振替ルール）。そのため、ネットワーク依存、APIキー、古くなる静的ファイルなしで、任意の年に機能します。NYSEが公式に公開した2026〜2028年のカレンダーに対してtest/nyseHolidays.test.tsで検証されています。正確なしきい値は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時の終了（感謝祭の翌日、平日のクリスマスイブ）は、別のセッションとしてモデル化されていません。そのような午後は、実際の早期終了より数時間遅れてafter-hours/closedと報告されます。終日休場は完全にカバーされています。

• 特定の取引所に対するスリッページ見積もりなし。 これは、集計された流動性加重価格を報告するものであり、「私の500ドルの取引がこの特定のプールに対してどれだけのコストになるか」ではありません。これは意図的なv0.1のスコープ境界です（自然なv0.2：取引サイズと特定のプール/取引所を受け取り、価格影響を見積もるadvancedモード）。

• DexScreenerのカバレッジ依存。 DexScreenerが非常に新しいプールをまだインデックスしていない場合、onchain.methodは"none"になり、判定はno_liquidityになります。これは「大きな失敗」であり、静かな誤答ではありません。

• デューデリジェンスの代替ではありません。 以下の免責事項を参照してください。

免責事項

このプロジェクトは、Robinhoodとは提携しておらず、Robinhoodによって承認されていません。これは独立した情報提供ツールです。データはRobinhoodの公開APIとDexScreenerの公開APIから取得されており、遅延、不完全、または不正確な場合があります。ここにあるものはすべて金融アドバイスではありません。このサーバーは取引を行うことができず、資金や鍵を保持しません。

ライセンス

MIT — LICENSEを参照してください。