Xenarch — X402 Mcp Server For Ai Agent Payments

Xenarch — AI エージェントによる決済のための x402 MCP サーバー

Xenarch は、非カストディアル型の x402 MCP サーバーです。Claude、Cursor、LangChain、CrewAI などの AI エージェントは、Base L2 上の USDC マイクロペイメントで、HTTP 402 によるアクセス制限がある API やコンテンツの料金を支払います。API キーもサブスクリプションも、登録済みのクレジットカードも不要です。エージェントのウォレットに ETH は必要ありません。保有するトークンは USDC のみです。支払いはオンチェーンで直接決済されます。エージェントのウォレットからパブリッシャーのウォレットへ送金されます。Xenarch の手数料は 0% です。資金の流れに Xenarch のコントラクトは介在しません。

Xenarch の特長

仕組み

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, accepts: [...] }

2. Pay         xenarch_pay("example.com")
               → x402-fetch signs an EIP-3009 USDC transferWithAuthorization
               → Settlement goes on-chain
               → Re-fetches the resource with proof of payment
               → { tx_hash, content }

API キーも登録も不要です。エージェントのウォレットに必要なのは USDC のみです。ETH も、いかなる種類のガストークンも必要ありません。Xenarch が資金を保有することはなく、エージェントとパブリッシャーの間に Xenarch のコントラクトが介在することもありません。

MCP ツール

3 つのグループに 29 個のツールがあります。グループ 1（検出と支払い）はウォレットだけで利用できます。グループ 2 と 3（コントロールプレーンとマーチャント）は Xenarch アカウントを管理するためのもので、SIWE セッションが必要です。xenarch agent login を一度実行してください（アカウントツールの認証を参照）。

1. 検出と支払い — エージェントのウォレットのみ

2. エージェントのコントロールプレーン — 支払いエージェントを管理（SIWE セッション）

オペレーターのエージェントの上限、スコープ、キルスイッチ、API キーを管理します。権限が必要な （制限を緩和する）操作には confirm: true が必要です。制限を強化する操作は確認なしで実行できます。

3. マーチャント — 支払いを受け取る（SIWE セッション）

支払いリンクの作成と管理、支払いと購読者の確認、マーチャントプロフィールの設定を行います。 コントロールプレーンと同じ SIWE セッションを使用します。

アカウントツールの認証

• Payments（グループ 1）には、残高のあるウォレット（XENARCH_PRIVATE_KEY）とコントロールプレーンへのリンク（XENARCH_API_TOKEN）が必要です。公式 MCP はトークンがないと支払いを拒否します（XEN-480：リンクされていないエージェントには上限がありません）。ローカルの呼び出しごとの上限（XENARCH_MAX_PAYMENT_USD、デフォルトは $1）は、管理対象のトランザクションごと／日次／月次の上限に加えて適用されます。
• コントロールプレーン + マーチャント（グループ 2～3）には、SIWE セッションが必要です。xenarch agent login を一度実行すると、7 日間有効な session_token が ~/.xenarch/config.json に書き込まれ、MCP サーバーが自動的に読み込みます。有効期限が切れたら再実行するか、クライアントから直接 xenarch_agent_login を呼び出してください。
• XENARCH_API_TOKEN（xa_live_ エージェントキー）を設定すると、xenarch_pay に管理対象の上限／スコープが適用され、すべての MCP 支払いがダッシュボードの領収書フィードに表示されます。ダッシュボードは無料です。dash.xenarch.dev でウォレットを使ってサインインしてください（署名のみで、資金は移動しません）。トランザクションごと／日次／月次の上限、スコープルール、キルスイッチ、全履歴を利用できます。トークンがない場合、xenarch_pay は支払いを拒否します（フェイルクローズ）。これにより、リンクされていないエージェントが上限なしで決済することを防ぎます。注：ダッシュボードへのサインインに使うウォレットはユーザーの本人確認用であり、エージェントのローカル支払い用ウォレットとは別です。

応答例

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "3000",
      "resource": "https://example.com/article",
      "payTo": "0xabc123...publisher_wallet",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "maxTimeoutSeconds": 60
    }
  ],
  "seller_wallet": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC"
}

{
  "success": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "tx_hash": "0xdef456...abc789",
  "seller_wallet": "0xabc123...publisher_wallet",
  "url": "https://example.com/article",
  "wallet": "0x123...your_wallet",
  "content": "...gated content here..."
}

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

HTTP 402 — x402 がついに有効化した、使われていなかったステータスコード

HTTP 402 Payment Required は、機械間決済のために 1997 年から HTTP 仕様で予約されていたステータスコードです。クライアントが 402 応答に対してどのように支払うべきかを定めるオープンプロトコルがなかったため、何十年もの間使われていませんでした。

x402 はそのプロトコルです。サーバーは署名済みの価格と支払いの詳細を添えて HTTP 402 を返し、クライアントは Base L2 上で USDC のマイクロペイメントに署名して、支払い証明を付けてリクエストを再試行します。Xenarch の MCP サーバーは、AI エージェント向けにこの両方の処理を自動化します。402 チャレンジを読み取り、x402-fetch 経由で支払いに署名し、リクエストを再送して、オンチェーントランザクションハッシュと制限対象のコンテンツを返します。

詳細：x402 spec は支払いハンドシェイクを定義しています。pay.json（Xenarch が作成）は、/.well-known/pay.json で提供される機械可読な価格情報の関連オープン標準です。支払い用の robots.txt のようなものです。

HTTP 402 による API の収益化

