Supports XPayr crypto payments and settlement on BNB Chain as part of its EVM multi-chain payment support.
Supports non-custodial XPayr crypto payment sessions and settlement on Ethereum/EVM, including multi-chain payment links and on-chain status verification.
Ships ready-to-import n8n workflows for multi-chain invoices, webhook order fulfillment, AI-agent procurement, and treasury digests.
Provides OpenAPI 3.1.0 and ChatGPT Custom GPT Action schemas so XPayr payment and merchant operations can be used from OpenAI Custom GPTs.
Supports XPayr crypto payments and settlement on Polygon as part of its EVM multi-chain payment support.
Provides OpenAPI specifications for importing and testing XPayr API operations in Postman.
Provides an OpenAPI schema for connecting XPayr payment operations into Retool apps and automations.
Supports Solana payments and settlement, including SOL, SPL USDC, and SPL USDT.
Includes an n8n Telegram bot workflow to generate multi-chain payment links and push branded HTML invoices via Telegram.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@XPayr MCP Server create a $49 USDC payment session on Base for order 1042"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@xpayr/mcp-server)
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.
Cursor IDE: ⚡ Install XPayr MCP in Cursor
VS Code (GitHub Copilot MCP): ⚡ Install XPayr MCP in VS Code
Interactive Web Configurator & Fee Calculator: https://mcp.xpayr.com/ & https://xpayrcom.github.io/
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"
}
}
}
}docker run -i --rm -e XPAYR_API_KEY="sk_test_your_key" ghcr.io/xpayrcom/xpayr-mcp-server:latestRelated MCP server: voulti-mcp
tools/list)# | MCP Tool Name | Suite | Underlying API Route | Description |
1 |
|
|
| Check XPayr Gateway API v1 operational health, version, and server timestamp. |
2 |
|
|
| Create 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. |
3 |
|
|
| Retrieve full details, metadata, settlement split amounts, checkout mode, and on-chain transaction hash for a payment session. |
4 |
|
|
| List merchant crypto payment sessions with filtering by status, currency, network, and pagination. |
5 |
|
|
| Poll real-time public checkout status, on-chain tx_hash, sender wallet address, block confirmations, and paid_at timestamp without an API key. |
6 |
|
|
| Validate and apply a merchant promotional discount coupon code to an active pending payment session. |
7 |
|
|
| Retrieve authenticated merchant profile, settlement wallet address, commission rate in basis points (50 bps = 0.5%), and active API keys. |
8 |
|
|
| Query confirmed non-custodial settlement volume, transaction counts, and platform fees grouped by currency and blockchain network. |
9 |
|
|
| List all active EVM, TRON, Solana, and Arc Mainnet/Testnet blockchain networks, chain IDs, RPC endpoints, splitter contracts, and supported tokens. |
10 |
|
|
| Inspect the merchant webhook callback URL, masked HMAC-SHA256 signing secret, and subscribed payment lifecycle events. |
11 |
|
|
| Configure or update the merchant HTTPS webhook receiver URL and generate a fresh 32-byte HMAC-SHA256 signing secret. |
12 |
|
|
| Send a signed test.webhook payload with HMAC-SHA256 headers to verify merchant webhook signature verification. |
13 |
|
|
| Provision a new merchant-managed AI commerce agent identity with scoped credentials and programmable spending guardrails. |
14 |
|
|
| List all AI commerce agents managed by the merchant along with their status, assigned wallets, and spending policies. |
15 |
|
|
| Configure spending policy guardrails for an AI agent (max per-tx USD, daily cap, auto-approve threshold, allowed chains/tokens). |
16 |
|
|
| Submit an autonomous AI agent payment intent evaluated in real time against merchant policy rules (approved, pending_approval, rejected). |
17 |
|
|
| List AI agent payment intents, policy evaluation decisions, and audit trail records for the merchant. |
18 |
|
|
| Bridge an approved AI agent payment intent into a live executable XPayr payment session with hosted checkout URL and on-chain verification. |
19 |
|
|
| Approve a pending AI agent payment intent from the merchant approval queue and bridge it to checkout. |
20 |
|
|
| Reject a pending AI agent payment intent in the merchant approval queue with an audit reason. |
21 |
|
|
| Deterministically 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. |
Connect XPayr directly to OpenAI Custom GPTs, Dify.ai, Relevance AI, Retool, or Postman via our hosted OpenAPI 3.1.0 specifications:
OpenAI Custom GPT Actions (Flagship 8 Endpoints): https://xpayrcom.github.io/xpayr-portal/openapi-gpt-actions.json
Full 20-Endpoint OpenAPI 3.1.0 Specification: https://xpayrcom.github.io/xpayr-portal/openapi.json
XPayr Production OpenAPI Spec: https://xpayr.com/public/docs/developers/xpayr-openapi-v3.json
n8n Workflows (./n8n-workflows/)01-xpayr-multichain-invoice-telegram-bot.json — Generate universal multi-chain payment links and push branded HTML invoices.
02-xpayr-webhook-order-fulfillment-pipeline.json — Receive signed XPayr webhooks and verify on-chain transaction finality.
03-xpayr-ai-agent-autonomous-procurement.json — Autonomous AI agent submits payment intent, passes policy guardrails, and bridges to checkout.
04-xpayr-daily-multichain-treasury-digest.json — Daily multi-chain treasury settlement digest across EVM, TRON, Solana, and Arc.
Main Platform: https://xpayr.com
Developer Hub: https://xpayr.com/developers
Interactive API Reference: https://xpayr.com/doc-api
Interactive MCP & SDK Portal: https://xpayrcom.github.io/xpayr-portal/
LLM Context (llms.txt): https://xpayr.com/llms.txt
Extended LLM Context (llms-full.txt): https://xpayr.com/llms-full.txt
AI Citation Kit: https://xpayr.com/ai-citation-kit
Free Merchant Testnet Registration: https://xpayr.com/merchant/register
Validate and apply a merchant discount coupon code to an active pending payment session and recalculate the effective crypto price.
Inputs: session_id (required), coupon_code (required).
Approve a pending AI agent payment intent from the merchant human-in-the-loop approval queue and optionally bridge it to a checkout session.
Inputs: intent_id (required), note.
Bridge an approved AI agent payment intent into a live executable XPayr payment session with hosted checkout URL and on-chain verification.
Inputs: intent_id (required).
Deterministically calculate XPayr flat 0.5% (50 bps) gateway fee split, net merchant wallet settlement, exchange withdrawal underpayment tolerance (1%, max $0.50), and cost savings compared to BitPay (1%), Coinbase Commerce (1%), NOWPayments (0.5%-1%), and Stripe (2.9% + $0.30). Works offline without API keys.
Inputs: amount, network, currency.
Provision a new merchant-managed AI commerce agent identity with scoped credentials and programmable spending guardrails.
Inputs: name (required), description, wallet_address.
Create a non-custodial crypto payment session supporting Dual Checkout (Web3 1-Click Pay & Direct Transfer / QR from Binance/Bybit/OKX with on-chain explorer verification), multi-chain agnostic links, 1-year reusable payment links, and automated HTML invoice email delivery.
Inputs: amount (required), currency (required), network, order_id, +9 more.
Query confirmed non-custodial settlement volume, transaction counts, total merchant received amounts, and platform fees grouped by currency and blockchain network.
Inputs: no named parameters.
Retrieve authenticated merchant profile, business name, primary settlement wallet address, commission rate in basis points (50 bps = 0.5%), active API keys, and livemode status.
Inputs: no named parameters.
Retrieve full details, metadata, settlement split amounts, checkout mode, and on-chain transaction hash for a specific XPayr payment session.
Inputs: session_id (required).
Poll real-time public checkout status, on-chain tx_hash, sender wallet address, block confirmations, and paid_at timestamp for any session (public endpoint, no API key required).
Inputs: session_id (required).
List all active EVM, TRON, Solana, and Arc Mainnet/Testnet blockchain networks, chain IDs, RPC endpoints, smart-contract splitters, and supported tokens enabled for the current API key mode.
Inputs: no named parameters.
Inspect the merchant webhook callback URL, masked HMAC-SHA256 signing secret, and subscribed payment lifecycle events (payment.pending, payment.completed, payment.failed, payment.expired).
Inputs: no named parameters.
Check XPayr Gateway API v1 operational health, version, and server timestamp (public endpoint, no API key required).
Inputs: no named parameters.
List AI agent payment intents, policy evaluation decisions, and audit trail records for the merchant.
Inputs: limit, status.
List all AI commerce agents managed by the merchant along with their status, assigned wallets, and spending policies.
Inputs: no named parameters.
List merchant crypto payment sessions with optional filtering by status (pending, completed, expired, failed), currency, network, and pagination.
Inputs: limit, status, network, currency.
Reject a pending AI agent payment intent in the merchant approval queue with an audit reason.
Inputs: intent_id (required), reason.
Dispatch a signed test.webhook event with HMAC-SHA256 headers to the configured merchant webhook URL to verify signature validation and delivery.
Inputs: no named parameters.
Configure or update the merchant HTTPS webhook receiver URL and generate a fresh 32-byte HMAC-SHA256 signing secret.
Inputs: url (required).
Submit an autonomous AI agent payment intent evaluated in real time against merchant spending policy guardrails (returns approved, pending_approval, or rejected).
Inputs: amount (required), currency (required), reason, network, +2 more.
Upsert spending policy rules for an AI commerce agent, including maximum per-transaction USD amount, daily budget cap, auto-approve threshold, and allowed blockchain networks/tokens.
Inputs: agent_id (required), max_tx_amount, allowed_networks, allowed_currencies, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 21 tools
Most tools target a distinct resource+action (sessions, AI agents, intents, webhooks, merchant, networks). The main soft spots are get_payment_session vs get_public_payment_status (both return session status/tx_hash, distinguished only by auth/polling context) and approve_agent_intent's optional 'bridge to checkout' behavior that overlaps with bridge_agent_intent_to_checkout.
All 21 tools use the same xpayr_ prefix plus snake_case verb_noun naming (create_payment_session, list_ai_agents, update_ai_agent_policy, reject_agent_intent). The only deviation is the noun-first xpayr_health_check, which is a trivial and conventional exception.
21 tools is on the heavy side but the server legitimately spans several sub-domains: payment sessions, AI agent commerce, webhooks, merchant account, and fee calculation. Each tool maps to an identifiable operation, though a few (coupon apply, fee calculator) could arguably be folded into broader session tools.
Core lifecycles are well covered: session create/get/list plus coupon and public status, full agent intent flow (submit, list, approve, reject, bridge), and webhook configure/test. Gaps exist around session cancellation/expiry management, coupon admin, and agent deletion/credential revocation, but these are workaround-able for the main payment flow.
Crypto payments for AI agents: self-serve account, invoices, receiving, payouts, exchange.
Non-custodial crypto payments: checkout sessions, invoices, webhooks and test payments. No KYC.
Crypto pay links and API for people and AI agents. BTC, Lightning, USDC, USDT, EURC, SOL, ETH.
Non-custodial crypto payments for AI assistants: balances, payments, and create payment links.
