hood-mcp

hood-mcp

Robinhood Chain（チェーン ID 4663）向けの Model Context Protocol サーバーです。

2 つのサーバーを 1 つのパッケージにまとめています。あらゆる MCP クライアントが 1 行で追加できる設定不要のデータサーバーと、取引を実行したいウォレット向けの明示的なオプトインが必要な取引サーバーです。チェーン向け TypeScript SDK のhoodchainを基盤に構築されています。

ドキュメント：https://nirholas.github.io/robinhood-chain-mcp/

特長

現在、Robinhood Chain にはほかに 2 つの MCP サーバーがありますが、どちらもスター数ゼロで、公開から数日しか経っていない読み取り専用の趣味プロジェクトです。これは製品品質を備えたサーバーです。完全なデータ機能（Stock Tokens、ミームコイン、ローンチ、チェーン統計）に加え、厳格な支出上限と確認ゲートを備えた保護付きの取引機能を提供します。three.ws がエージェントツールに求める基準に沿って構築されています。

60 秒でインストール

Claude Code

claude mcp add hood-mcp -- npx -y hood-mcp

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "hood-mcp": {
      "command": "npx",
      "args": ["-y", "hood-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "hood-mcp": {
      "command": "npx",
      "args": ["-y", "hood-mcp"]
    }
  }
}

stdio MCP クライアント全般

npx -y hood-mcp

API キーもウォレットも設定も不要です。公開されている Robinhood Chain RPC に接続し、すぐにツール呼び出しへの応答を開始します。

2 つのサーバー

1. hood-mcp — データサーバー（設定不要、読み取り専用）

デフォルトは stdio です。--http（または HOOD_MCP_TRANSPORT=http）を指定すると、HOOD_MCP_PORT（デフォルトは 8730）で Streamable HTTP を使用し、POST /mcp と GET /health を提供します。

ツール	機能
get_chain_stats	最新ブロック、ガス価格、TVL、ネットワーク合計を取得します。
list_stock_tokens	95 種類の Stock Token レジストリ（ティッカー、名前、コントラクト、フィード）を一覧表示します。
get_stock_quote	指定ティッカーの Chainlink 価格、Uniswap DEX 価格、プレミアム／ディスカウント、株価を取得します。
get_portfolio	任意のアドレスについて、倍率を考慮した Stock Token ポートフォリオと USDG 残高を取得します。
get_coin	アドレスで指定した任意のトークン（ミームコインまたは Stock Token）の価格、取引量、流動性、保有者数を取得します。
list_trending_coins	現在チェーンでトレンドになっているプールを一覧表示します。
get_recent_launches	オンチェーンログをスキャンし、最近の NOXA と The Odyssey のローンチを取得します。
watch_launches	最大 120 秒間、新しいローンチをリアルタイムで監視します。
search_token	ティッカー、名前、またはアドレスでトークンを検索します。

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

2. hood-mcp-trading — ウォレットサーバー（明示的なオプトインが必要です）

別個のバイナリで、stdio のみを使用します。次の両方が設定されていない場合、起動を拒否します。

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"
      }
    }
  }
}

ツール	説明
get_my_portfolio	このウォレットの ETH、USDG、Stock Token の保有状況を取得します。読み取り専用です。
get_swap_quote	署名せずに Uniswap のスワップ見積もりを取得します。読み取り専用です。
execute_swap	保護されています。 プレビュー → confirm: true → ブロードキャスト。支出上限があります。
transfer_usdg	保護されています。 プレビュー → confirm: true → ブロードキャスト。支出上限があります。

ガードの設計全体については、安全モデルを参照してください。概要：

