pegcheck-mcp

Сервер MCP только для чтения, который проверяет, торгуется ли Robinhood Chain Stock Token в данный момент по справедливой цене относительно реальной акции, которую он представляет, — предназначен для вызова ИИ-агентом непосредственно перед совершением сделки, а не для чтения с дашборда человеком.

✅ Verdict: FAIR (deviation: 0.11%)

Проблема

Токены Stock Tokens Robinhood Chain — это самокастодиальные ERC-20, которые отслеживают реальные акции и торгуются 24/7 на ончейн-DEX. Реальные фондовые рынки открыты всего ~6,5 часов в день, 5 дней в неделю. Вне этих часов нет активного рынка, чтобы арбитражировать цену токена обратно к справедливой стоимости, поэтому она может отклоняться.

ИИ-агент, торгующий этими токенами напрямую в ончейне — держа ключ от кошелька и обмениваясь через пул DEX — не имеет встроенного способа узнать, заслуживает ли доверия цена, которую он собирается заплатить. Все существующие инструменты, которые выявляют этот разрыв (дашборды, Telegram-боты для оповещений, торговые терминалы), созданы для просмотра человеком. Ни один из них не предназначен для вызова агентом в процессе принятия решения.

Решение

Один сфокусированный MCP-инструмент: check_stock_token_price.

Передайте ему тикер. Он возвращает структурированный вердикт с учётом торговой сессии, на который агент может опираться — перед подписанием сделки, будь то через собственный Trading MCP Robinhood или напрямую через ончейн-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. Ончейн-цена — каждый проиндексированный пул Robinhood Chain для токена, из публичного API DexScreener, отфильтрованный до пулов, котируемых в стабильном эталонном активе (USDG/USDC) с ликвидностью не менее $500, объединённый в средневзвешенную по ликвидности (так что один глубокий пул доминирует над несколькими мелкими и шумными). Если ни один пул не проходит фильтр, используется единственный самый глубокий пул — помеченный как низкодоверенный.

2. Эталонная цена — собственный публичный Stock Token API Robinhood (/rhj/prices/{symbol}), который сообщает сырые bid/ask базовой акции. Она масштабируется на текущий multiplier токена ERC-8056 (из /rhj/assets), чтобы получить эквивалентную справедливую цену токена, поскольку дивиденды реинвестируются в множитель, а не выплачиваются наличными.

Отклонение между ними сравнивается с таблицей порогов, зависящей от текущей торговой сессии США (regular, pre-market, after-hours, weekend, holiday, closed), вычисляемой локально без внешних зависимостей — разрыв в 2% в субботу вечером ожидаем; тот же разрыв в 11 утра во вторник — нет. Определение сессии включает полный календарь праздников NYSE, вычисляемый алгоритмически (правила n-го дня недели месяца, расчёт Пасхи для Страстной пятницы и стандартный перенос выходных) вместо загрузки из внешнего API, поэтому он работает для любого года без сетевых зависимостей, без 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 в 13:00 (день после Дня благодарения, будний день перед Рождеством) не моделируются как отдельная сессия — в эти дни после полудня всё ещё будет сообщаться after-hours/closed на несколько часов позже реального раннего закрытия. Полные дневные закрытия на праздники полностью покрыты.

• Нет оценки проскальзывания для конкретной площадки. Здесь сообщается агрегированная средневзвешенная по ликвидности цена, а не «сколько будет стоить моя сделка на $500 против этого конкретного пула». Это намеренная граница области v0.1 (естественный v0.2: режим advanced, который принимает размер сделки и конкретный пул/площадку и оценивает влияние на цену).

• Зависимость от покрытия DexScreener. Если DexScreener ещё не проиндексировал очень новый пул, onchain.method будет "none", а вердикт — no_liquidity. Это «громкий сбой», а не тихий неверный ответ.

• Не заменяет должную осмотрительность. См. дисклеймер ниже.

Дисклеймер

Этот проект не связан с Robinhood и не одобрен им. Это независимый информационный инструмент. Данные получены из публичных API Robinhood и публичного API DexScreener и могут быть устаревшими, неполными или неточными. Ничто здесь не является финансовой рекомендацией. Этот сервер не может совершать сделки и не хранит средства или ключи.

Лицензия

MIT — см. LICENSE.