How to Use the BCB Economia — PIB, Dívida, Reservas, PIX e SGS MCP in OpenAI Agents SDK

Q: How do I use the BCB Economia — PIB, Dívida, Reservas, PIX e SGS server with the OpenAI Agents SDK?

Just pass the Vinkius endpoint URL to MCPServerStreamableHttp and add it to your Agent's mcpservers list. The tools are discovered automatically, so your agent can start querying Brazilian economic data right away.

Q: Is there a way to query any time series with the BCB Economia — PIB, Dívida, Reservas, PIX e SGS MCP Server and OpenAI Agents SDK?

That's what the getseriebcb tool is for. It lets your agent request any of the 20,000+ time series from the BCB's SGS database. You just need to provide the correct series code.

Get real-time Brazilian economic data for your production OpenAI Agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BCB Economia — PIB, Dívida, Reservas, PIX e SGS MCP to OpenAI Agents SDK

Create your Vinkius account to connect BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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 BCB Economia — PIB, Dívida, Reservas, PIX e SGS with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Key Brazilian Economic Indicators

The `get_pib` tool gives your agent the monthly IBC-Br index, a solid proxy for Brazil's GDP. You can also pull the official unemployment rate with `get_desemprego` or check the country's fiscal health using `get_divida_pib`. The OpenAI Agents SDK makes these calls reliable. Its built-in guardrails can validate the parameters your agent sends, preventing bad queries before they happen. This is critical when you're building financial agents that need to be right.

Analyze Brazil's International Standing

The `get_reservas` tool fetches Brazil's international reserves in USD, a key metric for sovereign risk. You can pair this with `get_balanca_comercial` to get the latest trade balance figures. Since Brazil's economy is commodity-driven, this data is essential. Because you're using the OpenAI Agents SDK, you can build specialized agents. One agent could monitor reserves while another watches trade, and they can hand off tasks between each other. All actions are traced in your OpenAI dashboard, so you have a full audit log.

Tap the Full BCB Database with your MCP Server

The `get_serie_bcb` tool is the main event here. It gives your agent access to over 20,000 time series from the BCB's SGS system. Just pass a series code to get data on anything from the Selic interest rate to inflation metrics. This MCP Server exposes that raw power directly to your agent. You don't need to write custom parsers or API clients. The SDK handles the connection, and your agent just sees another simple tool it can call.

Setup guide

Set up BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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 BCB Economia — PIB, Dívida, Reservas, PIX e SGS tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives BCB Economia — PIB, Dívida, Reservas, PIX e SGS tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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="BCB Economia — PIB, Dívida, Reservas, PIX e SGS Agent",
            instructions="You have access to BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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 Banco Central 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 BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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 BCB Economia — PIB, Dívida, Reservas, PIX e SGS MCP in OpenAI Agents SDK

Just pass the Vinkius endpoint URL to `MCPServerStreamableHttp` and add it to your Agent's `mcp_servers` list. The tools are discovered automatically, so your agent can start querying Brazilian economic data right away.

This tool returns the daily transaction volume and total value for PIX, Brazil's instant payment system. It's a high-frequency indicator of consumer activity that's useful for now-casting economic trends.

Yes. Your agent can call tools from this MCP server to get Brazilian economic data, then use other tools to compare it with different datasets. The OpenAI Agents SDK is designed for exactly these multi-tool workflows.

That's what the `get_serie_bcb` tool is for. It lets your agent request any of the 20,000+ time series from the BCB's SGS database. You just need to provide the correct series code.

This server only handles public Brazilian economic data. No PII is ever processed. Your Vinkius endpoint token is the only credential involved, and it's managed within the ephemeral, zero-trust sandbox where the server runs.

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