1. キルスイッチ — HOOD_MCP_ENABLE_TRADING=1 が設定されていない場合、サーバープロセス自体が起動を拒否します。
2. 適格性ゲート — トークン化された Stock Token を購入するには、HOOD_MCP_ACKNOWLEDGE_ELIGIBILITY=1 が必要です （Stock Token は米国、カナダ、英国、スイスの居住者には提供されません。詳しくは以下を参照）。
3. 支出上限 — すべての変更を伴う呼び出しは USD で評価され、署名が行われる前に HOOD_MCP_MAX_SPEND_USDG（呼び出しごと）および HOOD_MCP_MAX_SESSION_USDG（セッションごと、 メモリ内で管理され、再起動時にリセット）に照らして確認されます。
4. 確認ゲート — execute_swap／transfer_usdg の初回呼び出しは、必ずシミュレーション（受取人、金額、トークン、受取最小額）を返し、署名は行いません。2 回目の呼び出しで、引数が同一であり confirm: true が指定された場合にのみ、ブロードキャストします。

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 Token はトークン化された債務証券（発行者：Robinhood Assets (Jersey) Ltd）であり、米国の居住者への提供、販売、引き渡しは禁止されています（カナダ、英国、スイスにも追加の制限があります）。この制限は法律およびフロントエンドで適用され、コントラクトレベルでは適用されません。運営者が適格性を明示的に確認していない場合、execute_swap はエラーになります。ミームコインには制限はありません。

環境変数の一覧

注釈付きの一覧全体については、.env.example を参照してください。データサーバーでは設定は不要です。トレーディングサーバーでは、上記の 2 つのキルスイッチ変数が必要です。

x402 による収益化（将来に備えた接続部であり、現時点では無効）

HTTP トランスポートには、兄弟プロジェクトの hood402 による Robinhood Chain 上の USDG x402 レールが利用可能になった際に、従量課金制の将来のツール（詳細な履歴、ファイアホース）をペイウォールで保護するための、文書化された接続部（src/x402-seam.ts）があります。このパッケージが現在提供しているすべてのツールは、引き続き無料です。

開発

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)

npm の hoodchain に依存しています。公開前の SDK チェックアウトを使ってローカルで開発する場合： npm i ../robinhood-chain-sdk。

レジストリへの登録（所有者による作業）

メタデータの準備はできていますが、登録は行っていません。レジストリへの公開は、所有者が行うべき、取り消しのできない、実行者が明示される操作です。

• modelcontextprotocol registry — このリポジトリの server.json は、公式スキーマに照らして検証済みです。 hood-mcp が npm で公開されたら、mcp-publisher CLI を使って登録してください。
• Smithery — 現在の登録手順では、静的な設定ファイルではなく、実行中のサーバー URL または .mcpb バンドル（smithery mcp publish <url> -n <org/server>）を公開します。HTTP トランスポート（hood-mcp --http）を公開サーバーにデプロイしてから、 smithery mcp publish https://your-deployment/mcp -n nirholas/hood-mcp を実行してください。

ライセンス

All rights reserved. 詳しくは LICENSE を参照してください。

スター履歴

プロジェクトを応援する

robinhood-chain-mcp が時間の節約に役立ったら、GitHub でスターを付けてください。スターがあると、他の開発者や AI エージェントが信頼できるリポジトリを見つけやすくなります。クリックひとつで応援できます。

使ってくれそうな方をご存じですか？ X に投稿 · Bluesky で共有 · LinkedIn で共有 · Hacker News に投稿 · Reddit で共有

AI エージェントにも対応

コーディングエージェントや LLM ツールは、このリポジトリを直接参照できます：AGENTS.md、llms.txt、llms-full.txt。エージェントに https://github.com/nirholas/robinhood-chain-mcp を指定すれば、必要なコンテキストを取得できます。

同じ作者によるその他のプロジェクト

• nirholas のすべてのリポジトリ：トピック別に分類された全カタログ
• three.ws：Solana ウォレット、スキルマーケットプレイス、x402 決済に対応した 3D AI エージェント向けプラットフォーム
• 質問やアイデアはこちら：Issue を作成するか、ディスカッションを開始してください

コントリビューター