x402-api

@x402-api/mcp-server

Claude、ChatGPT、およびMCP互換のあらゆるAIエージェントが、x402 protocolを通じて、呼び出しごとに支払う暗号資産／DeFiデータを利用できるMCP サーバーです。

8個のツール。APIキー不要。AIエージェントはリクエストごとにBase上でUSDCのマイクロペイメントを支払います。

このサービスを探す： 公式MCPレジストリ · Glama · エージェント検出マニフェスト · OpenAPI。

  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
    ╚███╔╝ ███████║██║   ██║ █████╔╝
    ██╔██╗ ╚════██║██║   ██║██╔═══╝
   ██╔╝ ██╗     ██║╚██████╔╝███████╗
   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

ツール

ツール	APIエンドポイント	費用	説明
get_crypto_prices	GET /api/price-feed	0.001 USDC	BTC／ETH／SOLと、24時間の値上がり上位銘柄
get_gas_prices	GET /api/gas-tracker	0.001 USDC	マルチチェーンのガス価格（ETH、Base、Polygon、Arbitrum）
get_dex_quotes	GET /api/dex-quotes	0.002 USDC	ParaSwapの集約ルートを1件
scan_token	GET /api/token-scanner	0.003 USDC	GoPlusのセキュリティフラグとヒューリスティック
track_whales	GET /api/whale-tracker	0.005 USDC	上位保有者のサンプルと供給量に占める割合
scan_yields	GET /api/yield-scanner	0.005 USDC	DefiLlamaのプールAPYとTVL
get_funding_rates	GET /api/funding-rates	0.008 USDC	HyperliquidとdYdXの時間ごとのレート
profile_wallet	GET /api/wallet-profiler	0.008 USDC	観測されたBlockscoutの残高。一部のみ対応

---

クイックスタート

オプションA：確認モード（支払い不要）

実行するだけです。402レスポンスが返された場合は、読みやすい支払い手順が表示されます。

npx @x402-api/mcp-server

ツールで支払いが必要な場合、Claudeが必要な内容を知らせます。

オプションB：自動支払いモード（完全自律型）

オプションの支払い用依存関係をインストールし、ウォレットキーを設定します。

npm install -g @x402-api/mcp-server
npm install -g viem
export X402_WALLET_PRIVATE_KEY=0x<your_private_key>
x402-api-mcp

MCP サーバーは、APIがその決済方式を提示している場合に限り、Base USDC EIP-3009認証に署名します。デフォルトの支払い上限は1回の呼び出しにつき0.01 USDCです。ウォレットにBase上のUSDCを入金してください。直接決済方式では、API運営者がガス代を負担します。

---

Claude Desktopとの統合

claude_desktop_config.jsonに追加します。

自動支払いなし（確認モード）

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"]
    }
  }
}

自動支払いあり

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"],
      "env": {
        "X402_WALLET_PRIVATE_KEY": "0x<your_private_key>"
      }
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

---

環境変数

変数	必須	説明
X402_WALLET_PRIVATE_KEY	任意	EIP-3009自動支払い用のBaseウォレット秘密鍵です。viemが必要です。
X402_MAX_PER_CALL_USDC	任意	1回の呼び出しあたりの上限です。デフォルトは0.01 USDCです。
X402_API_BASE_URL	任意	API URLを上書きします（デフォルト：https://x402-api.fly.dev）

---

x402の支払いの仕組み

このAPIはx402 protocol（HTTP 402 Payment Required）を使用します。

1. エージェントがツールを呼び出す → MCP サーバーがAPIリクエストを送信します
2. サーバーが支払い詳細（額、USDCアドレス、Baseネットワーク）とともに402を返す
3. 自動支払いモード： このクライアントがEIP-3009認証に署名して再試行し、APIがBase上で決済します
4. 確認モード： MCPは署名や支払いを行わずに402の詳細を返します

支払いの詳細：

• トークン：Baseメインネット上のUSDC
• アドレス：0x60264c480b67adb557efEd22Cf0e7ceA792DefB7
• チェーン：Base（チェーンID 8453）
• 金額：呼び出しごとに0.001～0.008 USDC（米ドルで1セント未満）

---

ツールリファレンス

get_crypto_prices

パラメーターはありません。BTC、ETH、SOLの現在価格と、24時間の値上がり上位銘柄を返します。

Cost: 0.001 USDC

get_gas_prices

