payagent-mcp

@arispay/payagent-mcp

AI エージェント向けの、一貫した USDC 決済プロダクトです。支出の委任、領収書、冪等性を備え、x402 で有料の API を呼び出せます。Claude Desktop、Cursor、Windsurf、または任意の MCP クライアントで動作します。payagent SDK を薄くラップしたものです。

ウォレットの保有方法は 2 通りです。

• ローカルキー（登録不要）。 資金を入金した EOA キーを PAYAGENT_PRIVATE_KEY に設定します。pay は EIP-3009 の署名をローカルで行うため、ArisPay アカウントもメールアドレスも不要です。唯一の安全策はウォレット残高です。残高の少ない専用ウォレットを使用してください。
• 委任カストディ（管理型、推奨）。 setup({ email }) を呼び出すと、アカウント、CDP 管理のウォレット、支出の委任を一度に自動設定できます。ArisPay は署名する前に、トランザクションごと、日ごと、月ごとの上限をサーバー側で適用します。このプロセス内に秘密鍵が保存されることはありません。

ツール

7 つのコアツール（デフォルトの構成）：

ツール	機能	資金
setup	アカウントと支払者ウォレットを一度の呼び出しで作成または復旧します（委任モード）	移動なし
discover	意図と予算に基づいて有料 API カタログを検索します	読み取り専用
inspect	支払いをせずに、URL の価格と支払い要件を確認します	読み取り専用
pay	機械処理の完全なフロー：リクエスト → 402 → バリアントの選択 → ポリシーの検証 → 支払い → 構造化された領収書。idempotencyKey が必須です。同じキーを再度使用すると、再度支払うことなくキャッシュ済みの領収書を返します	実際に資金を消費します
balance	有効な ID、入金アドレス、オンチェーンの USDC 残高、委任の上限を確認します	読み取り専用
history	最近の支払いを確認します。サーバーフィード（委任モード）またはローカルの領収書（セルフカストディ）を表示します	読み取り専用
check_payment_signal	ArisPay Signal を購入します。x402 リソースについて、最近の署名済みプローブ証拠（実際の有料プローブが決済され、データを配信したか）を取得します。有効期間内のキャッシュ済みアーティファクトがあれば支出せずに返し、未知のリソースには無料で回答します	キャッシュされていない呼び出しごとに 1¢ を消費します

ウォレット管理（create_agent、fund_agent、list_agents、rename_agent）は、ホスト設定で PAYAGENT_MCP_PROFILE=admin が設定されている場合にのみ読み込まれます。

各ツールは MCP の安全性アノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）を宣言します。破壊的なツールは pay と check_payment_signal のみで、どちらも実際に資金を消費します。

対応状況

資産	ネットワーク	ローカルキー（セルフカストディ）	委任（管理型の支出委任）
USDC	Base（デフォルト）	✅	✅
USDC	Ethereum、Polygon	✅	✅
USDC	Base Sepolia（テストネット）	✅	✅
USDC (SPL)	Solana、Solana devnet	❌（EVM 署名のみ）	✅（2026-08-25 から api.arispay.app で稼働）
USD1	BNB Chain	✅	✅

注：

• 価格はすべて、402 チャレンジで販売者が提示します。pay は EVM バリアントを優先し、販売者が EVM の選択肢を提供していない場合は Solana にフォールバックします。
• 委任の上限は整数のセント単位で、署名が生成される前にサーバー側で検証されます。ローカルモードにはサーバー側の上限はありません。
• 決済は単一のオンチェーン transferWithAuthorization（EIP-3009）で行われ、成功するか、原子的にリバートします。販売者が X-PAYMENT-RESPONSE を返す場合、領収書には決済トランザクションのハッシュが含まれます。
• ArisPay 独自のファシリテーター（facilitator.arispay.app）はファシリテーター手数料を請求しません。販売者は任意のファシリテーターを使用でき、その手数料とファイナリティポリシーが適用されます。

セットアップ

MCP クライアントの設定にサーバーを追加します。環境変数は不要です。ウォレットモードは後からチャット内で選ぶか、以下の環境変数オプションを設定してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "arispay": {
      "command": "npx",
      "args": ["-y", "@arispay/payagent-mcp"]
    }
  }
}

登録不要モードを使用するには、env ブロックにキーを追加します。

      "env": { "PAYAGENT_PRIVATE_KEY": "0x..." }

