# Banco do Brasil MCP for AI Agents MCP > Banco do Brasil MCP gives your AI client direct access to core banking functions. Use it to check balances, retrieve detailed transaction statements by date range, send instant Pix transfers using any key, or pay utility bills and barcodes automatically. Manage everything from checking accounts to credit card invoices without needing multiple logins. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** account-management, transaction-history, payment-processing, balance-inquiry, pix-payments, financial-data ## Description Managing finances usually means juggling several apps: the main bank portal for your balance, a separate app for paying utilities, and another for tracking investments. This MCP changes that. It connects your Banco do Brasil account directly to any AI agent, letting you handle complex financial tasks using natural conversation. You can ask it to pull up all transactions from last month's statement, or instantly send money via Pix without knowing the recipient’s exact details. It handles payments for barcodes (like utility bills) and even fetches your credit card invoices so you always know exactly what you owe. Through Vinkius, you get access to this powerful banking capability, letting your AI client manage everything from checking account balances to scheduling future payments automatically. ## Tools ### get_statement Generates a detailed list of all transactions for your account within a specific date range (YYYY-MM-DD). ### get_accounts Retrieves a list of your active checking bank accounts. ### get_balance Pulls the current available funds and associated credit limits for your account. ### create_pix Sends instant money transfers (Pix) to any recipient key, like an email or phone number. ### get_credit_card_invoices Fetches the latest details and total amounts for your credit card bills. ### pay_barcode Processes payments for physical barcodes, typically used for utility or service bills (Boleto). ### pay_utility_bill Pay a utility bill via barcode ### get_pix_history Retrieves a full history of both money you sent and the money you received via Pix. ### get_scheduled_payments Checks which payments are set to go out automatically in the future. ## Prompt Examples **Prompt:** ``` Show me my current balance. ``` **Response:** ``` Available Balance: R$ 2,500.00 | Credit Limit: R$ 500.00 ``` **Prompt:** ``` Send a Pix of R$50 to joao@email.com. ``` **Response:** ``` Pix sent successfully! End-to-End ID: E1234567890123456789012345678901. ``` **Prompt:** ``` Show me the transactions from last week. ``` **Response:** ``` Found 5 transactions: 1. R$ -50.00 (Pix Sent). 2. R$ 2,000.00 (Salary Received). ``` ## Capabilities ### Check all account details Retrieve basic bank information, including the agency and full account number. ### Determine current funds and limits Get an immediate snapshot of your available balance and any associated credit limits. ### Process instant payments Send real-time Pix transfers to a recipient using their CPF, email, or phone number as the key. ### Pay physical bills and utilities Settle outstanding debts by paying utility bills or barcodes (Boleto) directly. ### Review transaction history Pull detailed statements, filtering transactions by a specific date range for accounting purposes. ## Use Cases ### Reconciling monthly income and expenses A freelancer asks their agent: 'Pull my statement for May and show me the Pix history.' The agent uses `get_statement` and `get_pix_history`, giving the full, cross-referenced data needed for tax filing. ### Handling emergency bill payments A user needs to pay an electric bill immediately. They ask their agent to 'Pay the barcode I just scanned.' The agent uses `pay_barcode` and confirms the transaction right away, eliminating manual web form entry. ### Checking cash flow before a large purchase Before buying new equipment, a business owner asks: 'What's my balance?' The agent calls `get_balance`, providing instant confirmation of available funds and limits so the user can proceed confidently. ### Preparing for quarterly reporting An analyst needs data from Q1. They instruct their agent to 'Get all transactions between Jan 1st and Mar 31st.' The agent uses `get_statement`, providing the exact, formatted ledger required for immediate reporting. ## Benefits - Stop manually logging into the bank's website to check funds. Use this MCP to instantly pull your available balance and credit limits using `get_balance`. - Never miss a payment again. You can pay utility bills or barcodes by calling `pay_barcode`, letting your agent handle the details. - Tracking money flow is easy. Instead of downloading PDFs, ask for your transaction history with `get_statement` and get clean data right in your chat window. - Handling transfers becomes simple. Need to send cash? Just trigger `create_pix` by providing any standard Pix key (email or phone number). - Get a full picture of your spending. The `get_pix_history` tool compiles all sent and received transactions, making reconciliation painless. ## How It Works The bottom line is that you talk to your AI client like you're talking to a human banker, and it executes the required action instantly through the bank's systems. 1. Subscribe to this MCP and enter your OAuth2 Access Token from the BB Developers Portal. 2. Your AI client authenticates using the token, establishing a secure link to your bank account data. 3. You prompt your agent with natural language requests (e.g., 'Pay R$150 to João') and receive confirmation or the requested data. ## Frequently Asked Questions **How do I use Banco do Brasil MCP to pay a utility bill?** You simply ask your AI agent to pay the bill. You must provide the physical barcode (Boleto) for the payment, and the MCP uses that code to process the settlement immediately through `pay_barcode`. **Can I check my bank balance with Banco do Brasil MCP?** Yes. You can ask your agent to get an instant snapshot of your available funds and credit limits using `get_balance`. This is much faster than logging into the online portal. **What kind of transactions does Banco do Brasil MCP track?** It tracks all major movements, including Pix transfers (both sent and received) through its detailed history log. You can also retrieve full statements for any specific date range using `get_statement`. **How does Banco do Brasil MCP handle money transfers?** You just tell your agent who you're sending the money to and how much. It uses Pix keys (like an email or phone number) to send funds instantly via `create_pix`. **Is Banco do Brasil MCP better than using a banking website?** It’s different because it's conversational. Instead of clicking through menus, you talk to your agent and it executes complex tasks like paying bills or generating statements directly from the chat interface. **How do I get an Access Token for Banco do Brasil?** You must create a Developer account on [**BB Developers Portal**](https://developers.bb.com.br), create an App, and use your Certificate (mTLS) and Client ID/Secret to generate the Access Token via OAuth2. **Can I pay bills and Pix?** Yes! Use the `pay_barcode` or `create_pix` actions. You will need a valid token with payment permissions. **Does it work for companies (CNPJ)?** Yes, the BB APIs support both Individual (CPF) and Business (CNPJ) accounts, provided your token has the correct scope. **Are the API connections secure?** Absolutely. Banco do Brasil requires mTLS certificates and secure environments for their API connections to ensure financial-grade safety.