Nupay MCP Server - install, status & alternatives [2026]

01 · Install Nupay

before you install - you'll need

Set NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, MCP_HTTP before connecting. NUPAY_CLIENT_ID, NUPAY_CLIENT_SECRET, NUPAY_ENV are optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-nupay

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-nupay"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-nupay - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Nupay can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a NuPay checkout payment, retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId, retrieve a payment's status by pspReferenceId, and list payments created within a date range.

Capability map

Tools grouped from the project's README - what Nupay lets an agent do.

Payment

6 tools - e.g. Create a NuPay checkout payment.; Retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId.; Retrieve a payment's status by pspReferenceId.

create_payment · get_payment · get_payment_status · cancel_payment · query_payment_conditions · create_preauth_payment

read & search

5 tools - e.g. List payments created within a date range.; List all refunds issued against a given payment.; List registered recipients (final beneficiaries) for the merchant.

list_payments_by_date · list_refunds · list_recipients · list_settlements · get_settlement

Recipient

4 tools - e.g. Register a final beneficiary (required for regulatory split payments).; Retrieve a registered recipient by referenceId.; Update a registered final beneficiary (name, document, country, type).

create_recipient · get_recipient · update_recipient · delete_recipient

Backchannel

3 tools - e.g. Start a CIBA / OTP pre-authorization for a shopper.; Complete a CIBA/OTP flow by submitting the OTP the shopper received.; Resend the OTP to the shopper for an in-flight authorization ticket.

backchannel_start · backchannel_complete · backchannel_resend_otp

Refund

2 tools - e.g. Refund a settled payment (full or partial).; Retrieve refund status by pspReferenceId + refundId.

create_refund · get_refund

auth & access

2 tools - e.g. Exchange an authorization_code or refresh_token at POST /v1/token.; Revoke an issued access_token or refresh_token at POST /v1/token/revoke.

exchange_token · revoke_token

04 · Who maintains Nupay

mcp-nupay is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-nupay (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-nupay

06 · Nupay FAQ

Is Nupay still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Nupay do?

With this server connected, an agent can create a NuPay checkout payment, retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId, retrieve a payment's status by pspReferenceId, and list payments created within a date range.

How do I install Nupay?

Run `npx -y @codespar/mcp-nupay`. The README documents 6 environment variables (NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_ID…) to set first. Set NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, MCP_HTTP before connecting. NUPAY_CLIENT_ID, NUPAY_CLIENT_SECRET, NUPAY_ENV are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Nupay run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Nupay

Alternatives to Nupay

Maintained other servers if Nupay isn't the fit.

More MCP servers to compare · Openpay · Pagbrasil · Pagseguro · Picpay · Rapyd

More JavaScript MCP servers · Pagar Me · Paypal · see all