How to Use the Belvo MCP in OpenAI Agents SDK

Q: How do I add the Belvo MCP integration to the OpenAI Agents SDK?

Pass the server URL using MCPServerStreamableHttp into your agent's mcpservers list. The SDK automatically discovers all twelve financial tools. Set cacheToolsList=True to speed up initialization.

Q: Can OpenAI Agents SDK filter which Belvo MCP tools load?

No, the agent auto-discovers everything from getaccount to listtransactions. You rely on the framework's built-in guardrails to restrict what the agent actually executes.

Fetch LATAM financial data straight into your OpenAI Agents SDK apps.

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 OpenAI Agents SDK

Create your Vinkius account to connect Belvo to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Connect the Belvo MCP Server to OpenAI Agents.

`list_links` and `list_institutions` map out the user's connected banks across Latin America. Your agent grabs the authentication tokens and pulls the available endpoints without manual API wiring. OpenAI Agents SDK handles the tool discovery automatically once you pass the server to the constructor. The framework validates every request before hitting the Belvo endpoints so you avoid malformed API calls in production.

Trace account balances and transactions.

`list_balances` and `list_transactions` pull raw ledger data into your Python environment via the MCP protocol. You feed this data into specialized agents that categorize spending or flag unusual activity. The OpenAI dashboard logs every API call your agent makes to these financial endpoints. You see exactly what context the agent used to make a decision, which is critical when dealing with money.

Map incomes and recurring expenses.

`list_incomes` and `list_recurring_expenses` extract cash flow patterns from raw bank feeds. Your agent reads these insights to build credit profiles or verify employment. You hand off the raw data from these tools to a secondary agent built for risk assessment. The SDK manages that transition while keeping the original financial context intact.

Setup guide

Set up Belvo MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Belvo tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Belvo tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Belvo tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Belvo Agent",
            instructions="You have access to Belvo tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Pass the server URL using `MCPServerStreamableHttp` into your agent's `mcp_servers` list. The SDK automatically discovers all twelve financial tools. Set `cacheToolsList=True` to speed up initialization.

No, the agent auto-discovers everything from `get_account` to `list_transactions`. You rely on the framework's built-in guardrails to restrict what the agent actually executes.

The SDK catches the exception and logs it in your tracing dashboard. Your agent can then retry the request or hand the failure off to an error-handling agent.

OpenAI provides native tracing for all function calls. Check your dashboard to see exactly when the agent invoked `get_investments` and what parameters it passed.

This integration reads sensitive transaction histories and investment portfolios. Vinkius isolates the connection in a V8 sandbox that destroys itself after the session ends, ensuring no financial records persist on our infrastructure.

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