Xenarch は、HTTP 402 仕様に基づいて構築された API 収益化のプリミティブです。サブスクリプション、ダッシュボード、API キーが必要な API ゲートウェイ型の収益化プラットフォーム（Apigee、Kong、AWS API Gateway）とは異なり、Xenarch ではアカウント作成やキーの発行なしに、あらゆる API がリクエストごとに課金できます。呼び出し元が Base L2 上で USDC を支払い、API がオンチェーントランザクションを検証すると、アクセスが許可されます。

提供者にとって、次のようなメリットがあります。

• Stripe／カード処理業者との連携が不要
• サブスクリプションプラン、料金プラン、使用量上限のダッシュボードが不要
• プラットフォームに預けるカストディアル残高が不要
• 人間のユーザー、ボット、AI エージェントに一律に適用できるリクエストごとの料金設定
• リアルタイムでオンチェーン決済される API 収益化

Python SDK には、デコレーターを 1 つ追加するだけで使える FastAPI ミドルウェアが含まれています。提供者向けの連携については、xenarch-sdks/python を参照してください。

セットアップ

1. ウォレットを設定します。

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

2. Claude Code に追加します。

claude mcp add xenarch -- npx @xenarch/agent-mcp

または、同じ JSON を任意の MCP クライアントの設定ファイルに追加します。

• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）／%APPDATA%\Claude\claude_desktop_config.json（Windows）
• Cursor — ~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）
• Cline（VS Code）— MCP Servers パネル →「Configure MCP Servers」、または cline_mcp_settings.json

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "XENARCH_API_TOKEN": "xa_live_…optional, enforces caps/scope"
      }
    }
  }
}

3. Base 上の USDC でウォレットに資金を入れます。これで完了です。ETH も、ほかのトークンも必要ありません。

4. （任意）コントロールプレーンとマーチャントのツールを使うには、xenarch agent login を一度実行して SIWE セッションを作成します。

環境変数

コントロールプレーンとマーチャントのツールでは、認証に環境変数を使用しません。xenarch agent login が ~/.xenarch/config.json に書き込む SIWE session_token を読み込みます。

例

動作する統合例（Python エージェント、LangChain、CrewAI、Claude Desktop のセットアップ、パブリッシャーミドルウェア）については、xenarch-examples をご覧ください。

開発

npm install
npm run build

構成

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

FAQ

Claude は Xenarch を使って API の支払いをどのように行いますか？ Xenarch MCP サーバー（claude mcp add xenarch -- npx @xenarch/agent-mcp）をインストールしてウォレットを用意すると、Claude は Base L2 で USDC のマイクロペイメントを行い、HTTP 402 レスポンスを自動的に解決します。

Xenarch は Cursor、LangChain、CrewAI に対応していますか？ はい。Xenarch は、MCP 対応のクライアント（Claude Code、Claude Desktop、Cursor、Cline、LangChain、CrewAI、および Model Context Protocol を使用するその他のクライアント）が利用できる MCP サーバーを提供します。

パブリッシャー向けに FastAPI はサポートされていますか？ はい。Python SDK（pip install xenarch[fastapi]）を使用できます。デコレーターを1つ追加するだけで、価格を含む HTTP 402 を返し、オンチェーン決済を検証するミドルウェアです。xenarch-sdks/python をご覧ください。

Xenarch はカストディアルですか？ いいえ。支払いは、エージェントのウォレットからパブリッシャーのウォレットへの直接の USDC 送金としてオンチェーンで決済されます。資金が Xenarch のインフラを通ることはなく、送金の過程に Xenarch のコントラクトは存在しません。

エージェントはガス代として ETH が必要ですか？ いいえ。エージェントのウォレットに必要なトークンは USDC だけです。USDC を入金すれば完了です。ETH などのガス代用トークンは必要ありません。

手数料はいくらですか？ 仕組み上、0％です。Xenarch は送金の過程に介在しないため、手数料を徴収する Xenarch のコントラクトはありません。

1回の呼び出しで支払える上限はいくらですか？ 1米ドルです。

x402 とは何ですか？ x402 は HTTP 402 Payment Required のオープンプロトコルです。サーバーが価格とともに 402 を返し、クライアントが Base L2（またはその他の対応チェーン）で USDC のマイクロペイメントに署名してから、支払い証明を添えてリクエストを再試行します。

HTTP 402 とは何ですか？ HTTP 402 Payment Required は、マシン間決済のために1997年から HTTP 仕様で予約されているステータスコードです。x402 は、このコードをついに実用化するオープンプロトコルです。

Xenarch は Cloudflare Pay-Per-Crawl とどう違いますか？ Cloudflare Pay-Per-Crawl は Cloudflare の背後にあるサイトでしか機能せず、カストディアルです。Xenarch はあらゆるホストで機能し、ノンカストディアルです。パブリッシャーにはオンチェーンで直接支払いが行われます。

Xenarch は TollBit とどう違いますか？ TollBit はエンタープライズ向けライセンスに重点を置いています。Xenarch はセルフサービス型でノンカストディアルであり、エンタープライズ契約なしで、幅広いパブリッシャーとあらゆる AI エージェントに対応します。

リンク

• ウェブサイト: https://xenarch.com
• npm: https://www.npmjs.com/package/@xenarch/agent-mcp
• PyPI: https://pypi.org/project/xenarch/
• Smithery: https://smithery.ai/servers/xenarch/xenarch-mcp
• GitHub: https://github.com/xenarch-ai/xenarch-mcp

ライセンス

MIT