Xenarch — x402 MCP-Server für KI-Agenten-Zahlungen

Xenarch ist ein nicht-verwahrter (non-custodial) x402 MCP-Server, der es KI-Agenten ermöglicht, für HTTP 402-geschützte APIs und Inhalte mit USDC-Mikrozahlungen auf Base L2 zu bezahlen. Claude-, Cursor-, LangChain- und CrewAI-Agenten lösen HTTP 402-Antworten („Payment Required“) automatisch auf — ohne API-Schlüssel, ohne Abonnements, ohne hinterlegte Kreditkarte. Zahlungen werden direkt on-chain an das Wallet des Herausgebers über einen beliebigen x402-Vermittler abgewickelt. Vermittler-agnostisch, 0 % Gebühr, kein Zwischenvertrag.

Was Xenarch anders macht

Related MCP server: pay-mcp

Funktionsweise

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 }

Keine API-Schlüssel. Keine Registrierung. Der Agent zahlt direkt on-chain — Xenarch verwahrt niemals Gelder und es gibt keinen Zwischenvertrag zwischen dem Agenten und dem Herausgeber.

MCP-Tools

Drei Tools für KI-Agenten:

Beispielantworten

{
  "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 — der ungenutzte Statuscode, den x402 endlich aktiviert

HTTP 402 Payment Required ist ein Statuscode, der seit 1997 in der HTTP-Spezifikation für Machine-to-Machine-Zahlungen reserviert ist. Er blieb jahrzehntelang ungenutzt, da es kein offenes Protokoll dafür gab, wie ein Client auf eine 402-Antwort zahlen sollte.

x402 ist dieses Protokoll: Ein Server gibt HTTP 402 mit einem signierten Preis und Zahlungsdetails zurück, der Client signiert eine USDC-Mikrozahlung auf Base L2 und wiederholt die Anfrage mit dem Zahlungsnachweis. Der MCP-Server von Xenarch automatisiert beide Hälften für KI-Agenten — er liest die 402-Herausforderung, signiert die Zahlung über x402-fetch und wiederholt die Anfrage, wobei er den On-Chain-Transaktions-Hash sowie den geschützten Inhalt zurückgibt.

Erfahren Sie mehr: Die x402-Spezifikation definiert den Zahlungs-Handshake; pay.json (von Xenarch erstellt) ist der begleitende offene Standard für maschinenlesbare Preisgestaltung, der unter /.well-known/pay.json bereitgestellt wird — denken Sie an robots.txt für Zahlungen.

API-Monetarisierung mit HTTP 402

Xenarch ist ein API-Monetarisierungs-Primitiv, das auf der HTTP 402-Spezifikation basiert. Im Gegensatz zu API-Gateway-Monetarisierungsplattformen (Apigee, Kong, AWS API Gateway), die Abonnements, Dashboards und API-Schlüssel erfordern, ermöglicht Xenarch jeder API, pro Anfrage abzurechnen, ohne Kontoerstellung und ohne Bereitstellung von Schlüsseln — der Aufrufer zahlt USDC auf Base L2, die API verifiziert die On-Chain-Transaktion, der Zugriff wird gewährt.

Für Herausgeber bedeutet dies:

• Keine Integration mit Stripe/Kartenanbietern

• Keine Abonnementpläne, Preisstufen oder Kontingent-Dashboards

• Kein verwahrtes Guthaben, das von einer Plattform gehalten wird

• Preisgestaltung pro Anfrage, die für menschliche Benutzer, Bots und KI-Agenten gleichermaßen funktioniert

• API-Monetarisierung, die in Echtzeit on-chain abgewickelt wird

Das Python-SDK enthält eine FastAPI-Middleware mit einem Decorator; siehe xenarch-sdks/python für die Herausgeber-Integration.

Einrichtung

1. Konfigurieren Sie Ihr Wallet:

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

2. Zu Claude Code hinzufügen:

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

Oder zu Claude Desktop / Cursor / einem beliebigen MCP-Client hinzufügen:

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

Umgebungsvariablen

Beispiele

Siehe xenarch-examples für funktionierende Integrationsbeispiele — Python-Agenten, LangChain, CrewAI, Claude Desktop-Einrichtung und Herausgeber-Middleware.

Entwicklung

npm install
npm run build

Struktur

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

FAQ

Wie bezahlt Claude für APIs mit Xenarch? Installieren Sie den Xenarch MCP-Server (claude mcp add xenarch -- npx @xenarch/agent-mcp), geben Sie ihm ein Wallet, und Claude löst jede HTTP 402-Antwort automatisch mit einer USDC-Mikrozahlung auf Base L2 auf.

Funktioniert Xenarch mit Cursor, LangChain oder CrewAI? Ja. Xenarch stellt einen MCP-Server bereit, den jeder MCP-kompatible Client verwenden kann — Claude Code, Claude Desktop, Cursor, Cline, LangChain, CrewAI und jeder andere Client, der das Model Context Protocol spricht.

Wird FastAPI für Herausgeber unterstützt? Ja, über das Python-SDK (pip install xenarch[fastapi]) — eine Middleware mit einem Decorator gibt HTTP 402 mit dem Preis zurück und verifiziert die On-Chain-Zahlung. Siehe xenarch-sdks/python.

Ist Xenarch verwahrend (custodial)? Nein. Zahlungen werden on-chain als direkte USDC-Überweisung vom Wallet des Agenten an das Wallet des Herausgebers abgewickelt. Gelder berühren niemals die Xenarch-Infrastruktur und es gibt keinen Zwischenvertrag.

Wie hoch ist die Gebühr? 0 %, strukturell. Xenarch ist niemals Teil des Geldflusses — der Agent bezahlt den Herausgeber direkt on-chain über einen beliebigen x402-Vermittler.

Was ist die maximale Zahlung pro Aufruf? 1 USD.

Was ist x402? x402 ist ein offenes Protokoll für HTTP 402 Payment Required. Ein Server gibt 402 mit einem Preis zurück, der Client signiert eine USDC-Mikrozahlung auf Base L2 (oder einer anderen unterstützten Chain) und wiederholt die Anfrage mit dem Zahlungsnachweis.

Was ist HTTP 402? HTTP 402 Payment Required ist ein Statuscode, der seit 1997 in der HTTP-Spezifikation für Machine-to-Machine-Zahlungen reserviert ist. x402 ist das offene Protokoll, das ihn endlich nutzt.

Wie schneidet Xenarch im Vergleich zu Cloudflare Pay-Per-Crawl ab? Cloudflare Pay-Per-Crawl funktioniert nur für Seiten hinter Cloudflare und ist verwahrend. Xenarch funktioniert auf jedem Host und ist nicht-verwahrend — Herausgeber werden direkt on-chain bezahlt.

Wie schneidet Xenarch im Vergleich zu TollBit ab? TollBit ist auf Enterprise-Lizenzierung fokussiert. Xenarch ist Self-Service, nicht-verwahrend und funktioniert für die breite Masse an Herausgebern und jeden KI-Agenten ohne Enterprise-Verträge.

Links

• Website: 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

Lizenz

MIT