pegcheck
Use this server to check whether a Robinhood Chain Stock Token is trading at a fair price relative to the real-world stock it represents before executing a trade.
Checks price fairness: Takes a ticker like
AAPLand returns a verdict:fair,caution,unreliable,no_liquidity, orunknown_symbol.Compares onchain vs reference prices: Uses a liquidity-weighted onchain DEX price and Robinhood's official reference quote, adjusted by the token's corporate-action multiplier.
Provides actionable details: Returns deviation percentage, market session state (
regular,pre-market,after-hours,weekend,holiday,closed), holiday name, and warnings like stale quotes or trading halts.Liquidity-aware: Falls back to the deepest pool when no qualifying DEX pools exist, flagged as low-confidence.
Read-only and agent-friendly: Never signs transactions or places trades; designed to be called by an AI agent right before trading.
Checks whether a Robinhood Chain Stock Token is trading at a fair price relative to the real-world stock, providing a verdict and deviation data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pegcheck check if TSLA stock token price is fair before I trade"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pegcheck-mcp
A read-only MCP server that checks whether a Robinhood Chain Stock Token is currently trading at a fair price relative to the real-world stock it represents — designed to be called by an AI agent, right before it trades, not read off a dashboard by a human.
✅ Verdict: FAIR (deviation: 0.11%)The problem
Robinhood Chain's Stock Tokens are self-custodiable ERC-20s that track real stocks and trade 24/7 on onchain DEXs. Real stock markets are only open ~6.5 hours a day, 5 days a week. Outside those hours there's no active market to arbitrage the token price back to fair value, so it can drift.
An AI agent trading these tokens directly onchain — holding a wallet key and swapping against a DEX pool — has no built-in way to know if the price it's about to pay is trustworthy. Every existing tool that surfaces this gap (dashboards, Telegram alert bots, trading terminals) is built for a human to look at. None of them are built to be called by an agent mid-decision.
Related MCP server: rhc-mcp
The solution
Two focused MCP tools:
check_stock_token_price— give it a ticker. It returns a structured, session-aware verdict an agent can act on — before it signs a trade, whether that trade goes through Robinhood's own Trading MCP or directly against an onchain DEX.verify_stock_token— give it a ticker and a contract address. It tells you whether that contract is the genuine, issuer-recognized Stock Token. Robinhood Chain is permissionless, so ticker-impersonating tokens are rampant — onchain analysis has found hundreds of fake contracts per major ticker, with fake volume at times out-trading the genuine tokens 2:1. Symbol search alone is not safe; the registry check is the ground truth.
{
"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": []
}This server is read-only. It never holds a private key, never signs a transaction, and never places a trade.
How it works
Two independent data sources, compared:
Onchain price — every indexed Robinhood Chain pool for the token, from DexScreener's public API, filtered to pools quoted in a stable reference asset (USDG/USDC) with at least $500 of liquidity, combined into a liquidity-weighted average (so one deep pool dominates over several shallow, noisy ones). Falls back to the single deepest pool — flagged as low-confidence — if nothing passes the filter.
Reference price — Robinhood's own public Stock Token API (
/rhj/prices/{symbol}), which reports the raw underlying-equity bid/ask. This is scaled by the token's current ERC-8056multiplier(from/rhj/assets) to get the token-equivalent fair price, since dividends are reinvested into the multiplier rather than paid out in cash.
The deviation between the two is compared against a threshold table that depends on the current US market session (regular, pre-market, after-hours, weekend, holiday, closed), computed locally with no external dependency — a 2% gap on a Saturday night is expected; the same gap at 11am on a Tuesday is not. Session detection includes a full NYSE holiday calendar, computed algorithmically (nth-weekday-of-month rules, an Easter calculation for Good Friday, and the standard weekend-observance shift) rather than fetched from any external API, so it works for any year with no network dependency, no API key, and no static file to go stale. Verified against NYSE's officially published 2026-2028 calendar in test/nyseHolidays.test.ts. See src/config.ts for the exact thresholds and src/nyseHolidays.ts for the holiday rules.
Install & run
git clone https://github.com/kushal613/pegcheck-mcp.git
cd pegcheck-mcp
npm install
npm run buildNo API keys, no .env file, no wallet — every data source used is a free, public, keyless API.
Try it from the terminal
npm run check -- AAPL
npm run check -- TSLA
npm run check -- verify TSLA 0x322F0929c4625eD5bAd873c95208D54E1c003b2dConnect it to an MCP client
Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):
{
"mcpServers": {
"pegcheck": {
"command": "node",
"args": ["/absolute/path/to/pegcheck-mcp/dist/index.js"]
}
}
}Cursor (.cursor/mcp.json): same shape as above.
Once connected, ask your agent: "Before you buy any TSLA stock token, check pegcheck to see if the price is fair right now."
Tool reference
check_stock_token_price
Field | Type | Description |
|
| Ticker, e.g. |
|
| Liquidity-weighted onchain price. |
|
|
|
|
| Real stock mid-price, scaled by the corporate-action multiplier. |
|
| Signed % deviation, onchain vs. reference. |
|
|
|
|
| e.g. |
|
|
|
|
| Human-readable caveats (stale quote, trading halt, low-confidence pool, etc.). |
verify_stock_token
Field | Type | Description |
|
| Ticker the token claims to be, e.g. |
|
| Contract address to verify (0x-prefixed EVM address). |
|
| The genuine contract address from Robinhood's asset registry. |
|
|
|
|
| Human-readable explanation (e.g. the correct address when an impostor is detected). |
Architecture
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
verifyToken.ts Impostor guard: registry-backed token-identity verification
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)Known limitations (v0.1)
No early-close handling. NYSE's 1:00 PM closes (day after Thanksgiving, a weekday Christmas Eve) are not modeled as a distinct session — those afternoons will still report
after-hours/closeda few hours later than the real early close. Full-day holiday closures are fully covered.No venue-specific slippage estimate. This reports the aggregate liquidity-weighted price, not "what would my $500 trade cost against this specific pool." That's a deliberate v0.1 scope boundary (a natural v0.2: an
advancedmode that takes a trade size and a specific pool/venue and estimates price impact).DexScreener coverage dependency. If DexScreener hasn't indexed a very new pool yet,
onchain.methodwill be"none"and the verdict will beno_liquidity. This is a "fail loud," not a silent wrong answer.Not a substitute for due diligence. See the disclaimer below.
Disclaimer
This project is not affiliated with or endorsed by Robinhood. It is an independent, informational tool. Data is sourced from Robinhood's public APIs and DexScreener's public API and may be delayed, incomplete, or inaccurate. Nothing here is financial advice. This server cannot place trades and holds no funds or keys.
License
MIT — see LICENSE.
Available Tools
1 toolcheck_stock_token_priceA
Checks whether a Robinhood Chain Stock Token's current onchain trading price is consistent with its real-world reference stock price. Combines a liquidity-weighted average of the token's onchain DEX pools with Robinhood's own live reference quote (adjusted for the token's corporate-action multiplier), and returns a session-aware fairness verdict ('fair' | 'caution' | 'unreliable' | 'no_liquidity' | 'unknown_symbol') plus the deviation percentage and supporting data. Call this BEFORE executing a trade of a Stock Token, whether through Robinhood's own Trading MCP or directly against an onchain DEX, to avoid trading at a price that has drifted from fair value -- which is most likely to happen outside regular US market hours. Read-only: this tool never places, modifies, or signs any trade.
Inputs: symbol (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of confusion or overlap. The tool's purpose is clearly distinct from anything else, meeting the 'clearly distinct purpose' criterion perfectly.
The tool name 'check_stock_token_price' follows a clean verb_noun pattern, and with only one tool there is no inconsistency. The name accurately describes the action and object.
A single tool feels thin for most servers, but here the scope is narrowly defined around one specific check. It is borderline acceptable but on the low end of the typical range, making it a 3 per calibration guidelines.
The tool fully addresses its stated purpose—checking price fairness before trading. It provides a verdict, deviation percentage, and supporting data, with no obvious missing operations for that specific task. It is not a CRUD domain, so the completeness is judged against the narrow mission.
Related MCP Connectors
Robinhood Chain stock tokens vs their Chainlink price: live gaps, pool depth, graded agent calls.
Decision-input integrity for onchain AI agents: verify oracle prices before signing a trade.
Provable crypto data for AI agents: sourced checks on tokens, wallets and trades, with proof ids.
Pre-trade risk gating and verifiable decision evidence for AI trading agents. Oracle-backed price/safety checks across Base, Solana, Hyperliquid and BNB, plus signed receipts and portable evidence bundles for any agent action.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Robinhood Chain via USDG payments, offering tools for balance, pricing, trading, and more.1848MIT
- AlicenseAqualityDmaintenanceEnables AI agents to read Robinhood Chain stock-token positions, quote swaps, and execute swaps through the Model Context Protocol, bridging on-chain assets that Robinhood's own off-chain MCP cannot reach.4MIT

hoodr MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to trade tokenized stocks (e.g., NVDA, TSLA) on Robinhood Chain via MCP, with non-custodial keys and spending caps.21 npmMIT
STOX Research MCPofficial
AlicenseAqualityCmaintenanceEnables live market data lookup and search for tokenized stocks, ETFs, commodities, bonds, and real estate on Robinhood Chain, plus broader DEX token discovery, including price queries, market ranking, and movers.5MIT