# Belvo MCP for AI Agents AI Agent Connect > Belvo MCP lets you pull financial data from across Latin America into your AI agent. It handles everything from listing active bank connections and account balances to pulling transaction histories and income insights. Use it to audit financial links, check institution coverage, or analyze spending patterns without jumping between different dashboards. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_tbdLwCCXt5CKk2ERMA1JqkPx0QEupUeeqfutMwRu/ai-agent-connect - **Tags:** open-banking, financial-data, api-platform, transaction-analysis, account-aggregation, fintech ## Description Connect your account to the Belvo ecosystem and let your AI agent handle the heavy lifting of financial data gathering across Latin America. If you're building a fintech app for the Brazilian or Mexican market, you know how tedious it is to manually hunt down bank balances or figure out which local institutions you can actually connect to. This Connector plugs your agent directly into Belvo, giving it the eyes to see what's happening across multiple financial links. You can have your agent pull a list of all active accounts, grab current balances for a specific user, or even dig into recurring expenses to help build a budgeting feature. It takes the grunt work out of data fetching. Because Vinkius hosts this Connector, you can jump from checking a single transaction to auditing an entire portfolio of investment holdings in one conversation. It turns your agent into a specialized financial analyst that understands the nuances of Latin American banking data. You get a way to query transaction histories, identify supported regional banks, and pull identity information for account owners without ever leaving your workspace. It turns a multi-step data gathering process into a single conversation, giving you a clear view of accounts and transactions without the tab-switching headache. ## Tools ### get_link Get status and metadata for a specific Belvo link connection. It shows refresh rates and credential storage details. ### list_accounts List all financial accounts across all links including balances and types. This gives you a bird's eye view of all user accounts. ### list_incomes Pull income insights for credit risk and affordability checks. This helps you understand the user's steady cash flow. ### list_institutions Identify all supported banks and fintechs across Latin America. Use this to see what's possible before creating a link. ### list_links List all active connections between your app and end-user accounts. This is the core way to see all user connections. ### list_owners Get identity information for the people behind linked accounts. This helps with KYC and identity confirmation workflows. ### list_recurring_expenses Find recurring patterns like subscriptions and utility bills. Use this for budgeting analysis and subscription auditing. ### list_transactions Get paginated transaction history for spending analysis and audits. It returns debits, credits, and transfers across all links. ### get_account Pull full details for a specific financial account using its ID. This is useful for deep dives into individual account types. ### get_investments Retrieve investment portfolios and holdings for wealth management analysis. Use it to see performance across different assets. ### get_transaction Fetch complete details for a single financial transaction. Use this when you need to see the specifics of one specific move. ### list_balances Get current and available balances for every linked account. It is perfect for quick cash position monitoring. ## Prompt Examples **Prompt:** ``` List all active financial links in my Belvo account. ``` **Response:** ``` I've retrieved the following active connections: | Institution | Status | ID | | :--- | :--- | :--- | | **Itau** | Active | `link_123` | | **Nubank** | Active | `link_456` | | **Uber** | Active | `link_789` | Which one would you like to explore further? ``` **Prompt:** ``` Show my account balances across all links. ``` **Response:** ``` Fetching current balances... I found 2 accounts: * **Savings (Itau)**: R$ 5,000.00 * **Checking (Nubank)**: R$ 1,200.00 Would you like me to summarize the total balance across all links? ``` **Prompt:** ``` List recurring expenses found in my accounts. ``` **Response:** ``` I've identified 4 recurring expense patterns in your linked accounts: * **Netflix** (Subscription) * **Electricity Bill** (Utility) * **Gym Membership** (Subscription) * **Loan Payment** (Debt) Would you like a detailed breakdown for any of these? ``` ## Capabilities ### List all active financial connections Get a full view of every active link between your app and end-user accounts. ### Pull real-time balances Retrieve current and available balances for every linked account instantly. ### Fetch detailed transaction histories Pull paginated results for debits, credits, and transfers across all links. ### Identify supported regional banks See which banks and fintechs are supported across the Latin American ecosystem. ### Extract recurring expense patterns Identify subscriptions, utility bills, and other recurring payments automatically. ### Retrieve investment portfolio holdings Get detailed information on investment performance and holdings. ### Pull identity information Access identity details for the people behind linked accounts for KYC needs. ## Use Cases ### Audit user connections A product manager wants to see how many active links a user has. They ask the agent to list_links to get a quick summary of all active connections. ### Monthly spending report An analyst needs to see recurring costs for a specific user. They ask the agent to list_recurring_expenses to identify subscriptions and bills. ### Regional institution check A developer wants to know if a specific local bank is supported. They ask the agent to list_institutions to verify coverage in a new country. ### Quick balance summary A user wants to see their total liquidity. The agent uses list_balances to pull data from all linked accounts and summarize the total. ## Benefits - Stop manual dashboard navigation by using list_links to see all active connections instantly in your chat. - Speed up credit checks by pulling income insights with list_incomes for faster risk assessment and affordability checks. - Automate spending reports by using list_transactions to gather history across multiple accounts without copy-pasting. - Identify regional coverage quickly with list_institutions to see which banks are supported before you launch. - Simplify subscription auditing by using list_recurring_expenses to spot hidden costs and patterns in user spending. - Manage wealth more effectively by pulling investment holdings with get_investments to see a full portfolio view. ## How It Works The bottom line is that you get direct, conversational access to Latin American financial data without touching the Belvo dashboard. 1. Subscribe to the Belvo MCP on the Vinkius Marketplace. 2. Enter your Belvo Secret ID and Secret Password in your AI client settings. 3. Ask your agent to list accounts, check balances, or summarize transactions. ## Frequently Asked Questions **What can I do with the Belvo MCP?** You can use it to pull banking data, investment holdings, and transaction histories from across Latin America. It lets your agent see balances, identify recurring expenses, and check supported institutions. **Does Belvo MCP support specific Latin American banks?** Yes, it connects to the Belvo ecosystem which includes various banks, fintechs, and fiscal authorities across Latin America. You can use it to see the full list of supported institutions. **Can I use Belvo MCP to check my account balances?** Yes, it can pull the current and available balances for all your linked accounts in one go. This is great for quick cash position monitoring. **How do I get transaction history with Belvo MCP?** The Connector can pull paginated transaction results including debits, credits, and transfers. This is perfect for spending analysis or audit trails. **Is Belvo MCP good for credit risk analysis?** Yes, it can pull income insights derived from transaction analysis. This helps you get a better picture of affordability and credit risk for users. **Can I see investment holdings with Belvo MCP?** Yes, it can retrieve detailed information on investment portfolios and performance across your linked brokerage and investment accounts. **Can I check the balance of a specific account using this integration?** Yes! Use the `get_account` tool with the Account ID. Your agent will fetch the latest balance and account metadata directly from Belvo. **How do I list all transactions for a particular connection?** Simply ask the agent to `list_transactions`. You can then inspect specific transaction details using the `get_transaction` tool with the Transaction ID. **Does the integration support all institutions in Brazil and Mexico?** This integration supports all institutions currently active in your Belvo account across supported countries. Use the `list_institutions` tool to see the full list of available banks and platforms.