XPayr MCP server
Commit Nov 9, 2026Enables AI clients to create crypto payment sessions, manage merchant accounts, and verify webhooks for direct-to-wallet checkouts.
Also known as xpayrcom/xpayr-node-sdk
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is XPayr MCP?
XPayr enables AI clients to create crypto payment sessions, manage merchant accounts, and verify webhooks for direct-to-wallet checkouts.
Summary generated from the project's README
About XPayr MCP server
Managing cryptocurrency transactions and merchant accounts through an AI client is possible with xpayr-node-sdk. This server allows developers to initiate direct-to-wallet crypto checkouts by creating payment sessions for specific amounts and currencies. It provides the necessary tools to handle merchant account details and network configurations within a Node.js environment.
Users connect to the XPayr Merchant API v1 using a secret key, such as a test key or live credentials. The integration includes specialized methods for managing payments, networks, and webhooks. To ensure security, the server provides a constant-time HMAC-SHA256 webhook verification helper called constructWebhookEvent, which validates incoming request bodies against a webhook secret. This setup is designed for Node.js 18 or newer and requires careful handling of sensitive keys to prevent exposure in browser code.
What you can do with it
- 1Create crypto payment sessionsAn AI client can generate a payment URL for a specific order amount and currency.
- 2Verify incoming payment webhooksDevelopers can use the SDK to securely validate webhook signatures using HMAC-SHA256.
- 3Manage merchant and network dataThe server provides access to various API methods for handling merchant and network information.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablexpayrcom/xpayr-node-sdk is public and reachablegithub.com/xpayrcom/xpayr-node-sdk ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/xpayrcom/xpayr-node-sdk ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubXPayr Node.js SDK
Official Node.js SDK for creating XPayr payment sessions, verifying webhooks, and integrating direct-to-wallet crypto checkout.
Status: Public beta · v0.1.0
Purpose
A small, dependency-light Node.js client for XPayr Merchant API v1 with typed declarations and secure webhook helpers.
Included
- Payment, merchant, network, and webhook API methods
- Typed errors and configurable request timeouts
- Constant-time HMAC-SHA256 webhook verification
Quick start
npm install @xpayr/node-sdk
For repository development:
npm ci
npm test
Use an XPayr test key before live credentials. Never expose sk_test_*, sk_live_*, agent keys, webhook secrets, or wallet private keys in browser code or commits.
Compatibility
- Runtime requirement: Node.js 18 or newer (
package.jsonenforces>=18) - Verified in CI on Node.js 18, 20, and 22
- Package ships ESM entry points with bundled TypeScript declarations
Usage
import { XPayrClient, constructWebhookEvent } from "@xpayr/node-sdk";
const xpayr = new XPayrClient({ secretKey: process.env.XPAYR_SECRET_KEY });
const session = await xpayr.createPayment({
amount: "49.90",
currency: "USDC",
network: "bsc-testnet",
order_id: "ORDER-1001",
});
console.log(session.payment_url);
// In your webhook route, pass the untouched raw request body.
const event = constructWebhookEvent(rawBody, signatureHeader, process.env.XPAYR_WEBHOOK_SECRET);
Documentation
Security
Read SECURITY.md before reporting a vulnerability. Payment completion must be based on verified XPayr webhook/API state and canonical on-chain evidence, not browser callbacks alone.
License
MIT. See LICENSE.
XPayr MCP questions
What Node.js version is required?
The SDK requires Node.js version 18 or newer.
How can I verify webhooks securely?
You can use the provided constant-time HMAC-SHA256 webhook verification helper.
Can I use this for testing before going live?
Yes, you should use an XPayr test key before using live credentials.