hood-mcp
This server gives read-only, zero-config access to Robinhood Chain (chain ID 4663) data — chain stats, Stock Tokens, memecoin/token details, portfolios, trending pools, and launchpad activity — with no wallet or API key required.
Chain overview —
get_chain_statsreturns latest block, gas price, TVL, and network totals (blocks, addresses, transactions, block time).Stock Token registry —
list_stock_tokenslists the 95 tokenized-equity Stock Tokens (ticker, name, contract, Chainlink feed), with pagination and apricedOnlyfilter.Stock Token pricing —
get_stock_quoteprices a ticker via Chainlink oracle and Uniswap DEX mid, showing premium/discount and the ERC-8056 multiplier so you also get the underlying share price.Portfolio valuation —
get_portfoliovalues any address's Stock Token positions (multiplier-correct balances, USD value) plus its USDG cash balance.Token / memecoin detail —
get_coinreturns price, 24h volume, liquidity, FDV, holder count, and whether the token is a registered Stock Token.Trending discovery —
list_trending_coinsshows the chain's trending pools (memecoins and stocks) with price, volume, 24h change, and liquidity.Launchpad activity —
get_recent_launchesscans on-chain logs for recent NOXA and The Odyssey launches, filterable by launchpad and lookback blocks.Live launch watching —
watch_launchesblocks for up to 120s waiting for new launches, optionally falling back to the most recent one.Token search —
search_tokenfinds tokens by ticker, name fragment, or 0x address across the Stock Token registry and the Blockscout index.Deployment flexibility — runs over stdio by default or Streamable HTTP (
--http,POST /mcp,GET /health), against mainnet or testnet, optionally with a private RPC viaALCHEMY_KEY.
All tools are read-only; trading/swap capabilities live in the separate opt-in hood-mcp-trading server.
Integrates Chainlink price feeds to provide stock quotes and premium/discount data for tokens on Robinhood Chain.
Provides tools to interact with Robinhood Chain: query stock tokens, memecoins, chain stats, portfolio, trending coins, recent launches, and perform guarded trades (swaps, transfers) via Uniswap with spend caps and confirm gates.
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., "@hood-mcp what are the trending coins?"
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.
hood-mcp
Model Context Protocol servers for Robinhood Chain (chain ID 4663).
Two servers, one package: a zero-config data server any MCP client can add in one line, and
an explicitly opt-in trading server for wallets that want to act. Built on
hoodchain, the TypeScript SDK for the chain.
Docs: https://nirholas.github.io/robinhood-chain-mcp/
Why
Robinhood Chain has two other MCP servers today, both zero-star, days-old, read-only hobby projects. This is the productized one: a full data surface (Stock Tokens, memecoins, launches, chain stats) plus a guarded trading surface with hard spend caps and a confirm gate — built to the standard three.ws holds its agent tooling to.
Related MCP server: Hoodly GMGN Robinhood Research MCP
60-second install
Claude Code
claude mcp add hood-mcp -- npx -y hood-mcpClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"hood-mcp": {
"command": "npx",
"args": ["-y", "hood-mcp"]
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"hood-mcp": {
"command": "npx",
"args": ["-y", "hood-mcp"]
}
}
}Any stdio MCP client
npx -y hood-mcpNo API key, no wallet, no config. It talks to the public Robinhood Chain RPC and starts answering tool calls immediately.
Two servers
1. hood-mcp — data server (zero-config, read-only)
stdio by default; pass --http (or HOOD_MCP_TRANSPORT=http) for Streamable HTTP on
HOOD_MCP_PORT (default 8730), serving POST /mcp and GET /health.
Tool | What it does |
| Latest block, gas price, TVL, network totals. |
| The 95-token Stock Token registry (ticker, name, contract, feed). |
| Chainlink price + Uniswap DEX price + premium/discount + share price for a ticker. |
| Multiplier-correct Stock Token portfolio + USDG balance for any address. |
| Price/volume/liquidity/holders for any token by address (memecoin or Stock Token). |
| The chain's trending pools right now. |
| Recent NOXA + The Odyssey launches, scanned from on-chain logs. |
| Watch live for new launches for up to 120s. |
| Find a token by ticker, name, or address. |
HOOD_MCP_NETWORK=mainnet # or testnet — default mainnet
ALCHEMY_KEY= # optional: private RPC instead of public2. hood-mcp-trading — wallet server (explicitly opt-in)
Separate binary, stdio only, refuses to start unless both are set:
HOOD_MCP_ENABLE_TRADING=1
ROBINHOOD_CHAIN_PRIVATE_KEY=0x...{
"mcpServers": {
"hood-mcp-trading": {
"command": "npx",
"args": ["-y", "hood-mcp-trading"],
"env": {
"HOOD_MCP_ENABLE_TRADING": "1",
"ROBINHOOD_CHAIN_PRIVATE_KEY": "0xYOUR_KEY"
}
}
}
}Tool | What it does |
| This wallet's ETH, USDG, and Stock Token positions. Read-only. |
| Quote a Uniswap swap without signing. Read-only. |
| Guarded. Preview → |
| Guarded. Preview → |
See Safety model for the full guard design. Summary:
Kill switch — the server process itself refuses to start without
HOOD_MCP_ENABLE_TRADING=1.Eligibility gate — buying a tokenized Stock Token requires
HOOD_MCP_ACKNOWLEDGE_ELIGIBILITY=1(Stock Tokens are barred to US/Canada/UK/Switzerland persons — see below).Spend caps — every mutating call is valued in USD and checked against
HOOD_MCP_MAX_SPEND_USDG(per-call) andHOOD_MCP_MAX_SESSION_USDG(per-session, in-memory, resets on restart) before anything is signed.Confirm gate — the first call to
execute_swap/transfer_usdgalways returns a simulation (recipient, amount, token, min-received) and signs nothing. Only a second call withconfirm: trueand identical arguments broadcasts.
HOOD_MCP_MAX_SPEND_USDG=25 # default 25 — per single call
HOOD_MCP_MAX_SESSION_USDG=100 # default 100 — cumulative for the process lifetime
HOOD_MCP_ACKNOWLEDGE_ELIGIBILITY=0 # set to 1 ONLY if eligible to hold Stock TokensStock Tokens are tokenized debt securities (issuer: Robinhood Assets (Jersey) Ltd) and may
not be offered, sold, or delivered to US persons (additional limits: Canada, UK, Switzerland).
The restriction is legal/front-end enforced, not contract-level — execute_swap throws unless
the operator has explicitly acknowledged eligibility. Memecoins are unrestricted.
Environment reference
See .env.example for the full annotated list. Nothing is required for the
data server; the trading server requires the two kill-switch variables above.
x402 monetization (seam, not active)
The HTTP transport has a documented seam (src/x402-seam.ts) to paywall future metered tools
(deep history, firehose) via the sibling hood402 USDG-on-Robinhood-Chain x402
rail once it exists. Every tool this package ships today stays free regardless.
Development
npm install
npm run build # tsup → dist/
npm run dev:data # tsx src/data-server.ts (stdio)
npm run dev:trading # tsx src/trading-server.ts (stdio, needs env)
npm test # hermetic: schema + guard tests (real network reads, no wallet funds)
npm run test:live # live: every data tool against real mainnet 4663 data
npm run test:swap # live, gated: a REAL testnet swap through execute_swap (needs a
# faucet-funded ROBINHOOD_CHAIN_PRIVATE_KEY — see the test file)Depends on hoodchain from npm; for local development against an unpublished SDK checkout:
npm i ../robinhood-chain-sdk.
Registry submissions (owner action)
Metadata is prepared, not submitted — publishing to a registry is a one-way, attributed action the owner should take:
modelcontextprotocol registry —
server.jsonin this repo validates against the official schema. Submit with themcp-publisherCLI oncehood-mcpis live on npm.Smithery — their current flow publishes a running server URL or an
.mcpbbundle (smithery mcp publish <url> -n <org/server>), not a static config file. Deploy the HTTP transport (hood-mcp --http) somewhere public, then runsmithery mcp publish https://your-deployment/mcp -n nirholas/hood-mcp.
License
All rights reserved. See LICENSE.
Star History
Support the project
If robinhood-chain-mcp saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.
Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit
Built for AI agents too
Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/robinhood-chain-mcp and it has the context it needs.
More from the same author
All repositories by nirholas: the full catalog, grouped by topic
three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
Questions or ideas: open an issue or start a discussion
Contributors
Available Tools
9 toolsget_chain_statsRobinhood Chain statsARead-only
Live Robinhood Chain overview: latest block, gas price, TVL, and network totals (blocks, addresses, transactions, block time). No inputs.
Inputs: no named parameters.
get_coinGet token / memecoin detailARead-only
Detail for any Robinhood Chain token by contract address: price, 24h volume, liquidity, FDV, holder count, and whether it is a registered Stock Token.
Inputs: address (required).
get_portfolioGet Stock Token portfolioARead-only
Multiplier-correct Stock Token portfolio for any address: per-position token balance, ERC-8056 share-equivalent, USD value, plus the USDG cash balance. Read-only.
Inputs: address (required).
get_recent_launchesRecent launchpad launchesARead-only
Recently launched tokens on Robinhood Chain launchpads (NOXA and The Odyssey), newest first, scanned from on-chain logs.
Inputs: limit, launchpad, lookbackBlocks.
get_stock_quoteGet Stock Token quoteARead-only
Price a Stock Token by ticker: the Chainlink oracle price, the on-chain Uniswap DEX mid price, the premium/discount between them, and the ERC-8056 multiplier (so you also get the underlying share price).
Inputs: symbol (required), maxAgeSeconds.
list_stock_tokensList Stock TokensBRead-only
The registry of tokenized-equity Stock Tokens on Robinhood Chain (ticker, name, contract, Chainlink feed). Set pricedOnly to return only tokens with a live feed.
Inputs: limit, offset, pricedOnly.
list_trending_coinsList trending coinsBRead-only
The trending pools on Robinhood Chain right now (memecoins and stocks) with price, 24h volume, price change, and liquidity — the pulse of the chain.
Inputs: limit.
search_tokenSearch tokensARead-only
Find tokens on Robinhood Chain by ticker, name, or contract address — searches the Stock Token registry and the Blockscout index together.
Inputs: query (required), limit.
watch_launchesWatch for live launchesARead-only
Watch NOXA + The Odyssey live for new token launches, blocking up to waitSeconds (or until limit launches are seen), then returns what appeared. Falls back to the most recent launch if none fire in the window.
Inputs: limit, launchpad, waitSeconds, includeRecentIfEmpty.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Tools mostly target distinct resources: portfolio, single-token detail, trending list, launches, search, stock registry, stock quote, and chain stats. The only mild overlaps are get_coin vs get_stock_quote (both return price, but by address vs ticker with oracle detail) and list_stock_tokens vs search_token (registry vs fuzzy search), which descriptions clarify adequately.
All nine tools follow a clean verb_noun snake_case pattern (get_portfolio, list_stock_tokens, search_token, watch_launches, etc.). The single non-'get' verb, watch_launches, still adheres to the verb_noun convention and reads predictably.
Nine tools is well within the ideal 3-15 range for a chain data/analytics server. Each tool covers a distinct capability (portfolio, token detail, discovery, launches, stocks, chain stats) with no obvious filler.
The read-only surface covers portfolios, token detail, discovery (trending, launches, search, registry), stock pricing, and chain stats—a solid analytics scope. Minor gaps remain around transaction/address activity history and block-level lookups that agents might expect from a chain explorer.
Maintenance
Related MCP Connectors
Launch, trade & QProof token safety on Robinhood Chain + more; perps, OTC escrow and agreements.
Token intelligence for Robinhood Chain: onchain and social data on any token, timestamped.
Read-only MCP server for Robinhood Chain token discovery, research, and due diligence via GMGN.
On-chain honeypot/rug scanner, market data, and launch tools for Robinhood Chain (EVM 4663).
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceA zero-dependency MCP server that bridges AI agents to Robinhood Chain and Arbitrum Orbit L2 networks, enabling querying balances, simulating transactions, and signing/broadcasting EVM transactions via JSON-RPC tools.6-
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server for Robinhood chain launchpad discovery and token due diligence using GMGN data.-
- AlicenseNot gradedqualityCmaintenanceRead-only token intelligence for Robinhood Chain and Solana, providing safety checks, ticker resolution, deployer records, whale wallet tracking, and outcome measurements via a hosted MCP server.MIT

BlurHook MCPofficial
AlicenseAqualityBmaintenanceEnables Robinhood Chain trading agents to obtain quotes, policy-checked unsigned public-swap calldata, simulations, hook information, prices, and deployment discovery without holding keys or signing transactions.9MIT