@xpayr/mcp-server v1.0.0 · Verzeichnis: io.github.xpayrcom/xpayr-mcp-server · 21 Tools

Model Context Protocol (MCP)-Server für nicht-verwahrenden Krypto-Commerce.

Geben Sie Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline und n8n-Agenten nativen, richtliniengeschützten Zugriff auf 21 stark typisierte XPayr-Tools — erstellen Sie Multi-Chain-USDT/USDC-Checkouts, prüfen Sie HMAC-Webhooks, reichen Sie autonome Zahlungsaufträge ein und modellieren Sie 99.5% / 0.5% Abrechnungs-Splits.

21 ToolsÜber Checkout, Webhooks, KI-Agenten & Händler-Treasury hinweg.
2 TransportwegeRemote-JSON-RPC 2.0 (/api/mcp) + Lokal npx Stdio.
6 Modul-SuitesKontextfenster gezielt eingrenzen per --suite flagship oder all.
Leitplanken (Guardrails)Limits pro Transaktion, Tagesbudgets & menschliche Freigabewarteschlangen.

1-Klick-Konfiguration für IDEs & Agenten-Clients


        

Live-Browser-Test → POST /api/mcp

Senden Sie direkt von dieser Seite aus eine echte JSON-RPC-2.0-Anfrage an den Live-Streamable-HTTP-MCP-Endpunkt von XPayr.

// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp

Alle 21 offiziellen MCP-Tools

xpayr_health_check

API-Gateway-Systemstatusprüfung

Überprüfen Sie den Betriebsstatus, die Version und den Server-Zeitstempel der XPayr Gateway API v1.

GET /health Öffentlich (Ohne Schlüssel)
xpayr_create_payment_session

Krypto-Zahlungssitzung erstellen (Dualer Checkout)

Erstellen Sie eine nicht-verwahrende Krypto-Zahlungssitzung mit Unterstützung für Web3 1-Klick-Zahlung, direkte Börsen-QR-Überweisung, Multi-Chain-Links, 1 Jahr wiederverwendbare Links und automatischen HTML-Rechnungsversand per E-Mail.

POST /payments Bearer sk_test / sk_live
xpayr_get_payment_session

Details der Zahlungssitzung abrufen

Rufen Sie vollständige Details, Metadaten, Abrechnungsaufteilungsbeträge, den Checkout-Modus und den On-Chain-Transaktions-Hash für eine Zahlungssitzung ab.

GET /payments/{session_id} Bearer sk_test / sk_live
xpayr_list_payment_sessions

Händler-Zahlungssitzungen auflisten

Listen Sie Krypto-Zahlungssitzungen des Händlers mit Filterung nach Status, Währung, Netzwerk und Paginierung auf.

GET /payments Bearer sk_test / sk_live
xpayr_get_public_payment_status

Öffentlichen On-Chain-Zahlungsstatus abfragen

Fragen Sie den öffentlichen Echtzeit-Checkout-Status, den On-Chain-tx_hash, die Absender-Wallet-Adresse, Blockbestätigungen und den paid_at-Zeitstempel ohne API-Schlüssel ab.

GET /payments/{session_id}/status Öffentlich (Ohne Schlüssel)
xpayr_apply_payment_coupon

Checkout-Rabattgutschein anwenden

Validieren Sie einen Aktions-Rabattgutscheincode des Händlers und wenden Sie ihn auf eine aktive ausstehende Zahlungssitzung an.

POST /payments/{session_id}/coupon Öffentlich (Ohne Schlüssel)
xpayr_get_merchant_profile

Händlerprofil & Abrechnungs-Wallet abrufen

Rufen Sie das authentifizierte Händlerprofil, die Abrechnungs-Wallet-Adresse, den Provisionssatz in Basispunkten (50 bps = 0.5%) und aktive API-Schlüssel ab.

GET /me Bearer sk_test / sk_live
xpayr_get_merchant_balance

Multi-Chain-Abrechnungsvolumen & Saldo abrufen

Fragen Sie das bestätigte nicht-verwahrende Abrechnungsvolumen, Transaktionszahlen und Plattformgebühren gruppiert nach Währung und Blockchain-Netzwerk ab.

GET /me/balance Bearer sk_test / sk_live
xpayr_get_supported_networks

Unterstützte Netzwerke, Chains & Token auflisten

Listen Sie alle aktiven EVM-, TRON-, Solana- und Arc-Mainnet/Testnet-Blockchain-Netzwerke, Chain-IDs, RPC-Endpunkte, Splitter-Verträge und unterstützten Token auf.

GET /me/networks Bearer sk_test / sk_live
xpayr_get_webhook_config

Webhook-Konfiguration & Ereignisse abrufen

Prüfen Sie die Webhook-Callback-URL des Händlers, das maskierte HMAC-SHA256-Signaturgeheimnis und abonnierte Zahlungslebenszyklus-Ereignisse.

GET /webhooks Bearer sk_test / sk_live
xpayr_set_webhook_endpoint

HTTPS-Webhook-Endpunkt konfigurieren

Konfigurieren oder aktualisieren Sie die HTTPS-Webhook-Empfänger-URL des Händlers und generieren Sie ein neues 32-Byte-HMAC-SHA256-Signaturgeheimnis.

POST /webhooks Bearer sk_test / sk_live
xpayr_send_test_webhook

Signiertes Test-Webhook-Ereignis senden

