@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

MCP-Server für Pay – der vollständige x402-Zahlungs-Stack für KI-Agenten. USDC auf Base.

Verleiht jedem MCP-kompatiblen Client (Claude Desktop, Cursor, VS Code, benutzerdefinierte Frameworks) die volle Power von Pay: direkte Zahlungen, Tabs, x402-Paywalls, Service-Discovery und Wallet-Verwaltung. Kein CLI-Binary erforderlich.

Einrichtung

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

Fügen Sie dies zu .vscode/mcp.json hinzu:

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

Das ist alles. Beim ersten Start generiert der Server ein Wallet und speichert es im OS-Schlüsselbund (Windows Hello, macOS Keychain, Linux Secret Service). Nachfolgende Starts laden es automatisch.

Konfiguration

Umgebungsvariable	Erforderlich	Standard	Beschreibung
`PAYSKILL_SIGNER_KEY`	Nein	—	Optionaler Override. Roh-Hex-Key oder `.enc`-Keystore-Passwort. Für den normalen Gebrauch nicht erforderlich.
`PAY_NETWORK`	Nein	`mainnet`	`mainnet` (Base) oder `testnet` (Base Sepolia)

Key-Auflösung (wird in dieser Reihenfolge geprüft)

OS-Schlüsselbund (Standard) – Lädt aus dem OS-Anmeldeinformationsspeicher via keytar. Beim ersten Start wird automatisch ein neues Schlüsselpaar generiert und gespeichert.
Verschlüsselter Keystore – Wenn ~/.pay/keys/default.enc existiert, wird PAYSKILL_SIGNER_KEY als Entschlüsselungspasswort verwendet.
Roh-Hex-Key – Wenn PAYSKILL_SIGNER_KEY ein 64-stelliger Hex-String ist, wird er direkt verwendet. Für Entwicklung/Tests oder den Import eines bestehenden Wallets.
Automatische Generierung – Wenn nichts davon zutrifft, wird ein neues Schlüsselpaar generiert und im OS-Schlüsselbund gespeichert.

Diagnose-Check

Überprüfen Sie, ob alles korrekt konfiguriert ist:

npx @pay-skill/mcp --check

Ausgabe:

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

Tools (15)

Zahlungen

Tool	Beschreibung
`pay_send`	Direkte USDC-Zahlung (mind. $1). Bestätigungsschwellen: <$10 automatisch, $10-100 Plan, >$100 explizit.
`pay_request`	HTTP-Anfrage mit x402-automatischer Zahlung. Behandelt 402-Erkennung, direkte/Tab-Abrechnung, Preisskepsis.

Tabs (getaktete Konten)

Tool	Beschreibung
`pay_tab_open`	Öffnen eines vorfinanzierten Tabs (mind. $5, $50 empfohlen). Der Anbieter berechnet pro Aufruf.
`pay_tab_close`	Tab schließen. Gibt die Verteilungsaufschlüsselung zurück (Anbieter 99%, Gebühr 1%, Agenten-Restbetrag).
`pay_tab_charge`	Belastung eines offenen Tabs (nur Anbieter).
`pay_tab_topup`	Guthaben zu einem offenen Tab hinzufügen (nur Agent).
`pay_tab_list`	Tabs mit Inaktivitäts-/niedrigen Guthaben-Flags auflisten.

Wallet

Tool	Beschreibung
`pay_status`	Kontostand, gesperrte/verfügbare Mittel, umsetzbare Vorschläge.
`pay_fund`	Generierung eines 1-Stunden-Finanzierungslinks (Coinbase Onramp oder direktes USDC).
`pay_withdraw`	Generierung eines 1-Stunden-Auszahlungslinks.
`pay_mint`	Testnet-USDC minten (nur Base Sepolia).

Discovery & Webhooks

Tool	Beschreibung
`pay_discover`	Suche nach bezahlten API-Diensten nach Stichwort/Kategorie.
`pay_webhook_register`	Webhook für Zahlungsereignisse registrieren (HMAC-signiert).
`pay_webhook_list`	Registrierte Webhooks auflisten.
`pay_webhook_delete`	Webhook löschen.

Ressourcen (5)

URI	Beschreibung
`pay://wallet/status`	Kontostand, Tabs, gesperrt/verfügbar
`pay://wallet/tabs`	Alle offenen Tabs
`pay://tab/{tab_id}`	Detail eines einzelnen Tabs
`pay://wallet/address`	Wallet-Adresse
`pay://network`	Netzwerkkonfiguration + Vertragsadressen

Prompts (3)

Prompt	Beschreibung
`pay-for-service`	Geführt: Dienst entdecken, Preise bewerten, Anfrage stellen
`review-tabs`	Tabs überprüfen, inaktive markieren, Schließen/Aufladen vorschlagen
`fund-wallet`	Finanzierungslink generieren, Einzahlungsprozess erklären

Entwicklung

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_SIGNER_KEY)

Lizenz

MIT

Teil von Pay

Pay ist der vollständige x402-Zahlungs-Stack – Gateway, Facilitator, SDKs, CLI und MCP-Server –, der es KI-Agenten ermöglicht, APIs mit USDC auf Base zu bezahlen.

Dokumentation
Architektur
SDK -- Python + TypeScript
CLI -- Befehlszeilen-Tool
pay-gate -- x402-Zahlungsgateway
Protokoll -- Smart Contracts

pay-mcp