How to Use the Belvo MCP in Mastra AI

Q: How do I run background financial audits with Belvo and Mastra AI?

You can schedule a workflow that calls listbalances across all active links at regular intervals. The framework executes this headless task in the background and logs the outputs directly to your monitoring console.

Build self-healing financial workflows in Mastra AI using the Belvo MCP Server for Latin American banking data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Belvo MCP to Mastra AI

Create your Vinkius account to connect Belvo 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 Belvo with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated LatAm Income Verification

The `list_incomes` tool allows your Mastra AI agent to analyze multiple bank statements and verify creditworthiness across Latin America. Verifying creditworthiness in Latin America requires analyzing multiple bank statements. With Mastra AI, you can build a workflow that triggers these checks and branches conditionally based on the results. If a bank's API is slow, Mastra's built-in workflow engine handles retries automatically. This prevents your onboarding pipeline from breaking when a local institution experiences temporary downtime.

Self-Healing Expense Tracking in Mastra AI

Using the `list_recurring_expenses` tool, your Mastra AI agent can identify subscription patterns and trigger automated alerts. Tracking recurring expenses across multiple bank links often fails due to expired credentials. By integrating this MCP Server, your agent catches errors and initiates a re-authentication flow. You write the logic in clean TypeScript and deploy it to your cloud with one command. The framework coordinates the tool calls, ensuring that data fetched via `list_transactions` is parsed and categorized without manual intervention.

Multi-Source Portfolio Analysis

The `get_investments` tool lets your agent query asset portfolios across various Latin American institutions simultaneously. Gathering investment data usually requires querying multiple endpoints. This setup lets your agent inspect everything in a single run. You can set up human-in-the-loop approvals using the `requireToolApproval` flag before running any heavy data extraction. This ensures your team can review the query scope before the agent pulls sensitive financial structures.

Setup guide

Set up Belvo 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 Belvo 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: "belvo-mcp-client",
  servers: {
    "belvo-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Belvo 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 Belvo. 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 Belvo 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 Belvo MCP in Mastra AI

Instantiate the client with your Vinkius HTTP URL in your Mastra configuration. After that, call `listTools()` on the MCP connection and spread those tools directly into your agent's tool array.

Yes, Mastra's workflow engine uses exponential backoff to retry failed tool calls like `list_accounts`. If a connection remains broken, you can write a conditional branch that flags the link for user attention.

You can schedule a workflow that calls `list_balances` across all active links at regular intervals. The framework executes this headless task in the background and logs the outputs directly to your monitoring console.

Yes, you can configure your agent to require approval before calling tools like `list_transactions`. This keeps sensitive financial lookups gated behind manual team confirmation.

Your banking credentials and raw balance details are processed entirely in memory within a zero-trust, ephemeral V8 container. Vinkius manages the authentication tokens securely, ensuring no persistent storage of your financial keys ever occurs.

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