MCP-Pay

Eine HTTP-x402-Monetarisierungsschicht auf Algorand, die es KI-Agenten ermöglicht, für MCP-Tools auf einer Sub-Cent-Basis pro Aufruf zu bezahlen.

Problem

Autonome KI-Agenten, die das Model Context Protocol (MCP) verwenden, können nicht auf kostenpflichtige Tools zugreifen: Kreditkarten, API-Schlüssel und Abonnements sind menschliche Arbeitsabläufe. Tool-Ersteller haben keine Möglichkeit, pro Aufruf zu berechnen, und Legacy-Ketten sind für Maschine-zu-Maschine-Mikrozahlungen zu langsam oder zu teuer.

Related MCP server: Agent Commerce Gateway

Lösung

MCP-Pay wandelt jedes MCP-Tool in einen sofort monetarisierten x402-Endpunkt auf Algorand um.

1. Ein Agent entdeckt Tools unter GET /mcp/v1/tools (kostenlos, inklusive JSON-Schemas + Preisen).

2. Der Agent ruft POST /mcp/v1/tools/:name/execute ohne Zahlung auf.

3. Der Server antwortet mit 402 Payment Required und Zahlungsmetadaten (Preis in USDC, Empfängeradresse, Netzwerk).

4. Die lokale Middleware des Agenten signiert automatisch eine Algorand-USDC-Überweisung (ASA 31566704) und versucht es erneut.

5. Der GoPlausible-Facilitator verifiziert und wickelt on-chain ab (<3,3 s Finalität), das Tool wird ausgeführt, und die Ergebnisse werden in einem einzigen Round-Trip zurückgegeben.

Keine Konten. Keine Schlüssel. Keine Menschen.

USP

Enthaltene kostenpflichtige Tools

Architektur

┌────────────────────────┐
│   AI AGENT (client/)   │  1. GET /mcp/v1/tools      (discovery)
│  auto-paying MCP agent │  2. POST .../execute       → 402 challenge
└───────────┬────────────┘  3. sign USDC txn locally
            │               4. retry + X-PAYMENT header
            ▼
┌────────────────────────┐
│  MCP-PAY SERVER (Hono) │  x402 paymentMiddleware protects each tool route
│  registry + tools/*    │  executes tool only after verified settlement
└───────────┬────────────┘
            ▼
┌────────────────────────┐
│ GOPLAUSIBLE FACILITATOR│  /verify + /settle on Algorand TestNet
│  https://facilitator.  │  USDC (ASA 31566704) transfer
│  goplausible.xyz       │
└────────────────────────┘

Tech-Stack

• TypeScript, Hono

• @x402/core, @x402/avm, @x402/hono, @x402/fetch

• @x402-avm/extensions (Bazaar-Entdeckung)

• GoPlausible-Facilitator, Algorand TestNet USDC

Lokal ausführen

1. Voraussetzungen

• Node.js 18+, pnpm (npm i -g pnpm)

• Zwei finanzierte Algorand-TestNet-Konten:

  • Server-Wallet (Empfänger): nur Adresse

  • Agent-Wallet (Zahler): Mnemonik, lokal aufbewahrt — niemals committen

Finanziere über den Lora-Faucet, optiere beide in Lora in USDC ein, und erhalte dann TestNet-USDC vom Circle-Faucet (wähle Algorand Testnet).

2. Konfigurieren

pnpm install
cp .env.example .env

Fülle .env:

AVM_ADDRESS=<server wallet address>          # receiver
AVM_MNEMONIC="<agent 25-word mnemonic>"      # payer, LOCAL ONLY
SERVER_URL=http://localhost:4021

3. Server starten + Agent ausführen

pnpm server        # terminal 1
pnpm agent         # terminal 2: discovery → 402 → auto-pay → result

On-Chain verifizieren

Jeder erfolgreiche Aufruf wickelt eine echte TestNet-Transaktion ab:

• Facilitator-Dashboard: https://facilitator.goplausible.xyz/dashboard

• Lora-Explorer: https://lora.algokit.io/testnet

Beispiel-Settlement-TX (aus Demo-Lauf):

TODO: paste Lora transaction link after first live run

API

Roadmap

• Ausgabenrichtlinien-Schutz: Pro-Agent-Budgets, durchgesetzt von der Middleware

• Creator-Dashboard: Registriere dein eigenes MCP-Tool + Preis in Minuten

• Bazaar-Listing bei GoPlausible, damit jeder Drittanbieter-Agent MCP-Pay-Tools entdecken kann