hoodgrow-mcp

このパッケージは提供を終了しました

ステータス：2026年8月に終了。 メンテナンスされていません。ラップしている HoodGrow API は停止しているため、ここにあるすべてのツールはネットワーク呼び出しで失敗します。ホスト型サーバーの https://www.hoodgrow.com/api/mcp は閉鎖され、npm パッケージは非推奨になっています。

理由

HoodGrow には有料顧客がなく、生涯収益は $0.81 でした。原因はこのパッケージではありません。API が提供していたデータのほとんどは、Robinhood 独自のレジストリで無料公開されており、チェーンから直接読み取れます。そのため、有料のコピーは、HTTP 呼び出しを1回行うだけで無料の代替手段を利用できるコモディティでした。詳しい説明はHoodGrow の READMEをご覧ください。

今でも読む価値があります

これは、完全に動作する MCP サーバーです。誠実なアノテーションを備えた14個のツール（従量課金モードでは、再試行された呼び出しが再度課金されるため、idempotentHint は false です。多くのサーバーが誤っている点です）、x402 決済、前払いクレジット、ベアラー認証を1つのクライアントで提供します。公式 MCP レジストリに掲載され、ディレクトリの審査にも合格しました。MCP サーバーを構築するなら、ここにある仕組みは今でも役立ちます。

hoodgrow-mcp

HoodGrow の Robinhood Chain 株式トークン API 用 MCP（Model Context Protocol）サーバーです。ライブ価格、企業アクション調整済みの供給量（ERC-8056、株式分割に正しく対応）、Morpho／Uniswap の DeFi 板情報、企業アクション（株式分割、配当）、保有者分析、取引の価格インパクト／スリッページ推定、バックテスト用 OHLC 価格ローソク足、値上がり銘柄、巨額取引（「クジラ」）フィード、Base メインネットの B20 ネイティブ株式トークンレジストリを、あらゆる MCP クライアント（Claude Desktop、Claude Code など）で使えるツールとして提供します。hoodgrow SDK を基盤としており、x402（Base 上の USDC）による呼び出しごとの支払い、またはベアラー API キーを利用できます。選択は自由です。

最速の方法：ホスト型サーバー（インストール不要、キー不要）

HoodGrow が https://www.hoodgrow.com/api/mcp で MCP サーバーを運用しています。すべてのツールは読み取り専用なので、アシスタントに接続すれば、インストール、登録、キーなしですぐに質問できます。

claude mcp add --transport http hoodgrow https://www.hoodgrow.com/api/mcp

または mcp.json ／ claude_desktop_config.json に記述します。

{
  "mcpServers": {
    "hoodgrow": { "type": "http", "url": "https://www.hoodgrow.com/api/mcp" }
  }
}

次のような質問をアシスタントにしてみましょう。

• 「Robinhood Chain 上の NVDA の企業アクション調整済み供給量と24時間取引高は？」
• 「今後1週間に予定されている株式分割や配当はありますか？」
• 「今日の値上がり上位銘柄と最大のクジラ取引は？」

get_catalog は、上場しているすべてのトークンのライブ価格、24時間変動率、調整済み供給量を返します。匿名で利用でき、回数制限もなく、キーも不要です。銘柄ごとのツールを初めて呼び出すと、無料の API キーまたは x402 による支払いを求められます。匿名アクセスは IP ごとに毎分20リクエストまでに制限されています。これは課金ではなく、不正利用を抑制するための措置で、カタログにも適用されます。

以前は銘柄ごとのツールに匿名利用者向けの日次予算が設定されていましたが、現在はありません。呼び出し元の IP に紐づく予算では、共有された送信元 IP を使うすべての利用者に対してアドレスごとに新しい予算が適用されるため、結局ペイウォールに到達させることができませんでした。サーバーを自分で実行するか、x402 による従量課金を利用したい場合は、代わりに npm パッケージを使ってください。

自分で実行する（npm — 自分の認証情報）

認証情報は任意です。 設定しなくても、サーバーは起動して動作します。 get_catalog は無料で、利用回数に制限はありません。それ以外のすべてのツールは、初回の呼び出し時に API の 402 を返し、代替手段を示す読みやすいツールエラーが表示されます。利用するには、次のいずれかを設定してください。

