{"_id":"@codespar/mcp-niubiz","name":"@codespar/mcp-niubiz","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-niubiz","version":"0.1.0","description":"MCP server for Niubiz — Peru's dominant card acquirer (ex-VisaNet): session, authorization, reverse","type":"module","main":"./dist/index.js","bin":{"mcp-niubiz":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","niubiz","visanet","payments","acquirer","cards","peru","pen"],"mcpName":"io.github.codespar/mcp-niubiz","_id":"@codespar/mcp-niubiz@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-ukI7cVcihviK9GKzxs4AMLYCz9DkAYoov703bHhd4zNpemfiapxBROMG3XSuj1PwnPUJcm2440lSqsamHDXDMA==","shasum":"4e09290cbdac63d0da7d207425cc428b17c36572","tarball":"https://registry.npmjs.org/@codespar/mcp-niubiz/-/mcp-niubiz-0.1.0.tgz","fileCount":4,"unpackedSize":18151,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCVCa4qG+JVbLkelSOfeM7Onr1OGXfrh7IyikLvJP7pJQIgLNJzqO8QpvT/gC1p/LX7deSWLesLFhCpGPyNf5wzs4I="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-niubiz_0.1.0_1783129669802_0.4650213699000474"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:47:49.599Z","0.1.0":"2026-07-04T01:47:49.938Z","modified":"2026-07-04T01:47:50.235Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Niubiz — Peru's dominant card acquirer (ex-VisaNet): session, authorization, reverse","keywords":["mcp","niubiz","visanet","payments","acquirer","cards","peru","pen"],"license":"MIT","readme":"# @codespar/mcp-niubiz\n\n> 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.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-niubiz)](https://www.npmjs.com/package/@codespar/mcp-niubiz)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"niubiz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-niubiz\"],\n      \"env\": {\n        \"NIUBIZ_USER\": \"your-api-user\",\n        \"NIUBIZ_PASSWORD\": \"your-api-password\",\n        \"NIUBIZ_MERCHANT_ID\": \"your-merchant-id\",\n        \"NIUBIZ_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add niubiz --env NIUBIZ_USER=... --env NIUBIZ_PASSWORD=... --env NIUBIZ_MERCHANT_ID=... -- npx -y @codespar/mcp-niubiz\n```\n\n### Cursor / VS Code\n\nAdd the same block to `.cursor/mcp.json` or `.vscode/mcp.json`.\n\n## Tools (4)\n\n| Tool | Endpoint | What it does |\n|---|---|---|\n| `get_security_token` | `POST /api.security/v1/security` | Bearer token (cached 20 min; other tools auto-fetch) |\n| `create_session_token` | `POST /api.ecommerce/v2/ecommerce/token/session/{merchantId}` | Checkout session with amount + antifraud data |\n| `authorize_transaction` | `POST /api.authorization/v3/authorization/ecommerce/{merchantId}` | Authorize with the checkout's `transactionToken` |\n| `reverse_transaction` | `POST /api.authorization/v3/reverse/ecommerce/{merchantId}` | Same-day void of an authorization |\n\n## The Niubiz flow\n\nCard 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.\n\n## Authentication\n\n| Variable | Required | Description |\n|---|---|---|\n| `NIUBIZ_USER` | yes | API user |\n| `NIUBIZ_PASSWORD` | yes | API password |\n| `NIUBIZ_MERCHANT_ID` | yes | Merchant id (código de comercio) |\n| `NIUBIZ_ENV` | no | `sandbox` (default) or `production` |\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## Managed tier\n\nThis 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](https://codespar.dev/agents).\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-7a70df862e790fcc9ce90ee4543943f5"}