Cursor

.cursor/mcp.json に同じサーバーブロックを追加します。Windsurf： ~/.codeium/windsurf/mcp_config.json に同じパターンで追加します。

ゼロから始めるコールドスタート

• 登録不要： npx payagent wallet new でキーを生成し、ホスト設定の PAYAGENT_PRIVATE_KEY に設定して、表示されたアドレスに Base 上の USDC を送金します。balance で入金先アドレスを確認でき、pay で支払います。
• マネージド： エージェントに setup({ email: "[email protected]" }) を実行するよう依頼します。ウォレットアドレスとマンデートが返されます。ウォレットに USDC を入金し、balance で確認してから pay を実行します。認証情報は ~/.payagent/config.json に保存され、payagent CLI と共有されます。

環境変数（すべて任意）

変数	説明
PAYAGENT_PRIVATE_KEY	ローカルでセルフカストディ署名を行うための入金済み EOA キー（登録不要モード）。
ARISPAY_API_KEY	開発者キー。通常は不要です。setup が自動でプロビジョニングします。
ARISPAY_URL	ArisPay API のベース URL。デフォルトは https://api.arispay.app です。
PAYAGENT_MCP_PROFILE	admin を指定すると、ウォレット管理用の 4 つのツールも読み込みます。デフォルト：core（7 つのツール）。
ARISPAY_AGENT_KEY / PAYAGENT_WALLET	v2.0.x ホスト向けのレガシーな単一エージェントのペア。

v3 からの移行

v4 は破壊的変更を含むリリースです。機能は 1 つの x402/USDC プロダクトに集約されました。

v3 のツール	v4
create_user	setup
pay_api	pay（idempotencyKey が必須になり、構造化されたレシートを返します）
discover_paid_api	discover
inspect_paid_api	inspect
check_wallet, get_balance_agent	balance
—	history（新規）
create_agent, fund_agent, list_agents, rename_agent	変更なし。PAYAGENT_MCP_PROFILE=admin の場合に利用できます
create_wallet, list_wallets, fund_wallet, get_balance, pay_merchant, create_enduser, attach_card_for_user, set_user_limits, get_user_status	削除。法定通貨による入金機能とプラットフォーム（エンドユーザー）機能は、公開 MCP から除外されました

レシートと冪等性

pay では、呼び出し側が指定する idempotencyKey（8 文字以上。UUID を使用してください）が必須です。支払いが完了するたびに、機械可読なレシート（額、アセット、ネットワーク、ウォレット、決済トランザクション、残りのマンデート）が ~/.payagent/mcp-receipts.json に記録されます。支払い済みのキーを指定して pay を再度呼び出すと、保存済みのレシートが返され、再度支払われることはありません。支払いリクエストが処理中に失敗した場合も同様です。セルフカストディモードでは history にレシートが一覧表示され、委任モードでは信頼できるサーバーフィードが読み取られます。

仕組み

1. エージェントが URL と idempotencyKey を指定して pay を呼び出すと、販売者は価格とともに HTTP 402 を返します。
2. PAYAGENT_PRIVATE_KEY が設定されている場合、payagent は EIP-3009 認証にローカルで署名します。設定されていない場合は、ArisPay がエージェントのマンデートに照らしてリクエストを検証し、Coinbase CDP 経由で署名します。
3. payagent は署名済みの支払いヘッダーを付けて再試行し、販売者のファシリテーターがオンチェーンで USDC の決済を行います。
4. ツールは支払い済みのレスポンスと構造化されたレシートを返します。

委任モードでは、このプロセス内に秘密鍵は存在せず、マンデートに違反する支払いはオンチェーン処理が行われる前に拒否されます。ローカルモードでは、キーは利用者自身のものであり、プロセス内に保持されます。

インストール

npm install @arispay/payagent-mcp

または、MCP クライアント設定から npx @arispay/payagent-mcp を直接呼び出すこともできます。事前インストールは不要です。npx buyforme-mcp は、消費者向けブランド名で提供される同じサーバーです。

関連情報

• payagent — プログラムから利用するための SDK と CLI
• facilitator.arispay.app — 支払いを伴う 402 の決済を処理する、ArisPay のオープンな x402 ファシリテーター
• x402 protocol — HTTP 402 支払い標準

ライセンス

MIT