What is the Focus Survey?

The Focus Survey (Relatório Focus) is a weekly survey published every Monday by Brazil's Central Bank. It collects expectations from ~140 financial institutions about key economic variables: Selic, IPCA, GDP, exchange rate, and more. The median projections are closely watched by markets.

Does this MCP cover both daily currency exchanges and long-term macroeconomics?

Yes! BCB Full is an 'all-in-one' Mega-Server that unifies the PTAX currency gateway alongside deep economic surveys (like the 20k+ SGS series and Focus survey). Use it simultaneously without flipping contexts.

What happens if local BCB APIs are temporarily unstable?

The tool uses streamlined async fetches equipped with silent polling gracefully designed to mitigate brief BCB outages, delivering the latest known cache boundary when direct parsing fails.

BCB Full — Inteligência Financeira Completa do Brasil MCP Server for OpenAI Agents SDK 21 tools — connect in under 2 minutes

Name: BCB Full — Inteligência Financeira Completa do Brasil
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 21 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect BCB Full — Inteligência Financeira Completa do Brasil through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

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

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="BCB Full — Inteligência Financeira Completa do Brasil Assistant",
            instructions=(
                "You help users interact with BCB Full — Inteligência Financeira Completa do Brasil. "
                "You have access to 21 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from BCB Full — Inteligência Financeira Completa do Brasil"
        )
        print(result.final_output)

asyncio.run(main())

BCB Full — Inteligência Financeira Completa do Brasil

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About BCB Full — Inteligência Financeira Completa do Brasil MCP Server

The ultimate Brazil Central Bank Mega-Server — 22 tools across 4 domains.

The OpenAI Agents SDK auto-discovers all 21 tools from BCB Full — Inteligência Financeira Completa do Brasil through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries BCB Full — Inteligência Financeira Completa do Brasil, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

22 Tools

💱 Câmbio (5) — PTAX, period, any currency, catalog, SGS
🏦 Juros (4) — Selic target, Selic daily, CDI, Focus
📈 Inflação (5) — IPCA, IPCA-15, IGP-M, INPC, Focus
🇧🇷 Economia (8) — GDP, debt, reserves, trade, unemployment, PIX, SGS

No API Key Required

2 Engines: SGS (20K+ series) + Olinda OData (PTAX/Focus/PIX)

The BCB Full — Inteligência Financeira Completa do Brasil MCP Server exposes 21 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect BCB Full — Inteligência Financeira Completa do Brasil to OpenAI Agents SDK via MCP

Follow these steps to integrate the BCB Full — Inteligência Financeira Completa do Brasil MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 21 tools from BCB Full — Inteligência Financeira Completa do Brasil

Why Use OpenAI Agents SDK with the BCB Full — Inteligência Financeira Completa do Brasil MCP Server

OpenAI Agents SDK provides unique advantages when paired with BCB Full — Inteligência Financeira Completa do Brasil through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

BCB Full — Inteligência Financeira Completa do Brasil + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the BCB Full — Inteligência Financeira Completa do Brasil MCP Server delivers measurable value.

Automated workflows: build agents that query BCB Full — Inteligência Financeira Completa do Brasil, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries BCB Full — Inteligência Financeira Completa do Brasil, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through BCB Full — Inteligência Financeira Completa do Brasil tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query BCB Full — Inteligência Financeira Completa do Brasil to resolve tickets, look up records, and update statuses without human intervention

BCB Full — Inteligência Financeira Completa do Brasil MCP Tools for OpenAI Agents SDK (21)

These 21 tools become available when you connect BCB Full — Inteligência Financeira Completa do Brasil to OpenAI Agents SDK via MCP:

get_balanca_comercial

O Brasil é um grande exportador de commodities agrícolas, minério e petróleo. Série SGS: 22707. Obter o saldo da balança comercial brasileira

get_cdi

O CDI é a referência para a maioria dos investimentos em renda fixa no Brasil (CDBs, LCIs, LCAs, fundos DI). Geralmente fica muito próximo da Selic. Série SGS: 12. Obter a taxa CDI (Certificado de Depósito Interbancário)

get_cotacao_dolar

Inclui valores de compra e venda. O PTAX é a taxa de referência oficial do câmbio brasileiro, calculada a partir de consultas aos dealers de câmbio. Obter a cotação do dólar americano (PTAX) em uma data específica

get_cotacao_moeda

