How to Use the BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK handle date format validation for BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas?

Yes. While getdolarperiodo requires the MM-DD-YYYY format and getdolarsgs expects DD/MM/YYYY, you can configure the OpenAI Agents SDK guardrails to parse and format dates before executing the tools.

Q: Does this toolset support commercial dollar rates as well as PTAX?

Yes. While getcotacaodolar fetches the official PTAX reference rate, the getdolarsgs tool pulls historical commercial dollar buy and sell series directly from the SGS API.

Feed official Brazilian Central Bank exchange rates directly to your OpenAI Agents SDK pipelines with zero-config MCP tool discovery.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas MCP to OpenAI Agents SDK

Create your Vinkius account to connect BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query PTAX Dollar Rates via OpenAI Agents SDK

The `get_cotacao_dolar` tool pulls the official Brazilian PTAX reference rate directly into your agentic workflow. Your agent requests the purchase and sale values for any specific date, avoiding manual CSV parsing or web scraping. Because the OpenAI Agents SDK handles tool discovery automatically, you just pass this MCP server to the constructor. Your agents execute queries, validate the PTAX data against your guardrails, and trace the execution in your OpenAI dashboard.

Run Multi-Currency Conversions

The `get_cotacao_moeda` tool fetches current buy and sell quotes for any of the 150+ currencies tracked by the Banco Central do Brasil. If your agent encounters an unfamiliar currency code, it runs `listar_moedas` to match the correct Brazilian market symbol first. This multi-tool chain runs safely within the OpenAI Agents SDK environment using the Vinkius MCP connection. The SDK allows specialized agents to hand off currency-checking tasks to dedicated FX-lookup agents without losing context or state.

Fetch Historical FX Trends

The `get_dolar_periodo` tool extracts historical PTAX dollar series for any window up to one year. For longer historical records, your agent calls `get_dolar_sgs` to pull commercial rates directly from the SGS database. When analyzing long-term financial trends, your OpenAI Agents SDK system streams these large historical arrays as structured tool outputs. You configure the agent with cacheToolsList=True to keep tool schemas hot in memory, saving precious latency on repetitive database calls.

Setup guide

Set up BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas Agent",
            instructions="You have access to BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas 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 Câmbio — Dólar PTAX, Euro e 150+ Moedas MCP in OpenAI Agents SDK

Install the SDK via pip and initialize the connection using the MCPServerStreamableHttp class. Pass the server instance directly into your Agent constructor's mcp_servers list to let the agent auto-discover all five tools.

Yes. While get_dolar_periodo requires the MM-DD-YYYY format and get_dolar_sgs expects DD/MM/YYYY, you can configure the OpenAI Agents SDK guardrails to parse and format dates before executing the tools.

The Vinkius infrastructure hosts this server in an isolated sandbox, ensuring rapid responses when your OpenAI Agents SDK system triggers multiple parallel calls to listar_moedas or get_cotacao_moeda.

Yes. While get_cotacao_dolar fetches the official PTAX reference rate, the get_dolar_sgs tool pulls historical commercial dollar buy and sell series directly from the SGS API.

The server only processes the currency codes, dates, and PTAX queries you send. Vinkius runs the server in an ephemeral sandbox, meaning no financial inputs or query parameters are stored or shared.

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