{"_id":"@codespar/mcp-nubank","_rev":"5-182bcff7fedf9facdbf82ee1743169ec","name":"@codespar/mcp-nubank","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-nubank","version":"0.1.0","keywords":["nubank","banking","brazil","open-finance","pix","neobank","mcp"],"license":"MIT","_id":"@codespar/mcp-nubank@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nubank":"dist/index.js"},"dist":{"shasum":"cecb401bc43ff766cbd8fa31465febefefab3e0b","tarball":"https://registry.npmjs.org/@codespar/mcp-nubank/-/mcp-nubank-0.1.0.tgz","fileCount":4,"integrity":"sha512-nWSm0w/IevQ/oXGSJwvvhJ88hjvRW0WDY+GqpbE+xeQUOFhtWkshrThNwcNj/gVZuaM/aGFg9MB9Mwr2n8d7lA==","signatures":[{"sig":"MEYCIQCfkjcISFakb9FLslSK8wHbewAPAJxj6XcOzikX0htBWQIhAOSGFqFlNFyz0LaHVTsyaREHKFq57QO6RyaTOe1sfSad","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15676},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"d6f0607828e051fb04b9a5e1069929dc2c06927f","mcpName":"io.github.codespar/mcp-nubank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nubank — Brazilian neobank via Open Finance, accounts, PIX, transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nubank_0.1.0_1776008642627_0.5151987642577212","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-nubank","version":"0.2.0-alpha.1","keywords":["nubank","banking","brazil","open-finance","pix","neobank","mcp"],"license":"MIT","_id":"@codespar/mcp-nubank@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nubank":"dist/index.js"},"dist":{"shasum":"21988110241c365362a22c96016d293c833199f1","tarball":"https://registry.npmjs.org/@codespar/mcp-nubank/-/mcp-nubank-0.2.0-alpha.1.tgz","fileCount":4,"integrity":"sha512-z9cwYsR/haZLnAyESWm3dHIusrGSqO9OmgI1zp8k97vBwmibTqHiqJJrcNLe2/9yl8aatMvSjVTBXQwK9c/dbg==","signatures":[{"sig":"MEUCIGNRflBYBoFur+XJJ+yCFLDneK4aJHTCTFaBdG+iXX8yAiEAo1Z6x/9OlSrjZmM6WTVFgz1+lSB0Vy27PWil8dYkj94=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26086},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"206367773b96786003af53c16c38c7c3d6f823bd","mcpName":"io.github.codespar/mcp-nubank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nubank — Brazilian neobank via Open Finance, accounts, PIX, transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nubank_0.2.0-alpha.1_1777069522547_0.7658897594973209","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-nubank","version":"0.2.0-alpha.2","keywords":["nubank","banking","brazil","open-finance","pix","neobank","mcp"],"license":"MIT","_id":"@codespar/mcp-nubank@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nubank":"dist/index.js"},"dist":{"shasum":"ebdf18a4697f2bc0cb279b1f77a635fc365248d4","tarball":"https://registry.npmjs.org/@codespar/mcp-nubank/-/mcp-nubank-0.2.0-alpha.2.tgz","fileCount":4,"integrity":"sha512-+ZrvKlyV3zGWZcjoC808Gn9h21k2Wa3MLtHXse4hptR1WDMjFHC3jLTi/NidyGb9O50UN7GEiJ9ppZLFM4KCug==","signatures":[{"sig":"MEUCIQC2gY76g5Us1iVx3cJjX3ifj1e4RugEz5HW3+GTQb6JdgIgBRnzhSyTtj/BGJQJbVSeKcjiIhS8578Lxm0dzJUG+Ng=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27176},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-nubank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nubank — Brazilian neobank via Open Finance, accounts, PIX, transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nubank_0.2.0-alpha.2_1777123224310_0.5763578488833261","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-nubank","version":"0.2.0-alpha.3","description":"MCP server for Nubank — Brazilian neobank via Open Finance, accounts, PIX, transfers","type":"module","main":"dist/index.js","bin":{"mcp-nubank":"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":["nubank","banking","brazil","open-finance","pix","neobank","mcp"],"mcpName":"io.github.codespar/mcp-nubank","_id":"@codespar/mcp-nubank@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-lgvadv0MLdrr/gHyW2TztyHBDfG8S0FR2eooUZlZN6sk5ufpRT5TgWF+X3tbx0LxB95pbdrC9i6di4e8lnELNA==","shasum":"fcabf064596f868139bb2e703c775e9ccc824dc9","tarball":"https://registry.npmjs.org/@codespar/mcp-nubank/-/mcp-nubank-0.2.0-alpha.3.tgz","fileCount":4,"unpackedSize":28151,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHkRkQT0NXL0NNk2mrJfsOic2Hl1yMHVVexUkhn1cv/8AiEA8ZOSZyUGblUEyxHpJQzJcw+Td6cHThLvUVdWmT49QAA="}]},"_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-nubank_0.2.0-alpha.3_1782153891796_0.8469558185024113"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T15:44:02.501Z","modified":"2026-06-22T18:44:52.093Z","0.1.0":"2026-04-12T15:44:02.768Z","0.2.0-alpha.1":"2026-04-24T22:25:22.710Z","0.2.0-alpha.2":"2026-04-25T13:20:24.448Z","0.2.0-alpha.3":"2026-06-22T18:44:51.942Z"},"license":"MIT","keywords":["nubank","banking","brazil","open-finance","pix","neobank","mcp"],"description":"MCP server for Nubank — Brazilian neobank via Open Finance, accounts, PIX, transfers","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# MCP Nubank\n\n\n> **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`.\n\nMCP server for **Nubank** — Brazil's largest digital bank, using the Open Finance Brasil standard.\n\n## Quick Start\n\n```bash\n# Set your credentials\nexport NUBANK_CLIENT_ID=\"your-client-id\"\nexport NUBANK_CLIENT_SECRET=\"your-client-secret\"\nexport NUBANK_CERT_PATH=\"/path/to/certificate.pem\"\n\n# Run via stdio\nnpx tsx packages/payments/nubank/src/index.ts\n\n# Run via HTTP\nnpx tsx packages/payments/nubank/src/index.ts --http\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `NUBANK_CLIENT_ID` | Yes | OAuth2 client ID |\n| `NUBANK_CLIENT_SECRET` | Yes | OAuth2 client secret |\n| `NUBANK_CERT_PATH` | Yes | Path to mTLS certificate file |\n| `MCP_HTTP` | No | Set to `\"true\"` to enable HTTP transport |\n| `MCP_PORT` | No | HTTP port (default: 3000) |\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `get_accounts` | List all accounts (checking, savings) |\n| `get_balance` | Get account balance |\n| `get_transactions` | List transactions with filters |\n| `get_credit_card_bill` | Get credit card bill details |\n| `get_investments` | List investments and yields |\n| `initiate_pix` | Initiate a PIX transfer |\n| `get_pix_keys` | List registered PIX keys |\n| `get_statement` | Get account statement for a period |\n| `get_profile` | Get authenticated user profile information |\n| `list_cards` | List debit and credit cards |\n| `get_pix_transfer` | Get status and details of a specific PIX transfer |\n| `schedule_pix` | Schedule a future-dated PIX transfer |\n| `cancel_scheduled_pix` | Cancel a previously scheduled PIX transfer |\n| `create_pix_key` | Register a new PIX key for the authenticated account |\n| `delete_pix_key` | Remove a registered PIX key |\n| `get_card_details` | Get details for a single debit or credit card |\n| `block_card` | Block a card (reports lost/stolen or temporarily disables it) |\n| `unblock_card` | Unblock a previously blocked card (only valid for temporary blocks) |\n| `get_credit_card_transactions` | List transactions for a given credit card bill |\n| `pay_credit_card_bill` | Pay a credit card bill from a linked account |\n| `get_boleto` | Retrieve boleto details by barcode or digitable line |\n| `pay_boleto` | Pay a boleto from a linked account |\n\n## Auth\n\nUses **OAuth2 client credentials** flow with mTLS certificate. Register your application through Nubank's Open Finance portal to obtain credentials.\n\n## API Reference\n\n- [Open Finance Brasil](https://openfinancebrasil.org.br/)\n- [Nubank Developer Docs](https://dev.nubank.com.br/)\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## Authentication\n\nSet these environment variables before launching the server:\n\n- `NUBANK_CLIENT_ID` *(required, secret)* — API key/token for nubank\n\nIssue credentials at the provider's developer portal: <https://openfinancebrasil.org.br>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}