Nubank MCP

mcp-dir/nubank-mcp

Hooks Claude or any MCP client directly into your Nubank account via Brazil's regulated Open Finance API. You get 18 read-only tools covering checking and credit card balances, transaction history, credit card bills with payment breakdowns, investment portfolios (stocks, FIIs, fixed income, mutual funds), and loan contracts. It handles magic-link authentication, consent management, and forced syncs when you need fresh data. Useful if you're building finance agents for Brazilian users or want to query your Nubank data in natural language without opening the app. Hosted server means no local setup, just point your MCP client at the remote endpoint and authenticate.

tools: 24
transport: HTTP
last updated: Jun 11, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.mcp.ai/p_nubank --name nubank-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http nubank-mcp https://api.mcp.ai/p_nubank

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 24 tools

Verified live against the running server on Nov 6, 2026.

openfinance_search_bank_connectorsSearches the available bank connectors by name (pass keywords[], e.g. ['nubank','btg']) and returns, per match: the connector id, whether it's Open Finance or API (`access`), PF/PJ (`audience`), the user's already-linked connections (and accounts when include_accounts=true), a...2 params

Searches the available bank connectors by name (pass keywords[], e.g. ['nubank','btg']) and returns, per match: the connector id, whether it's Open Finance or API (`access`), PF/PJ (`audience`), the user's already-linked connections (and accounts when include_accounts=true), a...

Parameters* required

include_accountsboolean

keywordsarray

openfinance_list_connectionsReturns the saved bank connections for this install: connector_id, item_id, bank name, a per-connection reconnect_url, and an add_connection_url to link additional banks via the Open Finance widget. The reconnect_url reopens the widget in UPDATE mode for that EXISTING connecti...

Returns the saved bank connections for this install: connector_id, item_id, bank name, a per-connection reconnect_url, and an add_connection_url to link additional banks via the Open Finance widget. The reconnect_url reopens the widget in UPDATE mode for that EXISTING connecti...

No parameters. Call it with no arguments.

