mcp-coinbase-cdp

@codespar/mcp-coinbase-cdp

Coinbase Developer Platform (CDP) 向けの MCP サーバーです。1 つのキーで 3 つの CDP 製品領域をカバーする単一の npm パッケージです。

• Trading — オンチェーンのスワップ／取引 API
• Wallets — スマート／組み込み／MPC ウォレットの基本機能
• Payments — オンチェーンの送金インフラストラクチャ

3 つすべてが同じ CDP アカウントを使用し、1 つの ES256 JWT 署名キーと 1 つのベース URL（https://api.cdp.coinbase.com）を共有するため、3 つのパッケージではなく 1 つのパッケージとして提供されます。

カタログ内の他の製品との位置付け

サーバー	Coinbase のサービス領域	認証
@codespar/mcp-coinbase	Advanced Trade 取引所（旧リテール向け）	HMAC API キー（CB-ACCESS-*）
@codespar/mcp-coinbase-commerce	Commerce 加盟店ゲートウェイ（チェックアウト時に BTC／ETH／USDC を受け付け）	API キー（X-CC-Api-Key）
@codespar/mcp-coinbase-cdp	Developer Platform（Trading + Wallets + Payments）	ES256 JWT（このパッケージ）

各サービス領域には、それぞれ異なる API ホスト、キーの種類、ダッシュボードがあります。認証情報は共有されません。利用したいサービス領域に適したキーを発行してください。

ツール（15）

Trading（4）

ツール	用途
list_quotes	認証済みの CDP アカウントで発行された最近のスワップ見積もりを一覧表示します。
create_swap	2 つの資産間でオンチェーンスワップを作成します。
get_swap	ID を指定してスワップを取得します。ステータス、実行額、ガス、トランザクションハッシュなどの詳細を確認できます。
cancel_swap	オンチェーンに反映される前の保留中のスワップをキャンセルします。

Wallets（7）

ツール	用途
create_wallet	新しいウォレット（スマート／組み込み／MPC）を作成します。
list_wallets	認証済みの CDP アカウントにあるウォレットを一覧表示します。
get_wallet	ID を指定してウォレットを取得します。
list_balances	すべてのアドレスとネットワークにおける資産残高を一覧表示します。
transfer	ウォレットから送金先アドレスへ送金します。
get_transaction	ID を指定してトランザクションを取得します。
list_transactions	ウォレットの過去のトランザクションを一覧表示します。

Payments（4）

ツール	用途
create_payment	オンチェーン決済（受取人への送金）を作成します。
list_payments	過去の決済を一覧表示します。
get_payment	ID を指定して決済を取得します。
cancel_payment	オンチェーンに反映される前の保留中の決済をキャンセルします。

インストール

npm install -g @codespar/mcp-coinbase-cdp

環境

COINBASE_CDP_KEY_NAME="organizations/<org>/apiKeys/<id>"
COINBASE_CDP_PRIVATE_KEY="-----BEGIN EC PRIVATE KEY-----
...
-----END EC PRIVATE KEY-----"

https://portal.cdp.coinbase.com でキーを発行し、PEM を 一度だけ ダウンロードしてください。後から再取得することはできません。同じキーで Trading、Wallets、Payments を認証します。

重要 — PEM は BEGIN／END 行を含む、複数行のブロック全体である必要があります。シェル環境変数で指定する場合は、二重引用符で囲み、改行を保持してください（または $'...'／.env ファイルを使用してください）。

認証

CDP はリクエストごとに新しい ES256 JWTを作成し、Authorization: Bearer … ヘッダーで各リクエストに署名します。

JWT クレーム（リクエストごと）：

クレーム	値
sub	COINBASE_CDP_KEY_NAME
iss	"cdp"
aud	["cdp_service"]
nbf	now（Unix 秒）
exp	now + 120
uri	"<METHOD> api.cdp.coinbase.com<path>"（パスにはクエリ文字列も含まれます）

JWT ヘッダー：

フィールド	値
alg	"ES256"
typ	"JWT"
kid	COINBASE_CDP_KEY_NAME
nonce	ランダムな 16 バイトの 16 進数文字列（リクエストごと）

COINBASE_CDP_PRIVATE_KEY の ECDSA P-256 秘密鍵で署名します。PEM は起動時に一度だけインポートされ、キャッシュされます。リクエストごとに作成されるのは JWT のみです。

実行

# stdio (default — for Claude Desktop, Cursor, etc.)
npx @codespar/mcp-coinbase-cdp

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-coinbase-cdp

エンタープライズ

エージェントが実行するオンチェーントランザクションに、ガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT