SnapEX Pay

npx add-mcp 'https://pay.snapex.pro/mcp'

SnapEX Pay MCP-Server

MCP-Server für Krypto-Zahlungen: Ein KI-Agent eröffnet sein eigenes Händlerkonto und akzeptiert, sendet und tauscht Kryptowährungen.

Mit dem SnapEX Pay MCP-Server kann ein KI-Agent Krypto-Zahlungen ohne menschliches Eingreifen abwickeln. Der Agent verbindet sich mit https://pay.snapex.pro/mcp,, eröffnet selbstständig ein SnapEX Pay-Händlerkonto (ohne CAPTCHA und E-Mail) und erhält einen API-Schlüssel. Anschließend kann er Rechnungen mit gehosteten Zahlungsseiten erstellen, Kryptowährungen über permanente Einzahlungsadressen empfangen, ein USDT-Guthaben verwalten, Auszahlungen in vielen Coins und Netzwerken senden und Webhooks verwalten. Im Testmodus lässt sich der gesamte Ablauf ohne echtes Geld durchspielen. Auszahlungen beginnen immer mit einer kostenlosen Vorschau und verwenden einen Idempotenzschlüssel, sodass ein erneuter Versuch niemals doppelt auszahlt. Remote-Server (Streamable HTTP) oder lokales Paket: npx -y snapex-pay-mcp.

• Remote-Server (empfohlen, keine Installation erforderlich): https://pay.snapex.pro/mcp — Streamable HTTP.
• Lokales stdio-Paket: npx -y snapex-pay-mcp — dieselben Tools, ein schlanker Client derselben API.
• Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp.
• MCP-Registry-Name: pro.snapex/pay.
• Dokumentation für Menschen: https://pay.snapex.pro/mcp · REST-Referenz: https://pay.snapex.pro/partner/merchant/docs · Serverkarte: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
• Datenschutzrichtlinie: https://pay.snapex.pro/privacy · Nutzungsbedingungen: https://pay.snapex.pro/terms · Händlerrichtlinien: https://pay.snapex.pro/rules · Support: https://pay.snapex.pro/#chat

So verwendet ein Agent den Server

1. Ohne Schlüssel verbinden. Die Katalog-Tools (list_assets, get_fiat_rates, get_fees, list_static_address_networks) sind sofort verfügbar.
2. create_account aufrufen. Das Tool gibt api_key (wird einmal angezeigt), einen Zugang zum Konto login/password für eine Person und mcp_personal_url zurück. Der neue Schlüssel wird sofort verwendet: auf dem Remote-Server für den Rest der MCP-Sitzung, im stdio-Paket für den laufenden Prozess (und für die nächsten Ausführungen unter ~/.config/snapex-pay/credentials.json gespeichert).
3. Empfangen: create_invoice → pay_url an den Zahlenden weitergeben → get_invoice, bis paid. Mit environment: "test" lässt sich der gesamte Ablauf ohne echtes Geld durchspielen (eine Testrechnung wird etwa 10 s nach der Auswahl eines Coins als bezahlt markiert; das Guthaben ändert sich nicht).
4. Senden: preview_payout (kostenloses Angebot) → create_payout mit dem preview_id und einem eigenen idempotency_key (unumkehrbar; ein erneuter Versuch mit demselben Schlüssel zahlt niemals doppelt aus).
5. Das Guthaben wird in USDT geführt: Um einen anderen Coin zu erhalten, zahle in diesem Coin aus. preview_conversion → create_conversion wandelt andere Vermögenswerte um, die ein älteres Konto noch hält.

Jede Fehlermeldung erklärt den nächsten Schritt (what_to_do), z. B. unauthorized → create_account aufrufen; rate_limited → retry_after_seconds warten.

Verbinden

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
# with an existing key:
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp --header "Authorization: Bearer smk_…"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "snapex-pay": { "url": "https://pay.snapex.pro/mcp" }
  }
}

Füge "headers": { "Authorization": "Bearer smk_…" } hinzu, damit dasselbe Konto sitzungsübergreifend verwendet wird.

VS Code — .vscode/mcp.json

{
  "servers": {
    "snapex-pay": { "type": "http", "url": "https://pay.snapex.pro/mcp" }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "snapex-pay": { "serverUrl": "https://pay.snapex.pro/mcp" }
  }
}

Cline — cline_mcp_settings.json

{
  "mcpServers": {
    "snapex-pay": { "type": "streamableHttp", "url": "https://pay.snapex.pro/mcp" }
  }
}

Schritt-für-Schritt-Anleitung für KI-Installer: llms-install.md.

Gemini CLI

Als Erweiterung (dieses Repository enthält gemini-extension.json):

gemini extensions install https://github.com/snapexpay/snapex-pay-mcp

oder in ~/.gemini/settings.json:

{
  "mcpServers": {
    "snapex-pay": { "httpUrl": "https://pay.snapex.pro/mcp" }
  }
}

Claude Desktop — claude_desktop_config.json

Remote-Server über mcp-remote:

{
  "mcpServers": {
    "snapex-pay": { "command": "npx", "args": ["-y", "mcp-remote", "https://pay.snapex.pro/mcp"] }
  }
}

oder das lokale Paket:

{
  "mcpServers": {
    "snapex-pay": {
      "command": "npx",
      "args": ["-y", "snapex-pay-mcp"],
      "env": { "SNAPEX_API_KEY": "smk_…" }
    }
  }
}

(SNAPEX_API_KEY ist optional: Ohne diesen Wert ruft der Agent create_account auf und der Schlüssel wird für die nächsten Ausführungen gespeichert.)

claude.ai- und ChatGPT-Connectoren

