a2a-x402-mcp-services

Produktionsorientierte x402 v2 monetisierte MCP-Tools für echten Agent-zu-Agent-Handel (A2A).

• Echte On-Chain-Abrechnung (keine Mocks, keine simulierten Zahlungen)

• Vollständig konform mit der aktuellen x402 v2-Spezifikation (CAIP-2-Netzwerke, PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE-Header, x402Version: 2, exaktes Schema)

• Offizielle @x402/mcp + @x402/core + @x402/evm-Pakete

• Bazaar-bereit (Tools sind über Facilitatoren auffindbar, die die Bazaar-Erweiterung implementieren)

• Entwickelt für die aktuellen Lücken im Ökosystem: betriebliche Tools, die Agenten tatsächlich wieder kaufen

Aktuelle kostenpflichtige Tools

All tools use the exact payment scheme and settle through a real facilitator.

Related MCP server: Agent Commerce Suite

x402 v2 Compliance Checkliste

• x402Version: 2

• CAIP-2-Netzwerk-IDs (Standard: eip155:84532 Base Sepolia, eip155:8453 für Mainnet)

• Offizielle Header (PAYMENT-REQUIRED, PAYMENT-SIGNATURE, PAYMENT-RESPONSE)

• Exaktes Schema via @x402/evm/exact

• Facilitator-basierte Verifizierung und Abrechnung (niemals selbst prozessintern abgerechnet)

• Bazaar-Erweiterungsmetadaten für die MCP-Tool-Erkennung

• Umgebungsgesteuerte payTo-Adresse (keine hartcodierten Produktions-Wallets)

Schnellstart (Testnet)

git clone https://github.com/Disseveru/a2a-x402-mcp-services.git
cd a2a-x402-mcp-services
npm install

# Required: receiving wallet (Base Sepolia)
export X402_PAY_TO_EVM=0xYourTestnetAddress

# Optional overrides
# export X402_NETWORK=eip155:84532
# export X402_FACILITATOR_URL=https://x402.org/facilitator
# export PORT=4022

npm run dev

Health-Check (kostenlos):

curl http://localhost:4022/health

Tool-Katalog (kostenlos):

curl http://localhost:4022/tools

MCP-Endpunkt (kostenpflichtig):

POST http://localhost:4022/mcp

Verwenden Sie einen x402 v2-fähigen MCP-Client (@x402/mcp-Client-Hilfen, CDP-verwaltete Wallets usw.). Der erste Aufruf eines kostenpflichtigen Tools erhält einen ordnungsgemäßen 402; der Client signiert und wiederholt mit PAYMENT-SIGNATURE; der Facilitator wickelt ab; das Tool-Ergebnis wird zurückgegeben.

Wechsel zum Mainnet

1. Legen Sie eine Mainnet-Empfangsadresse fest:

   export X402_PAY_TO_EVM=0xYourMainnetAddress

2. Wechseln Sie das Netzwerk:

   export X402_NETWORK=eip155:8453

3. Verwenden Sie einen Produktions-Facilitator (Beispiel – CDP):

   export X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402

   (Stellen Sie CDP-Anmeldedaten bereit, falls der gewählte Facilitator diese erfordert.)

4. Starten Sie den Server. Echte USDC werden bewegt.

Betreiben Sie das Mainnet niemals mit einem Hot-Key, der mehr hält, als Sie zu verlieren bereit sind.

Architektur

src/
  config.ts          – env-driven CAIP-2 + facilitator + payTo
  server.ts          – McpServer + official createPaymentWrapper (@x402/mcp)
  tools/
    definitions.ts   – paid tool implementations (real logic)
  index.ts           – Express host + Streamable HTTP MCP transport

Design-Prinzipien

1. Keine Mocks – jeder kostenpflichtige Pfad endet mit einem echten Facilitator-Settle-Aufruf.

2. Nur v2 – keine veralteten X-PAYMENT-Header oder v1-Netzwerkstrings.

3. Operativer Nutzen – Tools lösen Probleme bei Wiederholungskäufen von Agenten (Risiko, Normalisierung, Facilitator-Auswahl).

4. Auffindbar – Bazaar-Metadaten sind vorhanden, damit Agenten die Tools ohne hartcodierte URL finden können.

5. Betreibersicherheit – Empfangsadresse und Netzwerk stammen ausschließlich aus Umgebungsvariablen.

Lizenz

MIT