XPayr MCP Server

Servidor oficial de Model Context Protocol (MCP) con 21 herramientas para la pasarela de pagos cripto Web3 multicadena sin custodia de XPayr (USDT, USDC, SOL, TRX, BNB, ETH, Arc), con Dual Checkout (pago Web3 en 1 clic + QR de Exchange), webhooks firmados y comercio de agentes de IA controlado por políticas, con una comisión fija del 0,5 %.

Documentación

XPayr Official Logo

XPayr Official Model Context Protocol (MCP) Server & AI Agent Commerce Suite (@xpayr/mcp-server)

Powered by XPayr NPM @xpayr/mcp-server NPM xpayr-mcp Official MCP Registry GHCR Docker Verify MCP Suite Glama MCP Score Interactive Portal GitHub Pages Root License: MIT

XPayr (https://xpayr.com) is a non-custodial multi-chain crypto payment gateway and policy-controlled AI agent commerce infrastructure supporting EVM (Ethereum, BNB Chain, Polygon, Arbitrum, Base), TRON (TRC-20 USDT & TRX), Solana (SOL, SPL USDC, SPL USDT), and Arc Mainnet & Testnet (Native USDC Gas) at a flat 0.5% gateway fee (50 bps) with direct wallet-to-wallet settlement.

This repository provides the official 21-Tool Model Context Protocol (MCP) Server (@xpayr/mcp-server & xpayr-mcp), Docker GHCR image, OpenAPI 3.1.0 / ChatGPT Custom GPT Action schemas, and ready-to-import n8n automation workflows.


⚡ One-Click & Instant Setup (Claude Desktop, Cursor, VS Code, Docker)

Option A: One-Click IDE Deep Links

Option B: Claude Desktop / Cursor (claude_desktop_config.json or .cursor/mcp.json)

{
  "mcpServers": {
    "xpayr": {
      "command": "npx",
      "args": [
        "-y",
        "@xpayr/mcp-server",
        "--suite",
        "all"
      ],
      "env": {
        "XPAYR_API_KEY": "sk_test_your_xpayr_secret_key"
      }
    }
  }
}

Option C: Zero-Install Docker Container (GitHub Container Registry)

docker run -i --rm -e XPAYR_API_KEY="sk_test_your_key" ghcr.io/xpayrcom/xpayr-mcp-server:latest

🛠️ Complete 21-Tool MCP Catalog (tools/list)

#MCP Tool NameSuiteUnderlying API RouteDescription
1xpayr_health_checkmerchantGET /healthCheck XPayr Gateway API v1 operational health, version, and server timestamp.
2xpayr_create_payment_sessioncheckoutPOST /paymentsCreate a non-custodial crypto payment session supporting Web3 1-Click Pay, Direct Exchange QR Transfer, Multi-Chain Links, 1-Year Reusable Links, and Automated HTML Invoice Email Delivery.
3xpayr_get_payment_sessioncheckoutGET /payments/{session_id}Retrieve full details, metadata, settlement split amounts, checkout mode, and on-chain transaction hash for a payment session.
4xpayr_list_payment_sessionscheckoutGET /paymentsList merchant crypto payment sessions with filtering by status, currency, network, and pagination.
5xpayr_get_public_payment_statuscheckoutGET /payments/{session_id}/statusPoll real-time public checkout status, on-chain tx_hash, sender wallet address, block confirmations, and paid_at timestamp without an API key.
6xpayr_apply_payment_couponcheckoutPOST /payments/{session_id}/couponValidate and apply a merchant promotional discount coupon code to an active pending payment session.
7xpayr_get_merchant_profilemerchantGET /meRetrieve authenticated merchant profile, settlement wallet address, commission rate in basis points (50 bps = 0.5%), and active API keys.
8xpayr_get_merchant_balancemerchantGET /me/balanceQuery confirmed non-custodial settlement volume, transaction counts, and platform fees grouped by currency and blockchain network.
9xpayr_get_supported_networksmerchantGET /me/networksList all active EVM, TRON, Solana, and Arc Mainnet/Testnet blockchain networks, chain IDs, RPC endpoints, splitter contracts, and supported tokens.
10xpayr_get_webhook_configwebhooksGET /webhooksInspect the merchant webhook callback URL, masked HMAC-SHA256 signing secret, and subscribed payment lifecycle events.
11xpayr_set_webhook_endpointwebhooksPOST /webhooksConfigure or update the merchant HTTPS webhook receiver URL and generate a fresh 32-byte HMAC-SHA256 signing secret.
12xpayr_send_test_webhookwebhooksPOST /webhooks/testSend a signed test.webhook payload with HMAC-SHA256 headers to verify merchant webhook signature verification.
13xpayr_create_ai_agentagentsPOST /agentsProvision a new merchant-managed AI commerce agent identity with scoped credentials and programmable spending guardrails.
14xpayr_list_ai_agentsagentsGET /agentsList all AI commerce agents managed by the merchant along with their status, assigned wallets, and spending policies.
15xpayr_update_ai_agent_policyagentsPUT /agents/{agent_id}/policyConfigure spending policy guardrails for an AI agent (max per-tx USD, daily cap, auto-approve threshold, allowed chains/tokens).
16xpayr_submit_agent_payment_intentagentsPOST /agent-intentsSubmit an autonomous AI agent payment intent evaluated in real time against merchant policy rules (approved, pending_approval, rejected).
17xpayr_list_agent_payment_intentsagentsGET /agent-intentsList AI agent payment intents, policy evaluation decisions, and audit trail records for the merchant.
18xpayr_bridge_agent_intent_to_checkoutagentsPOST /agent-intents/{intent_id}/bridgeBridge an approved AI agent payment intent into a live executable XPayr payment session with hosted checkout URL and on-chain verification.
19xpayr_approve_agent_intentagentsPOST /agent-approvals/{intent_id}/approveApprove a pending AI agent payment intent from the merchant approval queue and bridge it to checkout.
20xpayr_reject_agent_intentagentsPOST /agent-approvals/{intent_id}/rejectReject a pending AI agent payment intent in the merchant approval queue with an audit reason.
21xpayr_calculate_gateway_fee_and_splitmerchantLOCAL /tools/crypto-payment-fee-calculatorDeterministically calculate XPayr flat 0.5% (50 bps) gateway fee split, net merchant wallet settlement, 1% (max $0.50) exchange withdrawal tolerance, and savings vs BitPay, Coinbase Commerce, and Stripe.

🌐 OpenAPI 3.1.0 & ChatGPT Custom GPT Actions

Connect XPayr directly to OpenAI Custom GPTs, Dify.ai, Relevance AI, Retool, or Postman via our hosted OpenAPI 3.1.0 specifications:


🔄 Ready-to-Import n8n Workflows (./n8n-workflows/)

  1. 01-xpayr-multichain-invoice-telegram-bot.json — Generate universal multi-chain payment links and push branded HTML invoices.
  2. 02-xpayr-webhook-order-fulfillment-pipeline.json — Receive signed XPayr webhooks, verify X-XPayr-Signature over the raw body (fails closed when XPAYR_WEBHOOK_SECRET is unset; requires NODE_FUNCTION_ALLOW_BUILTIN=crypto), then confirm settlement via the XPayr status API before fulfilment.
  3. 03-xpayr-ai-agent-autonomous-procurement.json — Autonomous AI agent submits payment intent, passes policy guardrails, and bridges to checkout.
  4. 04-xpayr-daily-multichain-treasury-digest.json — Daily multi-chain treasury settlement digest across EVM, TRON, Solana, and Arc.

🔗 Official XPayr Links & AI Discovery Surfaces