Skip to main content
Glama

hood-mcp

GitHub stars Last commit PRs welcome AI agent friendly

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-mcp

Claude 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-mcp

No 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

get_chain_stats

Latest block, gas price, TVL, network totals.

list_stock_tokens

The 95-token Stock Token registry (ticker, name, contract, feed).

get_stock_quote

Chainlink price + Uniswap DEX price + premium/discount + share price for a ticker.

get_portfolio

Multiplier-correct Stock Token portfolio + USDG balance for any address.

get_coin

Price/volume/liquidity/holders for any token by address (memecoin or Stock Token).

list_trending_coins

The chain's trending pools right now.

get_recent_launches

Recent NOXA + The Odyssey launches, scanned from on-chain logs.

watch_launches

Watch live for new launches for up to 120s.

search_token

Find a token by ticker, name, or address.

HOOD_MCP_NETWORK=mainnet   # or testnet — default mainnet
ALCHEMY_KEY=                # optional: private RPC instead of public

2. 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

get_my_portfolio

This wallet's ETH, USDG, and Stock Token positions. Read-only.

get_swap_quote

Quote a Uniswap swap without signing. Read-only.

execute_swap

Guarded. Preview → confirm: true → broadcast. Spend-capped.

transfer_usdg

Guarded. Preview → confirm: true → broadcast. Spend-capped.

See Safety model for the full guard design. Summary:

  1. Kill switch — the server process itself refuses to start without HOOD_MCP_ENABLE_TRADING=1.

  2. 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).

  3. Spend caps — every mutating call is valued in USD and checked against HOOD_MCP_MAX_SPEND_USDG (per-call) and HOOD_MCP_MAX_SESSION_USDG (per-session, in-memory, resets on restart) before anything is signed.

  4. Confirm gate — the first call to execute_swap / transfer_usdg always returns a simulation (recipient, amount, token, min-received) and signs nothing. Only a second call with confirm: true and 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 Tokens

Stock 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.json in this repo validates against the official schema. Submit with the mcp-publisher CLI once hood-mcp is live on npm.

  • Smithery — their current flow publishes a running server URL or an .mcpb bundle (smithery mcp publish <url> -n <org/server>), not a static config file. Deploy the HTTP transport (hood-mcp --http) somewhere public, then run smithery mcp publish https://your-deployment/mcp -n nirholas/hood-mcp.

License

All rights reserved. See LICENSE.

Star History

Star History Chart

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

Contributors

Contributors


Available Tools

9 tools
get_chain_statsRobinhood Chain statsA
Read-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 detailA
Read-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 portfolioA
Read-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 launchesA
Read-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 quoteA
Read-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 TokensB
Read-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.

search_tokenSearch tokensA
Read-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 launchesA
Read-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

    A3.8/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for Robinhood chain launchpad discovery and token due diligence using GMGN data.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      MIT