How to Use the Banco do Brasil MCP in Mastra AI

Q: How can my Mastra AI agent check for new Banco do Brasil invoices?

Your agent should call the getcreditcardinvoices tool. You can set up a workflow that runs this check periodically, extracts the due date and amount, and then schedules a payment.

Q: What's the best way to handle failed Pix payments from Banco do Brasil in Mastra AI?

Wrap your createpix tool call in a Mastra AI workflow with automatic retries. If the payment fails, the framework can try again a few times before escalating to a human or trying a different payment method.

Q: Can a Mastra AI agent get a transaction history from my Banco do Brasil account?

Yes, that's what getstatement is for. The agent can request a statement for a specific date range to analyze spending or look for a particular transaction as part of a larger workflow.

Q: Does this MCP server support human approval for payments?

The server provides the payment tools like createpix. You implement the approval step in your Mastra AI code using its requireToolApproval feature before calling the tool.

Build reliable, automated banking workflows for Banco do Brasil with Mastra AI's resilient agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Banco do Brasil MCP to Mastra AI

Create your Vinkius account to connect Banco do Brasil to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Banco do Brasil with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Bill Payments with Retries

Use `pay_barcode` and `pay_utility_bill` to build a workflow that automatically pays bills on a schedule. Mastra AI's engine handles the logic. If a payment fails, you can configure it to retry automatically with exponential backoff. You can also build conditional logic. For example: try paying with `pay_barcode`. If it fails, check the account balance with `get_balance`. If funds are low, send a notification and stop. This kind of robust automation is what Mastra AI is built for.

Create Complex Financial Workflows

Chain multiple tools together to create sophisticated agents. An agent could run `get_scheduled_payments` daily, cross-reference the amounts with `get_balance`, and then execute payments using `pay_barcode` if there's enough cash. You can also add human-in-the-loop approvals. Before sending a large payment with `create_pix`, your Mastra AI workflow can pause and wait for confirmation via Slack or email. This gives you control over your automated processes.

A Resilient MCP Server for Mastra AI

This MCP Server is the bridge between your Mastra AI agents and your Banco do Brasil account. It exposes all the necessary banking operations as simple tools, so you don't have to deal with the bank's raw API. Just add the server URL to your `MCPClient` configuration. Mastra AI automatically detects the best transport method, giving your agents a stable connection for executing complex, multi-step financial tasks.

Setup guide

Set up Banco do Brasil MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Banco do Brasil tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "banco-do-brasil-mcp-client",
  servers: {
    "banco-do-brasil-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Banco do Brasil Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Banco do Brasil tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Banco do Brasil transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Banco do Brasil. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Banco do Brasil now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Banco do Brasil MCP in Mastra AI

Your agent should call the `get_credit_card_invoices` tool. You can set up a workflow that runs this check periodically, extracts the due date and amount, and then schedules a payment.

Wrap your `create_pix` tool call in a Mastra AI workflow with automatic retries. If the payment fails, the framework can try again a few times before escalating to a human or trying a different payment method.

Yes, that's what `get_statement` is for. The agent can request a statement for a specific date range to analyze spending or look for a particular transaction as part of a larger workflow.

The server provides the payment tools like `create_pix`. You implement the approval step in your Mastra AI code using its `requireToolApproval` feature before calling the tool.

Your data, like Pix transaction histories and account balances, is only ever in memory for the duration of a tool call. The MCP Server runs in a sandboxed V8 isolate that is torn down after each operation. Your Vinkius token authenticates you, and we never store your banking credentials.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript