@xpayr/mcp-server v1.0.0 · Registre : io.github.xpayrcom/xpayr-mcp-server · 21 outils

Serveur Model Context Protocol (MCP) pour le commerce crypto non dépositaire.

Offrez aux agents Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline et n8n un accès natif encadré par politiques à 21 outils XPayr fortement typés — créez des checkouts USDT/USDC multi-chaînes, vérifiez les webhooks HMAC, soumettez des intentions de paiement autonomes et modélisez des répartitions de règlement 99.5% / 0.5% on-chain.

21 outilsCouvrant checkout, webhooks, agents IA et trésorerie marchand.
2 transportsJSON-RPC 2.0 distant (/api/mcp) + Local npx Stdio.
6 suitesCiblez la fenêtre de contexte via --suite flagship ou all.
Garde-fousPlafonds par tx, budgets quotidiens et files d'approbation humaine.

Configuration en 1 clic pour IDE et clients d'agents


        

Test navigateur en direct → POST /api/mcp

Envoyez une véritable requête JSON-RPC 2.0 au point de terminaison MCP Streamable HTTP en direct de XPayr depuis cette page.

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

Les 21 outils MCP officiels

xpayr_health_check

Vérification de santé de la passerelle API

Vérifiez l'état opérationnel, la version et l'horodatage serveur de l'API XPayr Gateway v1.

GET /health Public (Sans clé)
xpayr_create_payment_session

Créer une session de paiement crypto (Paiement double)

Créez une session de paiement crypto non dépositaire prenant en charge le paiement Web3 en 1 clic, le transfert QR direct depuis un exchange, les liens multichaînes, les liens réutilisables 1 an et l'envoi automatique de factures HTML par e-mail.

POST /payments Bearer sk_test / sk_live
xpayr_get_payment_session

Récupérer les détails de la session de paiement

Récupérez l'ensemble des détails, métadonnées, montants de répartition du règlement, mode de paiement et hachage de transaction on-chain d'une session de paiement.

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

Lister les sessions de paiement marchand

Listez les sessions de paiement crypto du marchand avec filtrage par statut, devise, réseau et pagination.

GET /payments Bearer sk_test / sk_live
xpayr_get_public_payment_status

Interroger le statut public du paiement on-chain

Interrogez en temps réel le statut public du paiement, le tx_hash on-chain, l'adresse du portefeuille expéditeur, les confirmations de bloc et l'horodatage paid_at sans clé API.

GET /payments/{session_id}/status Public (Sans clé)
xpayr_apply_payment_coupon

Appliquer un coupon de réduction au paiement

Validez et appliquez un code promo marchand à une session de paiement active en attente.

POST /payments/{session_id}/coupon Public (Sans clé)
xpayr_get_merchant_profile

Récupérer le profil marchand et le portefeuille de règlement

Récupérez le profil marchand authentifié, l'adresse du portefeuille de règlement, le taux de commission en points de base (50 bps = 0.5%) et les clés API actives.

GET /me Bearer sk_test / sk_live
xpayr_get_merchant_balance

Récupérer le volume et le solde de règlement multichaîne

Interrogez le volume de règlement non dépositaire confirmé, le nombre de transactions et les frais de plateforme regroupés par devise et réseau blockchain.

GET /me/balance Bearer sk_test / sk_live
xpayr_get_supported_networks

Lister les réseaux, chaînes et jetons pris en charge

Listez tous les réseaux blockchain actifs EVM, TRON, Solana et Arc Mainnet/Testnet, les ID de chaîne, les points de terminaison RPC, les contrats répartiteurs et les jetons pris en charge.

GET /me/networks Bearer sk_test / sk_live
xpayr_get_webhook_config

Récupérer la configuration et les événements webhook

Inspectez l'URL de rappel webhook du marchand, le secret de signature HMAC-SHA256 masqué et les événements du cycle de vie des paiements souscrits.

GET /webhooks Bearer sk_test / sk_live
xpayr_set_webhook_endpoint

Configurer le point de terminaison webhook HTTPS

Configurez ou mettez à jour l'URL réceptrice HTTPS de webhook du marchand et générez un nouveau secret de signature HMAC-SHA256 de 32 octets.

POST /webhooks Bearer sk_test / sk_live
xpayr_send_test_webhook