Use listar_moedas para ver todos os 150+ códigos disponíveis. Inclui compra e venda. Obter cotação de qualquer moeda estrangeira pelo código (EUR, GBP, JPY, etc.)

get_desemprego

Indicador trimestral do mercado de trabalho brasileiro. Série SGS: 24369. Obter a taxa de desemprego do Brasil (PNAD)

get_divida_pib

Indicador fundamental de sustentabilidade fiscal. Série SGS: 4513. Obter a dívida líquida do setor público como % do PIB

get_dolar_periodo

Formato de data: MM-DD-YYYY. Máximo de 1 ano por consulta. Inclui valores de compra, venda e boletins (abertura, intermediário, fechamento). Obter a série histórica do dólar PTAX em um período

get_dolar_sgs

Séries: 1 (compra), 10813 (venda). Mais flexível que PTAX para séries longas. Formato de data: DD/MM/YYYY. Obter a série histórica do dólar comercial (compra/venda) via SGS

get_expectativas_inflacao

Filtre por indicador: IPCA, IGP-DI, IGP-M. Inclui mediana, média, mínimo, máximo e desvio padrão. Obter as expectativas do mercado para a inflação (Relatório Focus)

get_expectativas_selic

Inclui mediana, média, mínimo e máximo das projeções das instituições financeiras. O Focus é publicado toda segunda-feira pelo BCB. Obter as expectativas do mercado para a taxa Selic (Relatório Focus)

get_igpm

Usado como indexador de aluguéis e contratos. Composição: 60% IPA (atacado) + 30% IPC (consumo) + 10% INCC (construção). Série SGS: 189. Obter o IGP-M — Índice Geral de Preços - Mercado

get_inpc

Mede a inflação para famílias com renda de 1 a 5 salários mínimos. Usado como referência para reajustes salariais e do salário mínimo. Série SGS: 188. Obter o INPC — Índice Nacional de Preços ao Consumidor

get_ipca

Usado como meta de inflação pelo BCB. Mede a variação de preços de uma cesta de consumo para famílias com renda de 1 a 40 salários mínimos. Série SGS: 433. Obter o IPCA — Índice Nacional de Preços ao Consumidor Amplo

get_ipca15

Muito acompanhado pelo mercado como antecipação do IPCA. Série SGS: 7478. Obter o IPCA-15 — prévia da inflação oficial

get_pib

Este é o indicador IBC-Br (Índice de Atividade Econômica do Banco Central), uma proxy mensal do PIB. Série SGS: 4380. Obter o PIB mensal do Brasil — variação percentual

get_pix_estatisticas

O PIX é o sistema de pagamentos instantâneos do Brasil, operado pelo BCB. Lançado em novembro de 2020, já é o meio de pagamento mais usado no país. Obter estatísticas do PIX — volume e quantidade de transações

get_reservas

Fundamental para avaliação da capacidade do país de honrar compromissos externos. Série SGS: 3546. Obter as reservas internacionais do Brasil em USD

get_selic_diaria

Reflete a execução real da política monetária. Série SGS: 11. Obter a taxa Selic efetiva (diária)

get_selic_meta

A Selic é a taxa básica da economia brasileira e referência para todas as demais taxas de juros do país. Série SGS: 432. Obter a meta da taxa Selic definida pelo COPOM

get_serie_bcb

000+ séries do Sistema Gerenciador de Séries Temporais (SGS). Pesquise códigos em bcb.gov.br/estabilidadefinanceira/seriestemporais. Exemplos: 11 (Selic), 433 (IPCA), 1 (Dólar). Consultar qualquer série temporal do BCB pelo código SGS

listar_moedas

Inclui moedas exóticas como CLP, COP, MXN, THB, etc. Listar todas as moedas disponíveis no sistema PTAX do Banco Central

Example Prompts for BCB Full — Inteligência Financeira Completa do Brasil in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with BCB Full — Inteligência Financeira Completa do Brasil immediately.

"Complete Brazil financial briefing: dollar, Selic, inflation, and GDP"

"Compare the expected IPCA inflation against the Selic target for next year."

"Extract the complete trade balance deficit metrics."

Troubleshooting BCB Full — Inteligência Financeira Completa do Brasil MCP Server with OpenAI Agents SDK

Common issues when connecting BCB Full — Inteligência Financeira Completa do Brasil to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

BCB Full — Inteligência Financeira Completa do Brasil + OpenAI Agents SDK FAQ

Common questions about integrating BCB Full — Inteligência Financeira Completa do Brasil MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.