XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP
21 tools for non-custodial crypto checkout, payment links and webhooks in an AI client
- Pricing
- Paid
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 5 days ago
Similar MCP servers
About XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP
XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
XPayr is a crypto payment gateway where funds settle straight to the merchant's own wallet, and this server lets an assistant drive it. It creates payment sessions (amount, currency, network, metadata, success and cancel URLs, webhook callback), fetches or lists them, polls public checkout status without a key, and applies promotional coupons. The README says there are 21 tools in total, grouped into suites such as merchant and checkout, and it ships as an npm package, a Docker image on GHCR, and a remote HTTP route at /api/mcp.
A merchant secret key is optional for public and offline tools, with sk_test_ keys for testnet and sk_live_ keys for mainnet. The developer site describes spend guardrails, policy-scoped agent keys and a human approval queue for agent purchases, plus HTTP 402 paywalls for APIs, HMAC-signed webhooks and an ES256 licence kit for selling software.
The gateway fee is a flat 0.5% on confirmed payments with no monthly or setup fee, and the MCP server, SDKs and six store plugins are listed as included at no extra charge. Supported rails include TRON, Solana, Base, Arbitrum, Polygon, BNB Chain, Ethereum, Avalanche and Circle Arc.
Install
Run in a terminal
claude mcp add xpayr-mcp-server --env XPAYR_API_KEY='<XPAYR_API_KEY>' -- npx -y @xpayr/mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"xpayr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@xpayr/mcp-server"
],
"env": {
"XPAYR_API_KEY": "<XPAYR_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"xpayr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@xpayr/mcp-server"
],
"env": {
"XPAYR_API_KEY": "<XPAYR_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"xpayr-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xpayr/mcp-server"
],
"env": {
"XPAYR_API_KEY": "<XPAYR_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"xpayr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@xpayr/mcp-server"
],
"env": {
"XPAYR_API_KEY": "<XPAYR_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"xpayr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@xpayr/mcp-server"
],
"env": {
"XPAYR_API_KEY": "<XPAYR_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
XPAYR_API_KEYXPayr Merchant Secret Key (sk_test_... or sk_live_...) from https://xpayr.com/merchant/register (optional for public/offline tools).XPAYR_API_KEYXPayr Merchant Secret Key (sk_test_... or sk_live_...) from https://xpayr.com/merchant/register (optional for public/offline tools).
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- xpayr_health_check
- Checks gateway API health, version and server timestamp.
- xpayr_create_payment_session
- Creates a non-custodial crypto payment session.
- xpayr_get_payment_session
- Retrieves a payment session's details, split amounts and transaction hash.
- xpayr_list_payment_sessions
- Lists payment sessions with filters and pagination.
- xpayr_get_public_payment_status
- Polls public checkout status without an API key.
- xpayr_apply_payment_coupon
- Validates and applies a promotional coupon to a payment session.
What it does
- Payment session creation
- Creates checkout sessions with amount, network, metadata, redirect URLs and webhook callback.
- Public status polling
- Reads checkout status, transaction hash and confirmations without an API key.
- Agent spend guardrails
- Policy-scoped agent keys and a human approval queue limit what an AI agent can spend.
- HMAC signed webhooks
- Sends payment.completed and payment.failed events verified by signature.
- Three ways to run
- Use the npm package, a GHCR Docker image or the remote HTTP endpoint.
- Testnet sandbox
- Test keys let you run sessions on testnets before going to mainnet.
Good for
- Create a USDT or USDC payment link from a chat
- Check whether a customer's payment has confirmed
- Test a checkout and webhook flow on testnet
- Let an agent pay for services within a spend limit
- Migrate webhook handling from another crypto gateway
Pricing
Paid
0.5% fee per confirmed payment; no monthly fee; MCP server included
Prices change. Check xpayr.com before you buy.
XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP FAQ
What does the gateway charge?
A flat 0.5% on confirmed payments, with no setup or monthly fee, according to the pricing page.
Is it custodial?
No. The site says 99.5% of each payment settles directly into the merchant's own wallet.
Do I need an API key?
A merchant secret key (sk_test_ or sk_live_) is needed for account actions but is optional for public and offline tools.
How many tools does it expose?
21, per the README and registry entry.
Is XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP free?
No. XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP is a paid product.
How do I add XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP to Claude Code?
Run this command in your terminal: claude mcp add xpayr-mcp-server --env XPAYR_API_KEY='<XPAYR_API_KEY>' -- npx -y @xpayr/mcp-server
What are the best alternatives to XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP?
The closest alternatives to XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP are X402 Payagent MCP, Voidpay Marketplace, Clawpay, xpay Finance and AgentPay — trust routing + spend caps for x402 agents.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.