Envoyer un événement webhook de test signé

Envoyez une charge utile test.webhook signée avec des en-têtes HMAC-SHA256 afin de valider la vérification de signature webhook du marchand.

POST /webhooks/test Bearer sk_test / sk_live
xpayr_create_ai_agent

Créer un agent commercial IA contrôlé par politiques

Provisionnez une nouvelle identité d'agent commercial IA gérée par le marchand avec des identifiants à portée définie et des garde-fous de dépenses programmables.

POST /agents Bearer sk_test / sk_live
xpayr_list_ai_agents

Lister les agents commerciaux IA du marchand

Listez tous les agents commerciaux IA gérés par le marchand avec leur statut, leurs portefeuilles attribués et leurs politiques de dépenses.

GET /agents Bearer sk_test / sk_live
xpayr_update_ai_agent_policy

Mettre à jour les garde-fous de dépenses de l'agent IA

Configurez les garde-fous de politique de dépenses d'un agent IA (montant max. USD par transaction, plafond quotidien, seuil d'approbation automatique, chaînes/jetons autorisés).

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

Soumettre une intention de paiement autonome d'agent IA

Soumettez une intention de paiement autonome d'agent IA évaluée en temps réel selon les règles de politique du marchand (approved, pending_approval, rejected).

POST /agent-intents Bearer agk_test / agk_live
xpayr_list_agent_payment_intents

Lister les intentions de paiement d'agents IA et journaux d'audit

Listez les intentions de paiement des agents IA, les décisions d'évaluation des politiques et les pistes d'audit du marchand.

GET /agent-intents Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout

Convertir une intention d'agent approuvée en session de paiement

Convertissez une intention de paiement d'agent IA approuvée en session de paiement XPayr exécutable en direct avec URL de paiement hébergée et vérification on-chain.

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

Approuver une intention d'agent IA en attente (Validation humaine)

Approuvez une intention de paiement d'agent IA en attente depuis la file d'approbation du marchand et transférez-la vers le paiement.

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

Rejeter une intention d'agent IA en attente

Rejetez une intention de paiement d'agent IA en attente dans la file d'approbation du marchand avec un motif d'audit.

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

Calculateur de partage des frais passerelle 0.5% et tolérance d'exchange

Calculez de manière déterministe la répartition des frais fixes de 0.5% (50 bps) de XPayr, le règlement net sur le portefeuille marchand, la tolérance de retrait d'exchange de 1% (max. $0.50) et les économies par rapport à BitPay, Coinbase Commerce et Stripe.

LOCAL /tools/crypto-payment-fee-calculator Hors ligne / Public

FAQ du serveur MCP XPayr

Dois-je me connecter via Streamable HTTP distant (/api/mcp) ou en local avec npx (@xpayr/mcp-server) ?

Les deux exposent les 21 outils XPayr avec des schémas identiques. Streamable HTTP distant (https://xpayr.com/api/mcp) ne nécessite aucun runtime Node.js local et fonctionne immédiatement dans les agents cloud, n8n et les IDE modernes ; npx -y @xpayr/mcp-server@1.0.0 s'exécute localement via stdio et permet le filtrage par modules (--suite flagship,checkout).

Les agents IA peuvent-ils appeler les outils MCP publics sans clé API ?

Oui. La découverte publique, l'état de santé de la passerelle (xpayr_health_check), le calcul déterministe de répartition à 0.5% (xpayr_calculate_gateway_fee_and_split) et le suivi public de session fonctionnent sans identifiants. La création authentifiée de checkouts et les outils d'intentions d'agent utilisent votre clé sk_test_ ou sk_live_.

Comment les garde-fous de dépenses empêchent-ils une hallucination LLM de trop dépenser ?

Les agents de commerce IA XPayr appliquent côté serveur des plafonds par transaction, budgets quotidiens glissants, seuils d'approbation automatique, listes blanches de chaînes/tokens et files de validation humaine (/agent-commerce) avant tout mouvement de fonds on-chain.

Où le serveur MCP XPayr est-il publié et vérifié ?

XPayr MCP est publié sur npm (@xpayr/mcp-server@1.0.0), GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), le registre officiel MCP, Glama et Smithery, et documenté sur https://mcp.xpayr.com et /.well-known/mcp.json.