io.github.codespar/mcp-niubiz MCP Server

MCP server for Niubiz (ex-VisaNet Perú), a Peru card acquirer with 300k+ merchants. It implements a real ecommerce payments flow: security token → checkout session → authorization, and supports same-day reverse. The project is distributed under the MIT license and includes setup guidance for Claude Desktop.

🛠️ Key Features

Security token handling
Checkout session
Authorization
Same-day reverse
MCP support for ecommerce payments

🚀 Use Cases

Integrate Peru card acquirer authorization into LLM tool workflows
Run ecommerce payment steps (token, session, authorize) via MCP
Perform same-day reversal operations

⚡ Developer Benefits

Access Niubiz payments operations through Model Context Protocol tools
Aligns agent workflows with the described ecommerce payment sequence

⚠️ Limitations

Described scope is payments: security token, checkout session, authorize, and same-day reverse; other payment methods or regions are not stated

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)

Tool

Endpoint

What it does

get_security_token

POST /api.security/v1/security

Bearer token (cached 20 min; other tools auto-fetch)

create_session_token

POST /api.ecommerce/v2/ecommerce/token/session/{merchantId}

Checkout session with amount + antifraud data

authorize_transaction

POST /api.authorization/v3/authorization/ecommerce/{merchantId}

Authorize with the checkout's transactionToken

reverse_transaction

POST /api.authorization/v3/reverse/ecommerce/{merchantId}

Same-day void of an authorization

Variable

Required

Description

NIUBIZ_USER

yes

API user

NIUBIZ_PASSWORD

yes

API password

NIUBIZ_MERCHANT_ID

yes

Merchant id (código de comercio)

NIUBIZ_ENV

sandbox (default) or production

Install

Configuration

Environment variables

NIUBIZ_USERrequiredsecret

Niubiz API user

NIUBIZ_PASSWORDrequiredsecret

Niubiz API password

NIUBIZ_MERCHANT_IDrequired

Merchant id (código de comercio)

NIUBIZ_ENV

Environment: 'sandbox' or 'production'. Defaults to 'sandbox'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-niubiz": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-niubiz@0.1.0"
      ],
      "env": {
        "NIUBIZ_USER": "<YOUR_NIUBIZ_USER>",
        "NIUBIZ_PASSWORD": "<YOUR_NIUBIZ_PASSWORD>",
        "NIUBIZ_MERCHANT_ID": "<YOUR_NIUBIZ_MERCHANT_ID>",
        "NIUBIZ_ENV": "<YOUR_NIUBIZ_ENV>"
      }
    }
  }
}

io.github.codespar/mcp-niubiz