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

Q: How do I initialize the BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp and define your connection using the unified MCPToolset class pointing to the Vinkius HTTP endpoint. Pass this toolset to your agent's toolsets argument.

Q: Does Pydantic AI validate the currency outputs of BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas?

Yes. Every response from getcotacaomoeda or listarmoedas is validated against Pydantic schemas, ensuring your agent receives correctly typed floats and strings.

Run type-safe Brazilian Central Bank exchange rate queries with Pydantic AI's strict runtime MCP validation.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate PTAX Dollar Queries in Pydantic AI

The `get_cotacao_dolar` tool fetches the official Brazilian PTAX reference rate, returning precise buy and sell values. Because this runs within Pydantic AI, every float, string, and date in the response is validated against strict schemas at runtime. If the Central Bank's API structure changes, the MCP Server translation layer catches it, or Pydantic AI fails loudly before corrupting your downstream databases. This ensures your production code never processes malformed BRL exchange data.

Type-Safe Multi-Currency Lookups

The `get_cotacao_moeda` tool extracts real-time quotes for 150+ global currencies. If your agent needs to check the available currency catalog, it calls `listar_moedas` to pull the complete list of supported Central Bank codes. Pydantic AI validates these currency arrays instantly. You pass the MCPToolset directly into your Agent constructor, enabling type-safe tool calls that work across any LLM backend without custom validation boilerplate.

Validate Historical SGS and PTAX Series

The `get_dolar_periodo` tool retrieves daily PTAX bulletins over a specified timeframe. When you need commercial rates instead of PTAX, `get_dolar_sgs` pulls the historical series directly from the SGS database. Since date formats differ between these tools, Pydantic AI validates that your agent formats inputs correctly before making the call. This prevents runtime errors and API rejections when parsing complex historical financial data.

Setup guide

Set up BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "bcb-cambio-dolar-ptax-euro-e-150-moedas-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas tools.",
)

result = await agent.run("List recent BCB Câmbio — Dólar PTAX, Euro e 150+ Moedas transactions")
print(result.output)

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 Pydantic AI

Install pydantic-ai-slim[mcp] and define your connection using the unified MCPToolset class pointing to the Vinkius HTTP endpoint. Pass this toolset to your agent's toolsets argument.

Yes. Every response from get_cotacao_moeda or listar_moedas is validated against Pydantic schemas, ensuring your agent receives correctly typed floats and strings.

Your Pydantic AI agent can use system prompts or input models to enforce MM-DD-YYYY for get_dolar_periodo and DD/MM/YYYY for get_dolar_sgs before executing the tools.

No. You should use the unified MCPToolset class, as the legacy HTTP class is deprecated in current Pydantic AI releases.

The Vinkius sandbox executes all requests ephemerally. Your PTAX dates, currency codes, and historical query parameters are processed in memory and never stored, keeping your financial logic secure.

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