Skip to content
MCP server

XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP

21 tools for non-custodial crypto checkout, payment links and webhooks in an AI client

Runs locally
Install
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-server

Add 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.

How AIPoweredBot checks servers