Hyperd Mcp

hyperD MCP サーバー

有料の hyperD x402 ツールを24種類公開します。17種類のデータ／リスクエンドポイント、6種類のプレミアム統合判定（$0.30～$1.50）、複数回の呼び出しをまとめるバンドルに加え、無料のメタツールを3種類（有効にすると監視ツールも3種類）利用できます。提供元は api.hyperd.ai です。Claude Desktop、Cursor、Cline、Zed、その他のMCP対応クライアントに追加できます。

できること

各ツールの呼び出しでは、次の処理が行われます。

1. 対応する api.hyperd.ai エンドポイントにリクエストを送信します
2. 支払い要件を含むHTTP 402を受信します
3. ウォレットを使ってEIP-3009のUSDC送金認証に署名します
4. 支払いヘッダーを付けて再試行します
5. データをAIアシスタントに返します

呼び出しごとに、Base上で**$0.005～$1.50相当のUSDC**を支払います。データ／リスクエンドポイントは$0.005～$0.10、プレミアム統合判定は$0.30～$1.50です。サブスクリプションやアカウントは不要です。

無料で試す

IPごとに24時間あたり最初の5回は無料です。ウォレット、登録、APIキーは不要です。curlを実行するだけです。

curl "https://api.hyperd.ai/api/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

生涯利用上限はIPごとに10回です。上限に達した後（または1日の無料枠を使い切った後）は、エンドポイントからHTTP 402が返されます。Python SDKまたはTypeScript MCP サーバーを使って、Base上で少額のEIP-3009 USDC支払いに署名してください。プレミアム統合判定の料金は$0.30以上で、常に支払いが必要です。無料枠の対象にはなりません。

/api/wallet/pnl の無料枠は、処理負荷の高いアップストリームを利用するため、IPあたり1日1回に制限されています。

必要なもの

• Base上に少なくとも$0.30相当のUSDCがあるウォレット（すべてのツールを一度ずつ試すための初期費用は約$0.62です）
• ウォレットの秘密鍵、または12単語のBIP-39ニーモニック
• インストール済みのNode 20以降

インストールと設定

ステップ1 — ウォレットを新規作成するか、既存のウォレットを使う

テストには、**メインのウォレットではなく、新しいウォレットを使ってください。**簡単な方法は次のとおりです。

node -e "const {generatePrivateKey, privateKeyToAccount} = require('viem/accounts'); const pk = generatePrivateKey(); console.log('Address:', privateKeyToAccount(pk).address); console.log('Private key:', pk);"

表示されたアドレスに、Base上で約$1相当のUSDCを送金してください。

ステップ2 — Claude Desktop

