About mcp-niubiz
@codespar/mcp-niubiz is an MCP server for Niubiz, a Peruvian card acquirer. It implements the three-step ecommerce flow of security token, checkout session and authorization, plus same-day reversal. Card data is entered into Niubiz's own checkout form and does not pass through the server.
Key features
- 01Security token retrieval with automatic caching
- 02Checkout session creation with amount and antifraud data
- 03Transaction authorization via transactionToken
- 04Same-day authorization void
Use cases
- 01Integrate Niubiz's three-step payment flow into a Peruvian online store
- 02Void a same-day authorization made in error
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-niubizNIUBIZ_USERSecretNiubiz API userNIUBIZ_PASSWORDSecretNiubiz API passwordNIUBIZ_MERCHANT_IDMerchant id (código de comercio)NIUBIZ_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| force | boolean | No | Force a fresh token even if one is cached |
Details
From the project 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.
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.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
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 |
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
| 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 | no | sandbox (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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.