pegcheck-mcp

Un servidor MCP de solo lectura que comprueba si un Robinhood Chain Stock Token se está negociando actualmente a un precio justo en relación con la acción del mundo real que representa, diseñado para ser llamado por un agente de IA, justo antes de que opere, no para ser leído desde un panel por un humano.

✅ Verdict: FAIR (deviation: 0.11%)

El problema

Los Stock Tokens de Robinhood Chain son ERC-20 autocustodiables que siguen acciones reales y se negocian 24/7 en DEX onchain. Los mercados de valores reales solo están abiertos ~6,5 horas al día, 5 días a la semana. Fuera de esas horas no hay un mercado activo para arbitrar el precio del token de vuelta a su valor justo, por lo que puede desviarse.

Un agente de IA que negocia estos tokens directamente onchain (con una clave de cartera y haciendo swaps contra un pool de DEX) no tiene una forma integrada de saber si el precio que está a punto de pagar es fiable. Todas las herramientas existentes que muestran esta brecha (paneles, bots de alerta de Telegram, terminales de trading) están diseñadas para que las mire un humano. Ninguna de ellas está diseñada para ser llamada por un agente en medio de una decisión.

La solución

Una herramienta MCP enfocada: check_stock_token_price.

Dale un ticker. Devuelve un veredicto estructurado y consciente de la sesión sobre el que un agente puede actuar, antes de firmar una operación, ya sea a través del propio Trading MCP de Robinhood o directamente contra un DEX onchain.

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

Este servidor es de solo lectura. Nunca tiene una clave privada, nunca firma una transacción y nunca realiza una operación.

Cómo funciona

Dos fuentes de datos independientes, comparadas:

1. Precio onchain — cada pool indexado de Robinhood Chain para el token, desde la API pública de DexScreener, filtrado a pools cotizados en un activo de referencia estable (USDG/USDC) con al menos $500 de liquidez, combinados en un promedio ponderado por liquidez (para que un pool profundo domine sobre varios poco profundos y ruidosos). Si nada pasa el filtro, se recurre al pool más profundo, marcado como de baja confianza.

2. Precio de referencia — la propia API de Stock Token pública de Robinhood (/rhj/prices/{symbol}), que informa el bid/ask bruto del subyacente. Esto se escala por el multiplier actual del token ERC-8056 (de /rhj/assets) para obtener el precio justo equivalente al token, ya que los dividendos se reinvierten en el multiplicador en lugar de pagarse en efectivo.

La desviación entre ambos se compara con una tabla de umbrales que depende de la sesión actual del mercado estadounidense (regular, pre-market, after-hours, weekend, holiday, closed), calculada localmente sin dependencia externa: una brecha del 2% un sábado por la noche es esperada; la misma brecha a las 11 a.m. de un martes no lo es. La detección de sesión incluye un calendario completo de festivos de NYSE, calculado algorítmicamente (reglas de enésimo día de la semana del mes, un cálculo de Pascua para el Viernes Santo y el cambio estándar de observancia de fin de semana) en lugar de obtenerse de cualquier API externa, por lo que funciona para cualquier año sin dependencia de red, sin clave API y sin archivo estático que quede obsoleto. Verificado contra el calendario oficial publicado por NYSE para 2026-2028 en test/nyseHolidays.test.ts. Consulta src/config.ts para los umbrales exactos y src/nyseHolidays.ts para las reglas de festivos.

Instalación y ejecución

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

Sin claves API, sin archivo .env, sin cartera: cada fuente de datos utilizada es una API gratuita, pública y sin clave.

Pruébalo desde la terminal

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

Conéctalo a un cliente MCP

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

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

Cursor (.cursor/mcp.json): misma forma que arriba.

Una vez conectado, pídele a tu agente: "Antes de comprar cualquier token de acción TSLA, consulta pegcheck para ver si el precio es justo en este momento."

Referencia de la herramienta

check_stock_token_price

Arquitectura

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)

Limitaciones conocidas (v0.1)

• Sin manejo de cierre anticipado. Los cierres de la NYSE a la 1:00 PM (el día después de Acción de Gracias, una víspera de Navidad entre semana) no se modelan como una sesión distinta: esas tardes seguirán informando after-hours/closed unas horas más tarde que el cierre anticipado real. Los cierres de día completo por festivos están totalmente cubiertos.

• Sin estimación de deslizamiento específica del lugar. Esto informa el precio agregado ponderado por liquidez, no "cuánto costaría mi operación de $500 contra este pool específico". Ese es un límite deliberado del alcance de v0.1 (un v0.2 natural: un modo advanced que tome un tamaño de operación y un pool/lugar específico y estime el impacto en el precio).

• Dependencia de la cobertura de DexScreener. Si DexScreener aún no ha indexado un pool muy nuevo, onchain.method será "none" y el veredicto será no_liquidity. Esto es un "fallo ruidoso", no una respuesta incorrecta silenciosa.

• No sustituye la diligencia debida. Consulta el descargo de responsabilidad a continuación.

Descargo de responsabilidad

Este proyecto no está afiliado ni respaldado por Robinhood. Es una herramienta independiente e informativa. Los datos provienen de las API públicas de Robinhood y de la API pública de DexScreener y pueden estar retrasados, incompletos o ser inexactos. Nada de esto es asesoramiento financiero. Este servidor no puede realizar operaciones y no tiene fondos ni claves.

Licencia

MIT — consulta LICENSE.