• API キー、無料、セルフサービス — hoodgrow.com/profile から取得できる HOODGROW_API_KEY。1 日あたりの利用枠が増え、同じ IP のほかのユーザーが消費できない予算を設定できます。
• x402、呼び出しごとに支払い、登録不要 — Base 上の USDC で資金を追加したウォレットの秘密鍵（HOODGROW_PRIVATE_KEY）。有料エンドポイントは 1 回の呼び出しにつき $0.05 で、1 日あたりの上限はありません。

このパッケージに HoodGrow の共有認証情報が含まれることはないため、支出額と請求先を自分で管理できます。

Claude Desktop / Claude Code

MCP 設定に追加します（Claude Desktop の場合：claude_desktop_config.json、Claude Code の場合：claude mcp add）。

{
  "mcpServers": {
    "hoodgrow": {
      "command": "npx",
      "args": ["-y", "hoodgrow-mcp"],
      "env": {
        "HOODGROW_PRIVATE_KEY": "0x..."
      }
    }
  }
}

または、代わりに API キーを使う場合：

{
  "mcpServers": {
    "hoodgrow": {
      "command": "npx",
      "args": ["-y", "hoodgrow-mcp"],
      "env": {
        "HOODGROW_API_KEY": "..."
      }
    }
  }
}

実際の秘密鍵をコミット済みの設定ファイルにハードコードしないでください。そのウォレットには、この API に使ってもよい金額だけを入れてください。

任意で、buy_credits ツールを使ってクレジット残高を購入した後、HOODGROW_PRIVATE_KEY と並べて "HOODGROW_USE_CREDITS": "true" を追加すると、すべてのデータツールで x402 の呼び出しごとの支払いの代わりに、その残高を使うようになります（安価なウォレット署名で利用できます）。詳しくは、以下の「プリペイドクレジット」を参照してください。

ツール

ツール	価格（x402）	説明
get_catalog	無料	一覧にあるすべてのトークンのシンボル、名称、アドレス、価格、情報源、24時間の変動率、コーポレートアクション調整後の供給量に加え、カタログ全体の保留中および最近のコーポレートアクションを返します。トークンごとの DeFi 情報は含まれません。get_token／get_defi をご覧ください
get_token	$0.05	シンボル（例：NVDA）で指定した1つのトークンについて、同じ項目と DeFi の深度を返します
get_corporate_actions	上記の get_token／get_catalog を使用	保留中および最近のコーポレートアクションを返します。対象を絞るにはシンボルを指定し、追跡対象のすべてのトークンを対象にするには省略します
get_defi	$0.05	トークンが参加しているすべての Morpho マーケット（貸付または担保のいずれかの役割）と、そのトークンの Uniswap V3 プールを返します。get_token に表示される最高 APY の単一の数値だけではありません
get_holders	$0.05	保有者数の推移、24時間の純供給量変化（実際のミント／バーン）、上位保有者の集中度を返します（limit は省略可能で、1～50。デフォルトは10です）
get_slippage	$0.05	米ドル建ての取引（side: "buy" | "sell"）によって価格がどれだけ動くかを、Uniswap V3 のプールごとに返します。最適なプールを選ぶ bestPoolAddress／bestEffectivePrice も含まれます
get_ohlc	$0.05	バックテスト用の OHLC 価格ローソク足（interval: "1h" | "4h" | "1d"、from／to／limit は省略可能で、デフォルトは過去30日間）。各ローソク足には volumeUsd／swapCount（トークンの Uniswap V3 プール全体における米ドル建てのスワップ量）が含まれます。出来高インデクサーのバックフィル期間より古いバケットでは null になります
get_base_tokens	$0.05	Base メインネット（チェーン 8453）の B20 ネイティブ株式トークンレジストリです。get_catalog の対象を大幅に絞ったものです。ローンチ前：取引可能と見なす前に、各トークンの status を確認してください。"pre_launch" は、そのトークンにはまだ価格、DEX 流動性、保有者が存在しないことを意味します
get_markets	$0.05	カタログ全体の市場動向を返します。上昇率／下落率上位（24時間の変動率）、24時間のスワップ量が最も多い銘柄、Uniswap V3 の流動性（TVL）が最も深い銘柄が含まれます。limit は省略可能（1～50、デフォルトは10）です。市場に大きな変動がない場合、上昇率／下落率上位が空になることがあります
get_trades	$0.05	株式トークンの Uniswap V3 プールにおける最近の大口（「クジラ」）取引を新しい順に返します。各取引には side（"buy" | "sell"）、米ドル建ての取引額、txHash が含まれます。全体のフィードを取得するには symbol を省略します。limit は省略可能（1～100、デフォルトは20）です
list_credit_bundles	無料	現在の前払いクレジットバンドルのカタログ（{id: {priceUsd, creditUsd}}）を返します。認証情報は不要です
buy_credits	x402 で1回支払い	1つのバンドルの料金を支払います（bundleId 引数）。HOODGROW_PRIVATE_KEY が必要です。決済が確定すると残高に反映されます。get_credit_balance で確認してください
get_credit_balance	無料	このウォレットの現在のクレジット残高を返します。HOODGROW_PRIVATE_KEY が必要です
register_credit_webhook	登録は無料、その後はイベントの配信ごとに課金	クレジットで利用するコーポレートアクションのウェブフックを登録します（url、symbols は省略可能）。HOODGROW_PRIVATE_KEY が必要です。HoodGrow は各 corporate_action.* イベントを x-hoodgrow-signature で署名して url に POST します。symbols を指定すると、配信対象（およびイベントごとの課金対象）をそのトークンに限定します。すべてを対象にする場合は省略してください。webhookSecret が返されます（表示は1回のみ）。ビルダーサブスクリプションのウェブフックはウェブサイトから設定します