パラメーターはありません。Ethereum、Base、Polygon、Arbitrumのガス価格を、低速／標準／高速の各ティアで返します。

Cost: 0.001 USDC

get_dex_quotes

ParaSwap の集約ルートを1つ取得します。DEX 間の独立した比較は行いません。

パラメーター	型	必須	説明
from	string	✅	入力トークン（例："ETH"、"0x..."）
to	string	✅	出力トークン（例："USDC"）
amount	string	✅	スワップする数量（例："1.5"）

Cost: 0.002 USDC

scan_token

トークンのセキュリティスキャンです。ラグプルの兆候、ハニーポットのパターン、ミント権限などを検出します。

パラメーター	型	必須	説明
token	string	✅	コントラクトアドレスまたはシンボル（例："PEPE"）

Cost: 0.003 USDC

track_whales

GoPlus から上位保有者のサンプルを取得します。ジニ係数と最近の送金履歴は利用できません。

パラメーター	型	必須	説明
token	string	✅	コントラクトアドレスまたはシンボル

Cost: 0.005 USDC

scan_yields

Aave、Compound、Morpho、Lido、Pendle などの DeFi 利回り機会を上位から取得します。

パラメーター	型	必須	説明
chain	string	❌	チェーンで絞り込みます。"ethereum"、"base"、"arbitrum"、"polygon"を指定します
min_tvl	number	❌	USD 建ての最小 TVL（例：1000000）

Cost: 0.005 USDC

get_funding_rates

Hyperliquid と dYdX v4 のパーペチュアルの1時間ごとの資金調達率を取得します。スプレッドは参考値です。

パラメーター	型	必須	説明
asset	string	❌	アセットのシンボル（例："BTC"、"ETH"）。省略するとすべてのアセットが対象です。

Cost: 0.008 USDC

profile_wallet

価格が判明しているウォレット残高と、利用可能なトランザクション数を取得します。DeFi ポジション、損益、リスクスコアは利用できません。

パラメーター	型	必須	説明
address	string	✅	Ethereum/Base ウォレットアドレス（0x...）

Cost: 0.008 USDC

---

開発

git clone https://github.com/fernsugi/x402-api-mcp-server
cd x402-api-mcp-server

npm install
npm run build
npm start

支払い用ウォレットなしでテストするには、そのまま実行して 402 レスポンスを確認します。

node dist/index.js

---

リンク

• x402 API ランディングページ
• x402 プロトコル
• Base チェーン
• ERC-8004 エージェント ID
• BaseScan 上のエージェント #18763

---

ライセンス

MIT

実行可能なワークフロー3つ

ワークフロー	ツール	USDC 合計
トークンチェック	scan_token + track_whales	0.008
ETH 資金調達率	get_funding_rates	0.008
スワップ見積もり + ガス代	get_dex_quotes + get_gas_prices	0.003

実行可能な Node の例は、インスペクトモードで開始します。各デモには入力項目、記録済みのプロバイダー出力、対象範囲の制限、支出上限、エージェントプロンプトがあります。

省略可能な X402_REFERRAL_SOURCE は、ファーストパーティの集計アトリビューション用にリクエストを識別します（デフォルトは mcp）。これはヒントであり、呼び出し元の本人確認にはなりません。API は生の支払者ウォレット、IP アドレス、署名を記録しません。X402_EXPECTED_PAY_TO は、デフォルトで支払い先を公式ウォレットに固定します。ツールには、自動支払いで費用が発生する可能性があり、呼び出しを繰り返すと再度請求される場合があることが明示されています。

Cursor / その他のローカル MCP クライアント

上記と同じ mcpServers 設定を使用します。Cursor の場合は、プロジェクト内の .cursor/mcp.json に設定します。インスペクトモードではウォレットは不要です。自動支払いを有効にする前に X402_MAX_PER_CALL_USDC を設定してください。呼び出しを繰り返すと再度支出が発生します。ウォレットの認証情報はローカルの環境設定に保存し、Git の管理対象外にしてください。

レジストリへの公開

Publish MCP Registry GitHub ワークフローは、対応する npm のバージョンを検証した後、GitHub OIDC を使用して server.json を公開します。GitHub リリースの公開時、または main からの手動実行時に動作します。CI には npm トークン、GitHub PAT、ウォレットキーを保存しません。Actions と公式パブリッシャーのソースは、検証済みのコミットに固定されています。npm への公開は、リリースを作成する前に別途行います。