Claude Desktopの設定ファイルを編集します（場所：macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "hyperd": {
      "command": "npx",
      "args": ["-y", "hyperd-mcp"],
      "env": {
        "HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

Claude Desktopを再起動します。会話のツール一覧にhyperDツールが表示されます。

ステップ3 — 試してみる

任意の会話でClaudeに次のように尋ねます。

「Base上のUSDCのセキュリティスコアは？ hyperd.token.securityツールを使ってください。」

Claudeがエンドポイントを呼び出し、ウォレットから$0.05を支払い、結果を返します。一連の処理は約2秒で完了します。

Cursor / Cline / Zed

MCP対応クライアントにはそれぞれ同様の設定ファイルがあります。同じ設定パターンを使います。サーバー名を hyperd、コマンドを npx -y hyperd-mcp にして、HYPERD_WALLET_PRIVATE_KEY 環境変数を設定してください。

MCPクライアントの一覧と、クライアントごとの設定方法については https://modelcontextprotocol.io/clients をご覧ください。

ローカル開発用のインストール（npm公開なし）

npx ではなくソースから実行する場合は、次の手順を行います。

git clone https://github.com/hyperd-ai/hyperd-mcp.git
cd hyperd-mcp
npm install
npm run build

続いて、Claude Desktopの設定でローカルビルドを指定します。

{
  "mcpServers": {
    "hyperd": {
      "command": "node",
      "args": ["/full/path/to/hyperd-mcp/dist/server.js"],
      "env": {
        "HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

利用可能なツール

ツール	価格	機能
hyperd.balance.get	$0.01	複数チェーンに対応した ERC-20 およびネイティブ残高の照会
hyperd.yield.recommend	$0.05	独自の判断基準に基づく DeFi 利回りの推奨
hyperd.token.info	$0.01	統合されたトークンメタデータ（CoinGecko + DefiLlama）
hyperd.token.security	$0.05	GoPlus に基づくセキュリティリスクスコア
hyperd.wallet.risk	$0.10	Chainalysis の制裁対象情報 + GoPlus のヒューリスティクス
hyperd.protocol.tvl	$0.01	DefiLlama によるプロトコルの健全性評価
hyperd.gas.estimate	$0.005	チップのパーセンタイルを含むガスオラクル
hyperd.dex.quote	$0.02	複数アグリゲーターから最適な DEX ルートを提示
hyperd.wallet.persona	$0.10	ウォレットの行動分類
hyperd.contract.audit	$0.10	取引前のコントラクトセキュリティ複合評価
hyperd.governance.summarize	$0.10	LLM による DAO 提案の要約
hyperd.sentiment.token	$0.05	Farcaster から取得するトークンのセンチメント
hyperd.liquidation.risk	$0.10	複数プロトコルにまたがる清算リスク（Aave V3 / Compound v3 / Spark / Morpho）
hyperd.wallet.anomaly	$0.10	180 日間の基準値との比較によるウォレットの異常検知
hyperd.wallet.pnl	$0.05	実現損益 + 未実現損益（FIFO/LIFO/HCFO）
hyperd.budget.guardian	$0.01	エージェントによる USDC 支出の可視化 + 上限チェック
hyperd.bundle	$0.20 固定	複数の呼び出し：1 回の決済で有料 GET を 1～10 件実行
hyperd.watch.create	$3.00 前払い	継続的な清算監視を申し込む（HMAC ウェブフック）
hyperd.watch.list	（所有者は無料）	有効な監視の一覧を表示
hyperd.watch.cancel	（所有者は無料）	監視を 1 件キャンセル

統合評価ティア — 複合判定（Haiku 4.5、v1.1.0）

各統合評価ツールは複数のサブコールを内部で実行し、Claude Haiku 4.5 が作成した単一の verdict + inputs + methodology.version + coverage エンベロープを返します。

ツール	価格	機能
hyperd.risk.full_audit	$0.35	ウォレットリスクの複合評価：残高 + 制裁対象情報 + ペルソナ + コントラクト + ミキサー。区分：safe / moderate / elevated / critical。
hyperd.token.archetype	$0.30	トークン分類：stablecoin / blue_chip / mid_cap / memecoin / wrapped / governance / unverified。
hyperd.wallet.thesis	$0.50	行動に関する平易な説明：trader / hodler / yield_farmer / mev_bot / compromised / inactive。
hyperd.wallet.threat_brief	$1.50	2～3 文のセキュリティ判定：clean / watch / elevated / critical。
hyperd.gov.translate	$1.00	Snapshot/Tally の提案を平易な言葉で説明（キャッシュ期間 1 年）。
hyperd.yield.allocation	$1.00	指定金額をリスクティアごとにポートフォリオ配分（キャッシュ期間 6 時間）。

HTTP API のドキュメント全文：https://api.hyperd.ai/api/discover

セキュリティ

• プライマリウォレットではなく、ホットウォレットを使用してください。 MCP サーバーの実行中、秘密鍵はプロセスメモリ内に保持されます。
• 利用する金額だけを送金して、支出に上限を設けてください。 組み込みの支出上限はありません。ウォレットの残高がそのまま上限になります。
• 秘密鍵をコミットしないでください。 Claude Desktop の設定ファイルはローカルに保存されます。共有しないでください。

秘密鍵の代わりにニーモニックを使用する設定

生の秘密鍵の代わりに 12 語または 24 語の BIP-39 ニーモニックを使用する場合：

"env": {
  "HYPERD_WALLET_MNEMONIC": "word1 word2 ... word12"
}

標準の Ethereum パス m/44'/60'/0'/0/0 から導出します。

任意の環境変数

• HYPERD_API_BASE — デフォルトは https://api.hyperd.ai です。テストネットまたはセルフホスト環境向けに上書きできます。
• HYPERD_BASE_RPC — デフォルトは公開 Base RPC です。より高いレート制限が必要な場合は上書きしてください。

リモート MCP-over-HTTPS（インストール不要）

stdio サーバーをローカルで実行したくない場合は、hyperD の全ツールカタログをリモート MCP サーバーとしても利用できます。

POST https://api.hyperd.ai/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

同じ 24 個の有料ツール、同じ無料枠（1 日あたり IP ごとに 5 回、生涯で 10 回）、無料枠を超えた後の有料呼び出しで同じ X-Payment 認証モデルを利用できます。npm install も IDE ごとの設定も不要で、URL だけで利用できます。

次のような場合に便利です：

• stdio プロセスを同梱せず、サーバーレスプラットフォーム（Vercel、Lambda）にエージェントをデプロイする場合
• リモート URL を必要とする MCP 対応サービス（Smithery enterprise、ホスト型ゲートウェイ）を使用する場合
• ローカルにインストールする前に、コマンドラインから curl で API の機能をテストする場合

サーバーカード：https://api.hyperd.ai/.well-known/mcp.json。

ライセンス

親リポジトリと同じ MIT です。