How to Use the BCB Economia — PIB, Dívida, Reservas, PIX e SGS MCP in Pydantic AI

Q: How can I use the BCB Economia — PIB, Dívida, Reservas, PIX e SGS server with Pydantic AI for type safety?

Instantiate an MCPToolset with your Vinkius URL and add it to your Pydantic AI Agent. Every tool call's response will be automatically validated against its Pydantic output model, which guarantees data integrity in your app.

Q: What's the difference between getpib and using getseriebcb for GDP?

getpib is a shortcut to series 4380, the IBC-Br monthly GDP proxy. getseriebcb is the general-purpose tool that can fetch any of the 20,000+ series, assuming you know its code.

Get type-safe, validated Brazilian economic data in any Python app with Pydantic AI.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Correct Economic Data, Every Time

This server gives you tools to fetch core Brazilian economic data. `get_pib` grabs the monthly GDP proxy, `get_desemprego` gets the unemployment rate, and `get_divida_pib` reports the debt-to-GDP ratio. Pydantic AI's main job is validation. It checks the response from this MCP Server against a Pydantic model at runtime. If the source API ever changes or returns junk, your code will raise a `ValidationError` instead of silently passing bad data downstream.

Build Model-Agnostic Financial Tools

You can query Brazil's international reserves with `get_reservas` or its trade balance with `get_balanca_comercial`. These tools provide a direct line to data published by the Central Bank. Because Pydantic AI is model-agnostic, you can build your agent with OpenAI, Gemini, or a local model. The tools from this MCP Server will work the same way everywhere. You're not locked into one vendor just to get this financial data.

Access 20,000+ Time Series with Pydantic AI

The `get_serie_bcb` tool is your gateway to the entire SGS database from the Brazilian Central Bank. Just provide a series code, and your agent gets the corresponding time series data. This is where Pydantic AI really proves its worth. It ensures the data structure coming back from this powerful, general-purpose tool is exactly what your application expects. No more writing defensive code or manually parsing unpredictable API responses.

Setup guide

Set up BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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-economia-pib-divida-reservas-pix-e-sgs-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to BCB Economia — PIB, Dívida, Reservas, PIX e SGS tools.",
)

result = await agent.run("List recent BCB Economia — PIB, Dívida, Reservas, PIX e SGS 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 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 Pydantic AI

Instantiate an `MCPToolset` with your Vinkius URL and add it to your Pydantic AI `Agent`. Every tool call's response will be automatically validated against its Pydantic output model, which guarantees data integrity in your app.

`get_pib` is a shortcut to series 4380, the IBC-Br monthly GDP proxy. `get_serie_bcb` is the general-purpose tool that can fetch any of the 20,000+ series, assuming you know its code.

Yes. Pydantic AI doesn't care what model you use. You can connect this MCP Server to an agent running a local model just as easily as one using a major cloud provider. The tool interactions are standardized.

It prevents bad data from corrupting your application. If the MCP Server's response doesn't match the expected Pydantic model for a tool, Pydantic AI will raise a `ValidationError` so you can handle the issue explicitly.

None. The server is designed to access publicly available Brazilian economic data only. Your Vinkius token authenticates your requests, but no personal or private data is ever sent to or processed by the ephemeral MCP Server, which runs in a secure Vinkius sandbox.

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