Mcp Niubiz

io.github.codesparPublished by GitHub account codesparv0.1.0Updated Oct 24, 2026

MCP server for Niubiz — Peru card acquirer: security token, session, authorize, reverse

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Niubiz, Peru's card acquirer, letting an assistant obtain a security token, create a checkout session, authorize a card payment and reverse

What you can do
Obtain a Niubiz security token, cached for about 20 minutes and fetched automatically by the other tools when needed. Create a checkout session with an amount and antifraud data, returning a transaction token. Authorize a transaction using the checkout's transaction token. Reverse an authorization the same day. Card data stays in Niubiz's own checkout form rather than passing through the server.
When to use it
Useful when an assistant needs to drive a Niubiz ecommerce payment flow for a Peruvian merchant: preparing a checkout session, completing an authorization, or voiding a same-day authorization, typically in sandbox while testing an integration.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires the environment variables NIUBIZ_USER, NIUBIZ_PASSWORD and NIUBIZ_MERCHANT_ID, plus optional NIUBIZ_ENV set to sandbox (default) or production. Network access to Niubiz's API is required.
Before you install
The server holds Niubiz API credentials in NIUBIZ_USER and NIUBIZ_PASSWORD; keep them out of shared configs. With NIUBIZ_ENV set to production it can authorize real card payments and reverse authorizations, which moves money, so test in sandbox first. The README also advertises paid enterprise and managed tiers.

Installation

In SourceWeft

  1. Open Mcp Niubiz in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-niubiz

MCP server for Niubiz (ex-VisaNet Perú) — Peru's dominant card acquirer, 300k+ merchants. Implements the real ecommerce flow: security token → checkout session → authorization, plus same-day reverse.

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "niubiz": {      "command": "npx",      "args": ["-y", "@codespar/mcp-niubiz"],      "env": {        "NIUBIZ_USER": "your-api-user",        "NIUBIZ_PASSWORD": "your-api-password",        "NIUBIZ_MERCHANT_ID": "your-merchant-id",        "NIUBIZ_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add niubiz --env NIUBIZ_USER=... --env NIUBIZ_PASSWORD=... --env NIUBIZ_MERCHANT_ID=... -- npx -y @codespar/mcp-niubiz

Cursor / VS Code

Add the same block to .cursor/mcp.json or .vscode/mcp.json.

Tools (4)

ToolEndpointWhat it does
get_security_tokenPOST /api.security/v1/securityBearer token (cached 20 min; other tools auto-fetch)
create_session_tokenPOST /api.ecommerce/v2/ecommerce/token/session/{merchantId}Checkout session with amount + antifraud data
authorize_transactionPOST /api.authorization/v3/authorization/ecommerce/{merchantId}Authorize with the checkout's transactionToken
reverse_transactionPOST /api.authorization/v3/reverse/ecommerce/{merchantId}Same-day void of an authorization

The Niubiz flow

Card data never touches this server: the customer types the card into Niubiz's own checkout form (fed by create_session_token), the form returns a transactionToken, and authorize_transaction completes the purchase. This is Niubiz's standard 3-step ecommerce integration.

Authentication

VariableRequiredDescription
NIUBIZ_USERyesAPI user
NIUBIZ_PASSWORDyesAPI password
NIUBIZ_MERCHANT_IDyesMerchant id (código de comercio)
NIUBIZ_ENVnosandbox (default) or production

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Managed tier

This open-source server calls Niubiz's API directly with your credentials. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, governance, audit and a credential vault: codespar.dev/agents.

License

MIT

Source: packages/payments/niubiz/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts