Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP Nupay
Resumen
Descripción del creador (original en inglés)
MCP server for NuPay — Nubank merchant checkout: Pix + wallet one-click for 100M+ BR users
Los tres pilares de PopNx MCP
Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.
- Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
- Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
- UsoiAún sin medir★ –
Qué puedes hacer con él
Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.
- Conexión: Se ejecuta en tu computadora
- Transporte: stdio
- Categoría: Tiendas en línea y pagos
- Debes completar: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
Instalación
Elige la app de IA que usas y copia la configuración.
Antes de instalar
- Revisiones básicas: 1 de 1 superadas
- Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
- Debes completar tú:
NUPAY_MERCHANT_KEY,NUPAY_MERCHANT_TOKEN,NUPAY_CLIENT_ID,NUPAY_CLIENT_SECRET,NUPAY_ENV
Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.
Necesitas
- npmNode.js instalado (para el comando npx)
¿Qué app usas?
Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.
Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "your-value",
"NUPAY_MERCHANT_TOKEN": "your-value",
"NUPAY_CLIENT_ID": "your-value",
"NUPAY_CLIENT_SECRET": "your-value",
"NUPAY_ENV": "your-value"
}
}
}
}Ejecuta esto en tu terminal
claude mcp add nupay --env NUPAY_MERCHANT_KEY=your-value --env NUPAY_MERCHANT_TOKEN=your-value --env NUPAY_CLIENT_ID=your-value --env NUPAY_CLIENT_SECRET=your-value --env NUPAY_ENV=your-value -- npx -y @codespar/mcp-nupayCompleta los valores vacíos antes de ejecutarlo.
O copia la configuración tú
Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "your-value",
"NUPAY_MERCHANT_TOKEN": "your-value",
"NUPAY_CLIENT_ID": "your-value",
"NUPAY_CLIENT_SECRET": "your-value",
"NUPAY_ENV": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
O copia la configuración tú
Pégalo en .vscode/mcp.json de tu proyecto
{
"servers": {
"nupay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "your-value",
"NUPAY_MERCHANT_TOKEN": "your-value",
"NUPAY_CLIENT_ID": "your-value",
"NUPAY_CLIENT_SECRET": "your-value",
"NUPAY_ENV": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.
Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.
Valores que debes completar
- NuPay X-Merchant-Key issued to your merchant
- NuPay X-Merchant-Token issued to your merchant
NUPAY_CLIENT_IDenvOAuth2/CIBA client_id for pre-authorized (recurrence) flows. Optional unless using backchannel_start / backchannel_complete.- OAuth2/CIBA client_secret for pre-authorized flows. Optional unless using backchannel_* tools.
NUPAY_ENVenvsandbox | production. Defaults to sandbox. Drives both checkout API and auth base URLs.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub codespar, dueña del repo
- … Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
- … Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Comparado con otros en Tiendas en línea y pagosi
- Más estrellas que el 0% de los otros 1749 servidores de esta categoría
- Publicado en el registro más recientemente que el 14% de los otros 1749 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 1749 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro MCP Nupay?
Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez –, y la última versión (0.2.2) llegó al registro hace 5 meses.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativas
Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.
Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
@codespar/mcp-nupay
MCP server for NuPay — Nubank's merchant checkout rail.
NuPay is Nubank's answer to PayPal / Shop Pay for Brazil: a wallet-backed checkout that leverages Nubank's 100M+ BR customer distribution. Agents create a payment, the shopper confirms inside the Nubank app (push + biometric) or via Pix, and funds settle to the merchant. Pre-authorized flows (CIBA / OTP) unlock recurrence and true one-click for repeat buyers.
Tools (22)
| Tool | Purpose |
|---|---|
create_payment | Create a NuPay checkout payment. |
get_payment | Retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId. |
get_payment_status | Retrieve a payment's status by pspReferenceId. |
list_payments_by_date | List payments created within a date range. |
cancel_payment | Cancel a payment that has not yet been captured/settled. |
create_refund | Refund a settled payment (full or partial). |
get_refund | Retrieve refund status by pspReferenceId + refundId. |
list_refunds | List all refunds issued against a given payment. |
create_recipient | Register a final beneficiary (required for regulatory split payments). |
get_recipient | Retrieve a registered recipient by referenceId. |
update_recipient | Update a registered final beneficiary (name, document, country, type). |
delete_recipient | Remove a registered recipient. |
list_recipients | List registered recipients (final beneficiaries) for the merchant. |
list_settlements | List settlement reports (payouts to the merchant bank account) within a date range. |
get_settlement | Retrieve a single settlement (payout batch) including the list of underlying transactions. |
query_payment_conditions | Query available installment/payment conditions for a given amount and (optionally) shopper CPF. |
create_preauth_payment | Create a NuPay payment using a pre-authorized Bearer access_token (pre-auth / recurrence flow). |
backchannel_start | Start a CIBA / OTP pre-authorization for a shopper. |
backchannel_complete | Complete a CIBA/OTP flow by submitting the OTP the shopper received. |
backchannel_resend_otp | Resend the OTP to the shopper for an in-flight authorization ticket. |
exchange_token | Exchange an authorization_code or refresh_token at POST /v1/token. |
revoke_token | Revoke an issued access_token or refresh_token at POST /v1/token/revoke. |
Install
npm install @codespar/mcp-nupay
Environment
NUPAY_MERCHANT_KEY="..." # X-Merchant-Key issued to your merchant
NUPAY_MERCHANT_TOKEN="..." # X-Merchant-Token (secret) NUPAY_CLIENT_ID="..." # Optional — OAuth client_id for pre-auth / recurrence NUPAY_CLIENT_SECRET="..." # Optional — OAuth client_secret NUPAY_ENV="sandbox" # sandbox (default) | production
Authentication
Two flows:
- Standard merchant API (payments, refunds, recipients, payment-conditions) uses
X-Merchant-Key+X-Merchant-Tokenheaders. No token exchange. - Pre-authorized / recurrence uses OAuth2 + CIBA / OTP. Start with
backchannel_start, validate viabackchannel_complete, then callcreate_preauth_paymentwith the returned Beareraccess_token. Refresh withexchange_token(grant_type=refresh_token). Access tokens expire in 5 minutes; refresh tokens should be stored long-term for recurrence.
Base URLs are derived from NUPAY_ENV:
| Sandbox | Production | |
|---|---|---|
| API | https://sandbox-api.spinpay.com.br | https://api.spinpay.com.br |
| Auth | https://sandbox-authentication.spinpay.com.br/api | https://authentication.spinpay.com.br/api |
JWT client_assertion signing is the caller's responsibility — exchange_token expects an already-signed assertion with client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer.
Run
# stdio (default)
npx @codespar/mcp-nupay
HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-nupay
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.
License
MIT