Manage Nubank Transactions and Transfers via Nubank MX MCP

The App-Switching Tax

We have all been there. You are deep in a coding session in Cursor or managing a project in Claude Desktop, and you realize you need to check if that client payment has cleared your Nubank account. What follows is the inevitable context switch: minimizing your IDE, unlocking your phone, navigating through biometric authentication, and hunting for the transaction history.

This friction is more than just an annoyance; it is a cognitive tax. Every time you leave your primary workspace to perform a routine administrative task, you break your flow. For freelancers in Mexico or developers managing international payments, this fragmentation is particularly costly.

My thesis is simple: Managing your finances should not require leaving your digital environment. By connecting Nubank MX to your AI assistant through the Vinkius MCP server, you transform manual banking into a conversational workflow that lives exactly where you work. You stop navigating menus and start asking questions.

Banking at the Speed of Chat

The power of the Model Context Protocol (MCP) lies in its ability to bridge the gap between static LLMs and real-world actions. When you connect the Nubank MX MCP server via Vinklan Edge, your AI assistant gains a set of specialized tools designed for Mexican banking.

Imagine instead of navigating an app, you simply type a prompt into your IDE. The transition from intention to execution is nearly instantaneous.

Real-World Execution Examples

The following examples demonstrate how natural language prompts translate into precise banking operations using the Nubank MX capabilities.

Checking Your Financial Pulse You can instantly query your real-time balance and even check the annual yield (rendimiento) you are earning on your deposits.

Prompt: “How much do I have in my Nubank account right now?”

AI Response: “Your Nubank Cuenta balance is $47,832.50 MXN. You have $2,150 MXN in pending transactions. Your available balance is $45,682.50 MXN. Your deposits are currently earning 15.0% annual yield (rendimiento). Your CLABE for receiving transfers is: 638180000012345678.”

Executing Interbank Transfers (SPEI) One of the most powerful features is the ability to initiate SPEI transfers. By providing a CLABE number and an amount, you can move money without ever touching a mobile interface.

Prompt: “Send $5,000 MXN via SPEI to CLABE 012180001234567890 with concept ‘Renta abril’.”

AI Response: “SPEI transfer sent successfully! $5,000.00 MXN transferred to CLABE 012180001234567890 (BBVA Mexico). Concept: ‘Renta abril’. Tracking number (clave de rastreo): 2026041000000012345678. Your new available balance is $40,682.50 MXN.”

Automated Spending Intelligence Beyond simple transactions, the server allows you to perform deep audits of your spending habits. You can ask for a breakdown of your monthly expenses by category, helping you identify where your money is going without manual spreadsheet entry.

Prompt: “Show me my spending breakdown for last month.”

AI Response: “Your spending last to month totaled $28,450 MXN across 67 transactions. Top categories: 🍔 Food & Dining: $8,200 (29%) — top merchant: Uber Eats. 🚗 Transportation: $4,500 (16%) — top: Uber rides. 🏠 Housing: $5,000 (18%) — rent payment. 🛒 Shopping: $3,850 (14%). 🎮 Entertainment: $2,100 (7%). Compared to the previous month, you spent 12% more on dining. Would you like detailed insights on any category?”

The Security of the Gateway

When we talk about connecting a bank account to an AI agent, the immediate reaction is understandable concern: “Is this safe?” Handling financial data requires a level of trust that generic integrations cannot provide.

This is where the Vinkius architecture becomes essential. When you use the Nubank MX MCP server, your sensitive credentials—such as your Nubank API Key and Client Secret—are never exposed to the AI model itself (like Claude or GPT-4). Instead, they are securely managed within the Vinkius Edge layer.

The Security Passport and Connection Token

Every connection is governed by two critical components:

The Connection Token: You create a personal token in your Vinkius dashboard. This token acts as your unique identifier for all MCP requests, allowing you to manage which AI clients have access to your tools.
The Security Passport: Every server page on Vinkius features a Security Passport. This transparency report explicitly details exactly what permissions the Nubank MX server uses—such as network access or subprocess execution—and identifies any potentially destructive tools like create_transfer.

Vinkius Edge acts as a managed proxy that handles authentication and routing behind the scenes. Your AI agent sends a request to your Vinkius Edge URL, and Vinkius applies its security policies, including rate limiting and data protection, before communicating with the Nubank API. This structure ensures that even if an AI model is compromised, your underlying banking credentials remain isolated within the secure Vinkius environment.

Honest Limitations

No integration is a perfect solution, and it is important to understand where this workflow might fall short.

First, the automation is dependent on the availability of the Nubank API infrastructure. If there are service disruptions at the bank level, your AI agent will be unable to fetch real-time data or execute transfers.

Second, while the ability to initiate SPEI transfers via natural language is incredibly efficient, it introduces a different kind of responsibility. Because the process is so frictionless, you must remain vigilant about the accuracy of your prompts. An error in a CLABE number or an extra zero in an amount could lead to unintended transactions. While Vinkius provides tools for auditing and visibility through the Guardian Control Plane, the user remains the ultimate authority on the validity of the transaction intent.

Getting Started with Nubank MX

Setting up this connection is designed to be frictionless via Vinkius Quick Connect. You do not need to write complex integration code or manage manual API configurations in your IDE settings.

Step-by-Step Setup

Subscribe to the Server: Find the Nubank MX MCP server in the Vinkius App Catalog.
Configure Credentials: Enter your Nubank API Key and Client Secret into the Vinkius dashboard. These are stored securely and used by Vinkius Edge to authenticate your requests.
Connect Your Client: Use the Vinkius Quick Connect flow to add the connection to your preferred AI client, whether it is Claude Desktop, Cursor, or Windsurf.
Start Chatting: Once connected, simply ask your assistant about your balance, recent transactions, or to initiate a transfer.

By bringing your banking into your development and productivity workflow, you are not just automating a task; you are reclaiming the time lost to context switching. The future of personal finance is not in an app on your phone, but in the conversation you are already having with your AI.

Find the Nubank MX MCP server at https://vinkius.com/mcp/nubank-mx-mcp.