Füge einen benutzerdefinierten Connector mit der URL https://pay.snapex.pro/mcp und ohne Authentifizierung hinzu. Diese Clients können keine Header senden. Rufe daher nach create_account mcp_personal_url aus der Antwort ab (wird auch von get_account zurückgegeben) und verwende ihn als Connector-URL — dann funktioniert jeder neue Chat mit demselben Konto. Diese URL enthält Zugangsdaten: Behandle sie wie ein Passwort.

OpenAI Responses API

{
  "type": "mcp",
  "server_label": "snapex_pay",
  "server_url": "https://pay.snapex.pro/mcp",
  "headers": { "Authorization": "Bearer smk_…" },
  "require_approval": { "always": { "tool_names": ["create_payout", "create_conversion"] } }
}

Andere Clients und Kataloge

Das Repository enthält die Manifeste, die von den Katalogen eingelesen werden: server.json (offizielle MCP-Registry), glama.json (Glama), gemini-extension.json + GEMINI.md (Gemini CLI), lhm.plugin.json (LobeHub), .cursor-plugin/plugin.json + mcp.json (Cursor Marketplace), plugin.json (Agent Plugins / Kiro), llms-install.md (Cline).

Docker

docker build -t snapex-pay-mcp .
docker run -i --rm -e SNAPEX_API_KEY=smk_… snapex-pay-mcp

Tools

Konto

Tool	Funktion
create_account	Ein SnapEX Pay-Konto eröffnen (ohne CAPTCHA)
get_account	Aktuelles Konto und Schlüssel anzeigen

Katalog (kein Schlüssel erforderlich)

Tool	Funktion
list_assets	Coins und Netzwerke auflisten
get_fiat_rates	Fiat-Wechselkurse
get_fees	Aktuelle Gebührenangebote für Routen
list_static_address_networks	Netzwerke für permanente Adressen

Guthaben

Tool	Funktion
get_balances	Kontoguthaben
list_transactions	Guthabenverlauf

Empfangen

Tool	Funktion
create_invoice	Rechnung erstellen (Kryptowährung empfangen)
get_invoice	Rechnungsstatus
list_invoices	Rechnungen auflisten
get_invoice_payment_methods	Coins, mit denen eine Rechnung bezahlt werden kann
select_invoice_payment_method	Coin für eine Rechnung auswählen
preview_payment	Direktzahlung berechnen
create_payment	Direktzahlung erstellen
get_payment	Zahlungsstatus
list_payments	Zahlungen auflisten
create_static_address	Permanente Einzahlungsadresse
list_static_addresses	Permanente Adressen auflisten
list_static_address_deposits	Einzahlungen auf eine permanente Adresse

Senden (Auszahlungen)

Tool	Funktion
preview_payout	Auszahlung berechnen (Kryptowährung senden)
create_payout	Auszahlung senden (unumkehrbar) ⚠️ unumkehrbar
get_payout	Auszahlungsstatus
list_payouts	Auszahlungen auflisten

Tausch

Tool	Funktion
preview_conversion	Umtausch berechnen
create_conversion	Umtausch ausführen ⚠️ unumkehrbar
get_conversion	Umtauschstatus
list_conversions	Umtausche auflisten

Webhooks

Tool	Funktion
list_webhooks	Webhook-Endpunkte auflisten
create_webhook	Webhook-Endpunkt hinzufügen
update_webhook	Webhook-Endpunkt ändern
rotate_webhook_secret	Neues Webhook-Secret ⚠️ unumkehrbar

Ressourcen: snapex://docs/quickstart, snapex://docs/webhooks. Prompts: accept_crypto_payment, send_crypto_payout.

Umgebung (stdio-Paket)

Variable	Standardwert	Bedeutung
SNAPEX_API_KEY	—	Händler-API-Schlüssel smk_…. Optional: create_account erstellt einen.
SNAPEX_BASE_URL	https://pay.snapex.pro	API-Basis-URL.
SNAPEX_CREDENTIALS_FILE	~/.config/snapex-pay/credentials.json	Speicherort für einen Schlüssel aus create_account (Modus 600).
SNAPEX_NO_SAVE	—	1 — Zugangsdaten nicht auf der Festplatte speichern.

Sicherheit

• Ein Agent bewegt nur das Geld seines eigenen Kontos; ein neues Konto beginnt mit einem Guthaben von null.
• Der Schlüssel und das generierte Passwort werden einmal angezeigt. Eine Person kann sich mit Benutzername und Passwort im Konto anmelden und dort Schlüssel widerrufen oder rotieren.
• Auszahlungen erfolgen in zwei Schritten (Angebot, dann Senden) und erfordern ein idempotency_key; create_payout, create_conversion und rotate_webhook_secret sind als destructiveHint gekennzeichnet, damit Clients vor ihrer Ausführung nachfragen können.
• Limits: einige neue Konten pro IP-Adresse und Stunde; etwa 120 API-Aufrufe pro Minute und Schlüssel; Auszahlungen: 5 pro Minute und 30 pro Stunde.
• Richtlinien dazu, was verkauft werden darf: https://pay.snapex.pro/rules.

Entwicklung

Die Tool-Liste wird aus dem SnapEX Pay-Server generiert (app/Mcp/McpToolCatalog.php):

php artisan mcp:export-tools      # writes src/tools.json, syncs the version of the manifests and LobeHub's tools
npm ci && npm test                # build + offline smoke test with the official MCP SDK client
SNAPEX_E2E_BASE_URL=http://127.0.0.1:8765 node test/smoke.mjs   # full flow against a local (never production) server

Support

Chat: https://pay.snapex.pro/#chat · Datenschutz: https://pay.snapex.pro/privacy · Nutzungsbedingungen: https://pay.snapex.pro/terms

Lizenz

MIT