Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP Nupay
Überblick
Beschreibung vom Entwickler (englisches Original)
MCP server for NuPay — Nubank merchant checkout: Pix + wallet one-click for 100M+ BR users
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiNoch nicht gemessen★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Läuft auf deinem Computer
- Transport: stdio
- Kategorie: Onlineshops & Zahlungen
- Das musst du eintragen: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
- Das trägst du selbst ein:
NUPAY_MERCHANT_KEY,NUPAY_MERCHANT_TOKEN,NUPAY_CLIENT_ID,NUPAY_CLIENT_SECRET,NUPAY_ENV
Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.
Du brauchst
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"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"
}
}
}
}Führe das in deinem Terminal aus
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-nupayTrag die leeren Werte ein, bevor du ihn startest.
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"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"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"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"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Werte, die du selbst einträgst
- 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.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto codespar bestätigt, dem das Repo gehört
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Im Vergleich mit anderen in Onlineshops & Zahlungeni
- Mehr Sterne als 0 % der anderen 1745 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 14 % der anderen 1745 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1745 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist MCP Nupay sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.2) kam vor 5 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
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 vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
@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