Nubank's merchant checkout rail — wallet-backed one-click, Pix, and recurrence, backed by Nubank's 100M+ BR customer distribution. Full OpenAPI verified; base platform is Spinpay.
NuPay gives your agent 22 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.
create_payment — Create a NuPay checkout payment. Returns pspReferenceId + the redirect/QR payload the shopper needs to complete the charge (NuPay wallet push or Pix). Use merchant-key auth.get_payment — Retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId. Use this for richer detail than get_payment_status.get_payment_status — Retrieve a payment's status by pspReferenceId.// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });$ npm install @codespar/mcp-nupayAdd this entry to your claude_desktop_config.json (or any MCP-compatible client config).
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "<your_nupay_merchant_key>",
"NUPAY_MERCHANT_TOKEN": "<your_nupay_merchant_token>"
}
}
}
}After restart, your agent can call any of the 22 tools below — try create_payment first.
Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.
NUPAY_MERCHANT_KEYNuPay X-Merchant-Key issued to your merchant
NUPAY_MERCHANT_TOKENNuPay X-Merchant-Token issued to your merchant
NUPAY_CLIENT_IDOAuth2/CIBA client_id for pre-authorized (recurrence) flows. Optional unless using backchannel_start / backchannel_complete.
NUPAY_CLIENT_SECRETOAuth2/CIBA client_secret for pre-authorized flows. Optional unless using backchannel_* tools.
NUPAY_ENVsandbox | production. Defaults to sandbox. Drives both checkout API and auth base URLs.
Each tool is independent — your agent loads only what it needs to reduce context and response time.
create_paymentget_paymentget_payment_statuslist_payments_by_datecancel_paymentcreate_refundget_refundlist_refundsMCP is a protocol — any framework that speaks it can mount this server.