XPayr MCP Server

Servidor oficial Model Context Protocol (MCP) com 21 ferramentas para o gateway de pagamentos cripto Web3 multichain não custodial da XPayr (USDT, USDC, SOL, TRX, BNB, ETH, Arc), com Dual Checkout (pagamento Web3 com 1 clique + QR de Exchange), webhooks assinados e comércio de agentes de IA controlado por políticas, com taxa fixa de 0,5%.

Documentação

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