Senden Sie eine signierte test.webhook-Nutzlast mit HMAC-SHA256-Headern, um die Webhook-Signaturprüfung des Händlers zu testen.

POST /webhooks/test Bearer sk_test / sk_live
xpayr_create_ai_agent

Richtliniengesteuerten KI-Commerce-Agenten erstellen

Stellen Sie eine neue händlerverwaltete KI-Commerce-Agenten-Identität mit bereichsbezogenen Zugangsdaten und programmierbaren Ausgabenleitplanken bereit.

POST /agents Bearer sk_test / sk_live
xpayr_list_ai_agents

KI-Commerce-Agenten des Händlers auflisten

Listen Sie alle vom Händler verwalteten KI-Commerce-Agenten samt Status, zugewiesenen Wallets und Ausgabenrichtlinien auf.

GET /agents Bearer sk_test / sk_live
xpayr_update_ai_agent_policy

KI-Agenten-Ausgabenleitplanken aktualisieren

Konfigurieren Sie Ausgabenrichtlinien-Leitplanken für einen KI-Agenten (Max. USD pro Transaktion, Tageslimit, Auto-Freigabe-Schwellenwert, erlaubte Chains/Token).

PUT /agents/{agent_id}/policy Bearer sk_test / sk_live
xpayr_submit_agent_payment_intent

Autonomen KI-Agenten-Zahlungsauftrag einreichen

Reichen Sie einen autonomen KI-Agenten-Zahlungsauftrag ein, der in Echtzeit anhand der Händlerrichtlinien bewertet wird (approved, pending_approval, rejected).

POST /agent-intents Bearer agk_test / agk_live
xpayr_list_agent_payment_intents

KI-Agenten-Zahlungsaufträge & Audit-Logs auflisten

Listen Sie KI-Agenten-Zahlungsaufträge, Richtlinienbewertungen und Prüfpfad-Einträge für den Händler auf.

GET /agent-intents Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout

Genehmigten Agenten-Auftrag in Checkout-Sitzung überführen

Überführen Sie einen genehmigten KI-Agenten-Zahlungsauftrag in eine ausführbare Live-XPayr-Zahlungssitzung mit gehosteter Checkout-URL und On-Chain-Verifizierung.

POST /agent-intents/{intent_id}/bridge Bearer sk_test / sk_live
xpayr_approve_agent_intent

Ausstehenden KI-Agenten-Auftrag genehmigen (Human-in-the-Loop)

Genehmigen Sie einen ausstehenden KI-Agenten-Zahlungsauftrag aus der Freigabewarteschlange des Händlers und überführen Sie ihn in den Checkout.

POST /agent-approvals/{intent_id}/approve Bearer sk_test / sk_live
xpayr_reject_agent_intent

Ausstehenden KI-Agenten-Auftrag ablehnen

Lehnen Sie einen ausstehenden KI-Agenten-Zahlungsauftrag in der Freigabewarteschlange des Händlers mit einem Audit-Grund ab.

POST /agent-approvals/{intent_id}/reject Bearer sk_test / sk_live
xpayr_calculate_gateway_fee_and_split

0.5%-Gateway-Gebührenaufteilungs- & Börsentoleranz-Rechner

Berechnen Sie deterministisch die pauschale XPayr-Gateway-Gebührenaufteilung von 0.5% (50 bps), die Netto-Händler-Wallet-Abrechnung, die Börsenauszahlungstoleranz von 1% (max. $0.50) sowie die Ersparnis gegenüber BitPay, Coinbase Commerce und Stripe.

LOCAL /tools/crypto-payment-fee-calculator Offline / Öffentlich

XPayr MCP-Server – Häufige Fragen

Sollte ich mich über Remote Streamable HTTP (/api/mcp) oder lokal per npx (@xpayr/mcp-server) verbinden?

Beide stellen alle 21 XPayr-Tools mit identischen Schemata bereit. Remote Streamable HTTP (https://xpayr.com/api/mcp) benötigt keine lokale Node.js-Laufzeitumgebung und funktioniert sofort in Cloud-Agenten, n8n und modernen IDEs; npx -y @xpayr/mcp-server@1.0.0 läuft lokal über stdio und unterstützt Modul-Scoping (--suite flagship,checkout).

Können KI-Agenten öffentliche MCP-Tools ohne API-Schlüssel aufrufen?

Ja. Öffentliche Discovery, Gateway-Health-Check (xpayr_health_check), deterministische 0.5%-Gebührensplit-Berechnung (xpayr_calculate_gateway_fee_and_split) und Statusabfragen öffentlicher Sitzungen funktionieren ohne Zugangsdaten. Authentifizierte Checkout- und Agent-Intent-Tools nutzen Ihren sk_test_- oder sk_live_-Schlüssel.

Wie verhindern Ausgaben-Leitplanken, dass eine LLM-Halluzination zu Überausgaben führt?

XPayr KI-Commerce-Agenten setzen serverseitig Einzeltransaktionslimits, rollierende Tagesbudgets, Auto-Freigabeschwellen, Chain-/Token-Whitelists und menschliche Freigabewarteschlangen (/agent-commerce) durch, bevor Gelder On-Chain bewegt werden.

Wo ist XPayr MCP veröffentlicht und verifiziert?

XPayr MCP ist auf npm (@xpayr/mcp-server@1.0.0), in der GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), im offiziellen MCP Registry, auf Glama und Smithery veröffentlicht sowie unter https://mcp.xpayr.com und /.well-known/mcp.json dokumentiert.