MCP Nubank

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.

MCP server for Nubank — Brazil's largest digital bank, using the Open Finance Brasil standard.

Quick Start

# Set your credentials
export NUBANK_CLIENT_ID="your-client-id"
export NUBANK_CLIENT_SECRET="your-client-secret"
export NUBANK_CERT_PATH="/path/to/certificate.pem"

# Run via stdio
npx tsx packages/payments/nubank/src/index.ts

# Run via HTTP
npx tsx packages/payments/nubank/src/index.ts --http

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | NUBANK_CLIENT_ID | Yes | OAuth2 client ID | | NUBANK_CLIENT_SECRET | Yes | OAuth2 client secret | | NUBANK_CERT_PATH | Yes | Path to mTLS certificate file | | MCP_HTTP | No | Set to "true" to enable HTTP transport | | MCP_PORT | No | HTTP port (default: 3000) |

Tools (22)

| Tool | Purpose | |---|---| | get_accounts | List all accounts (checking, savings) | | get_balance | Get account balance | | get_transactions | List transactions with filters | | get_credit_card_bill | Get credit card bill details | | get_investments | List investments and yields | | initiate_pix | Initiate a PIX transfer | | get_pix_keys | List registered PIX keys | | get_statement | Get account statement for a period | | get_profile | Get authenticated user profile information | | list_cards | List debit and credit cards | | get_pix_transfer | Get status and details of a specific PIX transfer | | schedule_pix | Schedule a future-dated PIX transfer | | cancel_scheduled_pix | Cancel a previously scheduled PIX transfer | | create_pix_key | Register a new PIX key for the authenticated account | | delete_pix_key | Remove a registered PIX key | | get_card_details | Get details for a single debit or credit card | | block_card | Block a card (reports lost/stolen or temporarily disables it) | | unblock_card | Unblock a previously blocked card (only valid for temporary blocks) | | get_credit_card_transactions | List transactions for a given credit card bill | | pay_credit_card_bill | Pay a credit card bill from a linked account | | get_boleto | Retrieve boleto details by barcode or digitable line | | pay_boleto | Pay a boleto from a linked account |

Auth

Uses OAuth2 client credentials flow with mTLS certificate. Register your application through Nubank's Open Finance portal to obtain credentials.

API Reference

• Open Finance Brasil
• Nubank Developer Docs

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.

Authentication

Set these environment variables before launching the server:

• NUBANK_CLIENT_ID (required, secret) — API key/token for nubank

Issue credentials at the provider's developer portal: https://openfinancebrasil.org.br.

License

MIT