各呼び出しは、API の JSON レスポンスをツールのテキストコンテンツとして返します。リクエストに失敗した場合（不明なシンボル、サーバーエラーなど）はサーバーがクラッシュするのではなく、MCP ツールエラー（isError: true）が返されます。

前払いクレジット

x402 を使って米ドル建てのクレジット残高を一度購入（buy_credits）した後、HOODGROW_PRIVATE_KEY とともに HOODGROW_USE_CREDITS=true を設定してサーバーを再起動してください。以降、上記のすべてのデータツールは、呼び出しごとに新たなオンチェーン x402 支払いを行う代わりに、低コストでガス代不要のウォレット署名を使って残高を消費します。list_credit_bundles／get_credit_balance はクレジットを消費しません。料金が発生するデータツール（get_catalog、get_token など）と buy_credits のみが支払いを行います。

支払いの安全性

x402 による支払いは実際の金銭を伴い、冪等ではありません。タイムアウトした呼び出しを再試行すると、二重に支払う可能性があります。HoodGrow のペイウォールが要求するのは、Base メインネット（eip155:8453）上の USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）のみで、支払い先は 0x8520B3693a2Cf3c2bEa3a505Af3A9c1b093954c7、上限は 1 回の呼び出しにつき $0.05 です。基盤となる hoodgrow／@x402 依存関係はプロトコルレベルの検証を処理しますが、署名用ウォレットにいくら入金するかはご自身で管理してください。

レート制限

ペイ・パー・コールでの利用では、デフォルトで IP ごとに 1 分あたり 30 リクエストです。

認証情報がまったくない場合でも、get_catalog は応答します。無料かつ無制限で、その他すべてのツールは初回の呼び出しで 402 を返します。

無料の API キーを使う場合、1 日の利用枠は 40 単位です。

呼び出し	単位	無料プランでの 1 日あたりの呼び出し回数
get_catalog（1 回の応答ですべてのトークンを取得）	0	無制限 — 無料です
任意の単一シンボル用ツール	1	40
ライブネスチェック	0	無制限

1 つのシンボルを取得する場合は、引き続き get_catalog より get_token をおすすめします。現在は料金が安いからではなく、解析するデータ量がはるかに少なく、カタログには含まれないそのトークンの DeFi の詳細情報が得られるためです。

x402 のペイ・パー・コールには 1 日あたりの上限がありません（有料エンドポイントは 1 回につき $0.05、カタログはどちらの場合も無料です）。また、Builder を利用すると上限がなくなり、1 分あたりの制限が 300 に引き上げられます。詳しくは docs.hoodgrow.com をご覧ください。

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (mocked fetch + real in-memory MCP client/server, no network)

ライセンス

MIT