pegcheck-mcp

Ein schreibgeschützter MCP-Server, der prüft, ob ein Robinhood Chain Stock Token derzeit zu einem fairen Preis im Vergleich zur realen Aktie, die es repräsentiert, gehandelt wird – entwickelt, um von einem KI-Agenten direkt vor einem Trade aufgerufen zu werden, nicht um von einem Menschen von einem Dashboard abgelesen zu werden.

✅ Verdict: FAIR (deviation: 0.11%)

Das Problem

Die Stock Tokens von Robinhood Chain sind selbst verwahrbare ERC-20-Token, die reale Aktien abbilden und rund um die Uhr an Onchain-DEXs gehandelt werden. Reale Aktienmärkte sind nur etwa 6,5 Stunden am Tag, 5 Tage die Woche geöffnet. Außerhalb dieser Zeiten gibt es keinen aktiven Markt, um den Token-Preis wieder auf den fairen Wert zu arbitrieren, sodass er abweichen kann.

Ein KI-Agent, der diese Token direkt onchain handelt – einen Wallet-Schlüssel besitzt und gegen einen DEX-Pool tauscht – hat keine eingebaute Möglichkeit zu wissen, ob der Preis, den er gleich zahlen wird, vertrauenswürdig ist. Jedes bestehende Tool, das diese Lücke aufzeigt (Dashboards, Telegram-Alert-Bots, Trading-Terminals), ist für einen Menschen zum Anschauen gebaut. Keines davon ist dafür gebaut, von einem Agenten mitten in einer Entscheidung aufgerufen zu werden.

Die Lösung

Ein fokussiertes MCP-Tool: check_stock_token_price.

Gib ihm ein Tickersymbol. Es liefert ein strukturiertes, sitzungsbewusstes Urteil, auf das ein Agent reagieren kann – bevor er einen Trade signiert, egal ob dieser Trade über Robinhoods eigenes Trading-MCP oder direkt gegen einen Onchain-DEX läuft.

{
  "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": []
}

Dieser Server ist schreibgeschützt. Er hält niemals einen privaten Schlüssel, signiert niemals eine Transaktion und platziert niemals einen Trade.

So funktioniert es

Zwei unabhängige Datenquellen, verglichen:

1. Onchain-Preis – jeder indexierte Robinhood-Chain-Pool für den Token, von DexScreeners öffentlicher API, gefiltert auf Pools, die in einem stabilen Referenz-Asset (USDG/USDC) notiert sind und mindestens 500 $ Liquidität haben, kombiniert zu einem liquiditätsgewichteten Durchschnitt (so dominiert ein tiefer Pool über mehrere flache, verrauschte). Fällt auf den einzelnen tiefsten Pool zurück – als geringe Konfidenz markiert – wenn nichts den Filter besteht.

2. Referenzpreis – Robinhoods eigene öffentliche Stock Token API (/rhj/prices/{symbol}), die das rohe Bid/Ask des zugrunde liegenden Basiswerts meldet. Dieser wird mit dem aktuellen ERC-8056 multiplier (von /rhj/assets) skaliert, um den token-äquivalenten fairen Preis zu erhalten, da Dividenden in den Multiplikator reinvestiert werden, anstatt in bar ausgezahlt zu werden.

Die Abweichung zwischen den beiden wird mit einer Schwellwerttabelle verglichen, die von der aktuellen US-Marktsitzung abhängt (regular, pre-market, after-hours, weekend, holiday, closed), die lokal ohne externe Abhängigkeit berechnet wird – eine Abweichung von 2 % an einem Samstagabend ist zu erwarten; dieselbe Abweichung um 11 Uhr an einem Dienstag nicht. Die Sitzungserkennung umfasst einen vollständigen NYSE-Feiertagskalender, der algorithmisch berechnet wird (n-ter-Wochentag-im-Monat-Regeln, eine Osterberechnung für Karfreitag und die übliche Verschiebung bei Wochenendfeiertagen) und nicht von einer externen API abgerufen wird, sodass er für jedes Jahr ohne Netzwerkabhängigkeit, ohne API-Schlüssel und ohne statische Datei, die veralten könnte, funktioniert. Verifiziert gegen den offiziell veröffentlichten NYSE-Kalender 2026–2028 in test/nyseHolidays.test.ts. Siehe src/config.ts für die genauen Schwellwerte und src/nyseHolidays.ts für die Feiertagsregeln.

Installation & Ausführung

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

Keine API-Schlüssel, keine .env-Datei, keine Wallet – jede verwendete Datenquelle ist eine kostenlose, öffentliche, schlüssellose API.

Teste es vom Terminal aus

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

Verbinde es mit einem MCP-Client

Claude Desktop / Claude Code (claude_desktop_config.json oder .mcp.json):

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

Cursor (.cursor/mcp.json): gleiche Struktur wie oben.

Sobald verbunden, frag deinen Agenten: „Bevor du ein TSLA-Aktien-Token kaufst, prüfe pegcheck, um zu sehen, ob der Preis gerade fair ist."

Tool-Referenz

check_stock_token_price

Architektur

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)

Bekannte Einschränkungen (v0.1)

• Keine Behandlung von frühen Handelsschlüssen. Die 13:00-Uhr-Schlüsse der NYSE (Tag nach Thanksgiving, Heiligabend an einem Wochentag) werden nicht als eigene Sitzung modelliert – diese Nachmittage melden weiterhin after-hours/closed einige Stunden später als der tatsächliche frühe Schluss. Ganztägige Feiertagsschließungen sind vollständig abgedeckt.

• Keine venuespezifische Slippage-Schätzung. Dies meldet den aggregierten liquiditätsgewichteten Preis, nicht „was würde mein 500-$-Trade gegen diesen spezifischen Pool kosten." Das ist eine bewusste v0.1-Umfangsgrenze (ein natürliches v0.2: ein advanced-Modus, der eine Handelsgröße und einen bestimmten Pool/Venue annimmt und die Preisauswirkung schätzt).

• Abhängigkeit von der DexScreener-Abdeckung. Wenn DexScreener einen sehr neuen Pool noch nicht indexiert hat, wird onchain.method "none" sein und das Urteil no_liquidity lauten. Das ist ein „lautes Scheitern", keine stille falsche Antwort.

• Kein Ersatz für Due Diligence. Siehe den Haftungsausschluss unten.

Haftungsausschluss

Dieses Projekt ist nicht mit Robinhood verbunden oder von Robinhood unterstützt. Es ist ein unabhängiges, informatives Tool. Daten stammen aus Robinhoods öffentlichen APIs und DexScreeners öffentlicher API und können verzögert, unvollständig oder ungenau sein. Nichts hier ist eine Finanzberatung. Dieser Server kann keine Trades platzieren und hält keine Gelder oder Schlüssel.

Lizenz

MIT – siehe LICENSE.