Xenarch — AIエージェント決済用 x402 MCPサーバー

Xenarchは、AIエージェントがBase L2上のUSDCマイクロペイメントを使用して、HTTP 402で保護されたAPIやコンテンツの料金を支払うことができる、非カストディアルなx402 MCPサーバーです。Claude、Cursor、LangChain、CrewAIのエージェントは、HTTP 402（「Payment Required」）レスポンスを自動的に解決します。APIキーやサブスクリプション、クレジットカードの登録は不要です。支払いは、任意のx402ファシリテーターを通じて、パブリッシャーのウォレットに直接オンチェーンで決済されます。ファシリテーターに依存せず、手数料は0%、仲介コントラクトも存在しません。

Xenarchの特長

Related MCP server: pay-mcp

仕組み

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

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

APIキーやサインアップは不要です。エージェントは直接オンチェーンで支払います。Xenarchが資金を保持することはなく、エージェントとパブリッシャーの間に仲介コントラクトも存在しません。

MCPツール

AIエージェント向けの3つのツール：

レスポンス例

{
  "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
    }
  ],
  "facilitators": [
    { "name": "PayAI", "url": "https://facilitator.payai.network", "priority": 1, "spec_version": "v1" },
    { "name": "xpay", "url": "https://facilitator.xpay.dev", "priority": 2, "spec_version": "v2" }
  ],
  "seller_wallet": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC"
}

{
  "success": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "tx_hash": "0xdef456...abc789",
  "facilitator": "PayAI",
  "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仕様は支払いハンドシェイクを定義しています。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にはFastAPIミドルウェア（デコレータ1つで実装可能）が含まれています。パブリッシャー統合については 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

または、Claude Desktop / Cursor / その他のMCPクライアントへの追加：

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

環境変数

例

統合例については xenarch-examples を参照してください。Pythonエージェント、LangChain、CrewAI、Claude Desktopのセットアップ、パブリッシャーミドルウェアなどが含まれています。

開発

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はHTTP 402レスポンスをBase L2上のUSDCマイクロペイメントで自動的に解決します。

XenarchはCursor、LangChain、CrewAIで動作しますか？ はい。XenarchはMCPサーバーを公開しており、Claude Code、Claude Desktop、Cursor、Cline、LangChain、CrewAIなど、Model Context Protocolに対応したあらゆるクライアントで使用できます。

パブリッシャー向けにFastAPIはサポートされていますか？ はい。Python SDK (pip install xenarch[fastapi]) を使用すれば、デコレータ1つでHTTP 402を価格とともに返し、オンチェーン決済を検証できます。xenarch-sdks/python を参照してください。

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

手数料はいくらですか？ 構造的に0%です。Xenarchは資金の流れに介在しません。エージェントは任意のx402ファシリテーターを通じてパブリッシャーに直接支払います。

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