openfinance_get_item_statusReturns the current status of a bank connection (UPDATED, UPDATING, LOGIN_ERROR, etc.), its executionStatus, connector metadata, and a reconnect_url that reopens the widget in UPDATE mode for that connection (re-authenticate / enter MFA token in place, without disconnecting an...3 params

Returns the current status of a bank connection (UPDATED, UPDATING, LOGIN_ERROR, etc.), its executionStatus, connector metadata, and a reconnect_url that reopens the widget in UPDATE mode for that connection (re-authenticate / enter MFA token in place, without disconnecting an...

Parameters* required

itemstring

item_idstring

item_idsarray

openfinance_provider_statusChecks the LIVE operational status of the Open Finance provider (its public status page) — this is the PROVIDER's health, separate from your own connection's `openfinance_get_item_status`. Use it whenever data looks incomplete or stale even though a connection shows UPDATED (a...

Checks the LIVE operational status of the Open Finance provider (its public status page) — this is the PROVIDER's health, separate from your own connection's `openfinance_get_item_status`. Use it whenever data looks incomplete or stale even though a connection shows UPDATED (a...

No parameters. Call it with no arguments.

openfinance_list_accountsReturns accounts for a bank connection: BANK (checking/savings) and CREDIT (credit card) with balance, number, type, subtype, bankData, and creditData. Also returns `bank` (the brand/connector name like 'Nubank Empresas' — same shown in the dashboard UI) and `connector_id`. No...4 params

Returns accounts for a bank connection: BANK (checking/savings) and CREDIT (credit card) with balance, number, type, subtype, bankData, and creditData. Also returns `bank` (the brand/connector name like 'Nubank Empresas' — same shown in the dashboard UI) and `connector_id`. No...

Parameters* required

itemstring

item_idstring

item_idsarray

typestring

one of BANK · CREDIT

openfinance_list_transactionsReturns transactions for a bank account (BANK or CREDIT type). For CREDIT (credit card) accounts, this is the ONLY way to get itemized transactions (purchases, subscriptions, etc.). Each credit card transaction MAY carry `creditCardMetadata.billId` pointing at a bill from open...8 params

Returns transactions for a bank account (BANK or CREDIT type). For CREDIT (credit card) accounts, this is the ONLY way to get itemized transactions (purchases, subscriptions, etc.). Each credit card transaction MAY carry `creditCardMetadata.billId` pointing at a bill from open...

Parameters* required

account_id*string

account_idsarray

detailstring

one of compact · rich · raw

fromstring

pagenumber

page_sizenumber

search_queriesarray

tostring

openfinance_list_transactions_by_itemConsolidated cash-flow analysis for a whole bank CONNECTION over a period, in ONE call. Resolves the connection's accounts internally and fans out their transactions, so you do NOT need to call openfinance_list_accounts first nor carry account_id uuids between calls. Pass `ite...9 params

Consolidated cash-flow analysis for a whole bank CONNECTION over a period, in ONE call. Resolves the connection's accounts internally and fans out their transactions, so you do NOT need to call openfinance_list_accounts first nor carry account_id uuids between calls. Pass `ite...

Parameters* required

detailstring

one of compact · rich · raw

fromstring

granularitystring

one of monthly · raw

itemstring

item_idstring

item_idsarray

tostring

top_nnumber

typestring

one of BANK · CREDIT

openfinance_list_credit_card_billsReturns CLOSED credit card bills for a CREDIT-type account: dueDate, totalAmount, minimumPaymentAmount, allowsInstallments, plus `payments[]` (id, paymentDate, amount, valueType, paymentMode), `payments_count`, `payments_total`, finance charges aggregates, and a derived `payme...5 params

Returns CLOSED credit card bills for a CREDIT-type account: dueDate, totalAmount, minimumPaymentAmount, allowsInstallments, plus `payments[]` (id, paymentDate, amount, valueType, paymentMode), `payments_count`, `payments_total`, finance charges aggregates, and a derived `payme...

Parameters* required

account_id*string

account_idsarray

include_open_billboolean

pagenumber

page_sizenumber

openfinance_list_investmentsReturns the investment portfolio for a connection (broker or bank with INVESTMENTS product enabled): FIIs, stocks, ETFs, fixed income (CDB/LCI/LCA/Tesouro), mutual funds, retirement (previdência) and COE. Each row carries balance, amount, amountOriginal, amountProfit, lastMont...6 params

Returns the investment portfolio for a connection (broker or bank with INVESTMENTS product enabled): FIIs, stocks, ETFs, fixed income (CDB/LCI/LCA/Tesouro), mutual funds, retirement (previdência) and COE. Each row carries balance, amount, amountOriginal, amountProfit, lastMont...

Parameters* required

itemstring

item_idstring

item_idsarray

pagenumber

page_sizenumber

typestring

one of COE · EQUITY · ETF · FIXED_INCOME · MUTUAL_FUND · SECURITY

openfinance_list_investment_transactionsReturns the movement history for a specific investment position: BUY / SELL / TAX / INTEREST / AMORTIZATION / TRANSFER. Each row carries quantity, value, amount, netAmount, agreedRate (treasury), brokerageNumber, and itemized `expenses` (brokerageFee, incomeTax, settlementFee,...4 params

Returns the movement history for a specific investment position: BUY / SELL / TAX / INTEREST / AMORTIZATION / TRANSFER. Each row carries quantity, value, amount, netAmount, agreedRate (treasury), brokerageNumber, and itemized `expenses` (brokerageFee, incomeTax, settlementFee,...

Parameters* required

investment_id*string

investment_idsarray

pagenumber

page_sizenumber

openfinance_list_loansLists loan contracts per bank connection (GET /loans). Pass `items` as an array of connection selectors (item_id uuid, connector_id, or connector_name) — one entry per connection to fetch; multiple connections are queried sequentially with rate-limit spacing. OMIT `items` to l...1 params

Lists loan contracts per bank connection (GET /loans). Pass `items` as an array of connection selectors (item_id uuid, connector_id, or connector_name) — one entry per connection to fetch; multiple connections are queried sequentially with rate-limit spacing. OMIT `items` to l...

Parameters* required

itemsarray

openfinance_get_loan_detailReturns full loan contract detail by id (GET /loans/:loanId): interestRates[] (taxType, ratePercentage, indexer), contractedFinanceCharges[], balloonPayments[], warranties[], installments schedule (installmentsCount, paidInstallments, numberOfInstallmentsRemaining, installment...1 params

Returns full loan contract detail by id (GET /loans/:loanId): interestRates[] (taxType, ratePercentage, indexer), contractedFinanceCharges[], balloonPayments[], warranties[], installments schedule (installmentsCount, paidInstallments, numberOfInstallmentsRemaining, installment...

Parameters* required

loan_ids*array

openfinance_force_syncForces the bank to re-sync one or more connections NOW and WAITS for it to finish (PATCH /items/:id, then polls until the item stops updating, up to ~60s). Use this when a balance or transaction list looks stale: a connection can read UPDATED yet be hours old, and this pulls f...2 params

Forces the bank to re-sync one or more connections NOW and WAITS for it to finish (PATCH /items/:id, then polls until the item stops updating, up to ~60s). Use this when a balance or transaction list looks stale: a connection can read UPDATED yet be hours old, and this pulls f...

Parameters* required

itemsarray

waitboolean

openfinance_get_account_balanceReturns the latest available balance per account id (GET /accounts/:id/balance). This is the freshest balance the provider can serve, but it is a SNAPSHOT anchored to the connection's last upstream sync: the `updateDateTime`/`updatedAt` in each row is that sync instant, NOT a...1 params

Returns the latest available balance per account id (GET /accounts/:id/balance). This is the freshest balance the provider can serve, but it is a SNAPSHOT anchored to the connection's last upstream sync: the `updateDateTime`/`updatedAt` in each row is that sync instant, NOT a...

Parameters* required

account_ids*array

openfinance_get_accounts_detailReturns full account objects including extended creditData (additional cards, limits) per id (GET /accounts/:id). Pass `account_ids` as an array (1–50). `{ results, errors }` batch shape. May include a `provider_incident` block when the Open Finance provider has an OPEN incide...1 params

Returns full account objects including extended creditData (additional cards, limits) per id (GET /accounts/:id). Pass `account_ids` as an array (1–50). `{ results, errors }` batch shape. May include a `provider_incident` block when the Open Finance provider has an OPEN incide...

Parameters* required

account_ids*array

openfinance_get_credit_card_billReturns bill-level detail for one or more credit card bills by id (GET /bills/:id): `dueDate`, `billClosingDate` (when the cycle closed — the boundary that defines which purchases belong to this bill), `totalAmount`, financeCharges and payments[] (id, paymentDate, amount, valu...4 params

Returns bill-level detail for one or more credit card bills by id (GET /bills/:id): `dueDate`, `billClosingDate` (when the cycle closed — the boundary that defines which purchases belong to this bill), `totalAmount`, financeCharges and payments[] (id, paymentDate, amount, valu...

Parameters* required

account_idstring

bill_ids*array

include_transactionsboolean

transactions_detailstring

one of compact · rich · raw

openfinance_list_categoriesReturns Pluggy's transaction category taxonomy (GET /categories), cached for the adapter session. Each entry has `id` (the categoryId used by openfinance_update_transaction_category), `description` (English), `descriptionTranslated` (Portuguese — prefer this for pt-BR users),...

Returns Pluggy's transaction category taxonomy (GET /categories), cached for the adapter session. Each entry has `id` (the categoryId used by openfinance_update_transaction_category), `description` (English), `descriptionTranslated` (Portuguese — prefer this for pt-BR users),...

No parameters. Call it with no arguments.

openfinance_update_transaction_categoryCorrects the category of one or more transactions (PATCH /transactions/:id). Pass `items` as an array of { transaction_id, category_id } — `transaction_id` comes from openfinance_list_transactions, `category_id` from openfinance_list_categories. This overrides Pluggy's automat...1 params

Corrects the category of one or more transactions (PATCH /transactions/:id). Pass `items` as an array of { transaction_id, category_id } — `transaction_id` comes from openfinance_list_transactions, `category_id` from openfinance_list_categories. This overrides Pluggy's automat...

Parameters* required

items*array

openfinance_disconnect_bankRevokes the Open Finance consent for a specific bank and deletes the connection data. The bank's data will no longer be available. Returns an add_connection_url to re-connect if needed.1 params

Revokes the Open Finance consent for a specific bank and deletes the connection data. The bank's data will no longer be available. Returns an add_connection_url to re-connect if needed.

Parameters* required

item*string

show_versionShow the current MCP platform and adapter versions.

Show the current MCP platform and adapter versions.

No parameters. Call it with no arguments.

report_bugReport a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.3 params

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameters* required

contextstring

default:

conversationstring

default: []

message*string

connectReturns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

No parameters. Call it with no arguments.

toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

No parameters. Call it with no arguments.

marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one...23 params

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one...

Parameters* required

actionstring

one of search · describe · install · uninstall · subscribe · canceldefault: search

argumentsstring

default: {}

cancel_commentstring

default:

cancel_reasonstring

one of too_expensive · missing_features · switched_service · unused · customer_service · too_complex

conversationstring

default: []

immediateboolean

default: false

limitnumber

default: 10

mcp_idstring

default:

messagestring

default:

prompt_bodystring

default:

prompt_categorystring

default:

prompt_descriptionstring

default:

prompt_slugstring

default:

prompt_targetsarray

prompt_titlestring

default:

prompt_toolstring

default:

prompt_varsstring

default: {}

querystring

default:

report_contextstring

default:

request_detailsstring

default:

+3 more parameters. See the server's own documentation for the full schema.

Readme

Nubank MCP

Nubank no Claude, ChatGPT e agentes de IA via Open Finance

Conecte sua conta do Nubank ao Claude, ChatGPT e agentes de IA via Open Finance Brasil. Pergunte sobre saldos, extratos, faturas de cartão e investimentos do Nubank em linguagem natural. Regulado pelo Banco Central, somente leitura.

🏦 Nubank via Open Finance Brasil, regulado pelo Banco Central
💳 Saldos, extratos, faturas de cartão, investimentos e empréstimos
🔒 Somente leitura — a IA não movimenta dinheiro
🔑 Login por magic-link, consentimento explícito e revogável (LGPD)
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

View the full README on GitHub

Details

Repository: github.com/mcp-dir/nubank-mcp
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Nubank MCP

Install

Tools

Readme

Nubank MCP

Nubank no Claude, ChatGPT e agentes de IA via Open Finance

Instalar em 1 clique

Claude (Web e Desktop)

Details

More from mcp-dir