# BCB Full MCP for AI Agents AI Agent Connect > BCB Full — Inteligência Financeira Completa do Brasil provides direct access to the Brazilian Central Bank's core financial data. It covers PTAX dollar rates, 150+ currency quotes, Selic interest rates, CDI, and inflation indices like IPCA and IGP-M. It also pulls Focus Survey expectations, GDP figures, debt metrics, and PIX transaction statistics. With access to over 20,000 SGS time series, it is a complete solution for pulling granular Brazilian macroeconomic data into your agent's workflow. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_YOY01B82Te1cq2v43ysF4wnPSIr4NpeN8f7MzWHC/ai-agent-connect - **Tags:** central-bank-data, macroeconomics, inflation-indices, interest-rates, financial-time-series, economic-forecasting ## Description Imagine you are trying to build a real-time dashboard of the Brazilian economy. Usually, this involves jumping between multiple government portals, copying and pasting inflation numbers, and trying to figure out the latest Selic target. It is a mess of tabs and manual errors. This Connector changes that by giving your agent a direct line to the source of truth. You can ask for the latest PIX transaction volumes or compare current inflation against the market's expectations in a single request. Instead of hunting for specific codes, you just tell your agent what you need, and it handles the heavy lifting of pulling that data from the Central Bank's various engines. It is built to handle the nuances of the Brazilian market, whether you are looking at currency fluctuations, agricultural trade balances, or long-term debt sustainability. By connecting this to your workflow through the Vinkius catalog, you stop being a data gatherer and start being a strategist. You get high-fidelity data on everything from the IGP-M index to the latest GDP figures, all delivered in a format your agent can actually reason with. It is about moving from searching for data to analyzing what it actually means for your next move. You get a unified view of the country's economic health without the headache of manual updates. ## Tools ### get_selic_diaria See the actual daily Selic rate reflecting current monetary policy. This shows the real-time execution of the central bank's plans. ### get_cotacao_dolar See the official PTAX dollar exchange rate for a specific date. Use this when you need the official reference for currency conversion. ### get_dolar_periodo See the historical PTAX dollar rates for a specific date range. This lets you track currency trends over the last year. ### get_cotacao_moeda Fetch the current buy and sell price for any of the 150+ available currencies. You can use this to check exchange rates for exotic currencies too. ### listar_moedas See the full list of currency codes supported by the Central Bank's PTAX system. Use this to find the correct code for any specific currency. ### get_dolar_sgs Retrieve commercial dollar buy and sell series from the SGS system. This is a good option for looking at longer historical series. ### get_pib See the monthly GDP variation for Brazil using the IBC-Br indicator. This shows you how the country's economy is growing month by month. ### get_divida_pib Check the public sector net debt as a percentage of the GDP. This is a key metric for understanding fiscal sustainability. ### get_reservas See the current value of Brazil's international reserves in USD. This shows the country's ability to meet its external obligations. ### get_balanca_comercial Retrieve the current balance of Brazil's trade balance. It helps you see the difference between exports and imports. ### get_desemprego See the latest quarterly unemployment rate from the PNAD survey. Use this to monitor the health of the labor market. ### get_pix_estatisticas Pull transaction volumes and counts for the PIX instant payment system. This is great for seeing how the payment landscape is changing. ### get_serie_bcb Query any of the 20,000+ time series from the SGS system using a specific code. This gives you access to a massive amount of historical data. ### get_ipca See the official IPCA inflation index used as the government's inflation target. This is the primary measure of consumer price changes. ### get_ipca15 Retrieve the IPCA-15 inflation preview used by the market to anticipate trends. It provides an early look at upcoming inflation numbers. ### get_igpm See the IGP-M index, which is commonly used for rent and contract adjustments. This is a major index for the Brazilian real estate market. ### get_inpc See the INPC inflation index for families with lower income levels. This is often used as a reference for minimum wage adjustments. ### get_expectativas_inflacao Get the market's expected inflation figures from the Focus Survey. This helps you see what big banks and institutions are predicting. ### get_selic_meta See the target Selic interest rate defined by the COPOM. This is the main benchmark for all other interest rates in the country. ### get_cdi See the CDI rate, which serves as the benchmark for most fixed-income investments. It usually stays very close to the Selic rate. ### get_expectativas_selic Get the market's projected Selic rates from the Focus Survey. This lets you see the consensus for future interest rate moves. ## Prompt Examples **Prompt:** ``` What's the current inflation outlook in Brazil? ``` **Response:** ``` ### Brazil Inflation Outlook Based on the latest **Focus Survey** and official indices: * **IPCA (Official Target):** 5.12% (12m) * **IGP-M (Rent Index):** 4.83% * **INPC (Minimum Wage):** 4.20% * **Market Expectations:** Institutions are projecting a gradual cooling of prices toward the 3.8% threshold by year-end. *Note: These figures are pulled directly from the Central Bank's latest reports.* ``` **Prompt:** ``` Give me a summary of the current interest rates. ``` **Response:** ``` ### Current Brazilian Interest Rates Here is the current snapshot of the monetary policy landscape: | Rate Type | Value | Context | | :--- | :--- | :--- | | **Selic Meta** | 14.25% | Target defined by COPOM | | **Selic Diária** | 14.15% | Actual daily execution | | **CDI** | 14.15% | Benchmark for fixed-income | Rates remain stable as the Central Bank balances inflation targets against economic growth. ``` **Prompt:** ``` How is the trade balance looking? ``` **Response:** ``` ### Brazil Trade Balance Update Brazil is currently reporting a **Trade Balance Surplus**. * **Status:** Surplus * **Primary Drivers:** Strong performance in agribusiness exports and mineral commodities. * **Details:** The current surplus is being pushed by high demand for Brazilian exports, offsetting the costs of imported goods. ``` ## Capabilities ### Pull real-time currency quotes Fetch current exchange rates for over 150 currencies including PTAX and exotic pairs. ### Fetch historical inflation data Retrieve historical numbers for IPCA, IGP-M, and INPC to track price changes over time. ### Retrieve Central Bank interest rates Get the current Selic target, daily Selic rates, and CDI benchmarks instantly. ### Get market expectation reports Access the latest Focus Survey predictions for inflation and interest rates. ### Access national GDP and debt figures Pull official data on Brazil's GDP growth, public debt, and international reserves. ### Query specific time series data Access a massive library of over 20,000 historical time series from the SGS system. ## Use Cases ### Monitoring interest rate shifts A currency trader needs to compare the daily Selic rate against the CDI to see how fixed-income yields are shifting in real-time. ### Validating payment trends A fintech founder wants to know if PIX transaction volumes are growing month-over-month to justify a new feature investment. ### Analyzing inflation previews A macro analyst wants to see if the IPCA-15 inflation preview is significantly higher than the official IPCA target for the month. ### Assessing trade health An export business owner needs the latest trade balance and GDP numbers to assess the health of the Brazilian economy for the quarter. ## Benefits - Stop manual data entry by letting your agent pull IPCA and IGP-M figures directly into your reports using dedicated inflation tools. - Monitor FX risk instantly with real-time PTAX and 150+ currency quotes using get_cotacao_moeda for diverse currency pairs. - Analyze long-term trends faster by querying 20,000+ SGS time series via get_serie_bcb to spot macro patterns. - Stay ahead of policy shifts by getting the latest Selic targets and Focus Survey expectations for more accurate forecasting. - Track payment ecosystem growth by pulling PIX transaction volumes with get_pix_estatisticas to validate market adoption. - Evaluate sovereign risk quickly using get_divida_pib and get_reservas to compare debt levels against national liquidity. ## How It Works The bottom line is you get instant, accurate Brazilian macroeconomic data without ever leaving your chat interface. 1. Connect your MCP-compatible client to the Vinkius platform and enable the BCB Full MCP. 2. Ask your agent a natural language question about Brazilian finance, such as 'What was the IPCA last month?' 3. Receive a structured response containing the specific data points pulled directly from the Central Bank. ## Frequently Asked Questions **Can the BCB Full MCP provide the latest inflation rates?** Yes, it pulls the most recent IPCA, IGP-M, and INPC figures directly from the Central Bank. This allows you to see official inflation trends without visiting multiple government websites. **Does this Connector support all Brazilian currencies?** It provides access to over 150 currency codes, including PTAX rates for major and exotic currencies. You can check buy and sell prices for a wide range of global pairs. **How can I get the latest Focus Survey data?** The Connector includes tools to pull the market's expected inflation and interest rate projections. You can see what major financial institutions are predicting for the future. **Can I use this to track the daily Selic rate?** Yes, you can retrieve both the target Selic rate and the actual daily Selic rate. This is perfect for monitoring real-time monetary policy changes. **What is the difference between PTAX and SGS dollar rates?** PTAX is the official reference rate for the Brazilian exchange market. SGS is a broader system that includes various commercial and historical series, giving you more flexibility for different types of analysis. **Can I get PIX transaction statistics?** Yes, the Connector can pull transaction volumes and counts for the PIX instant payment system. This helps you monitor the growth and usage of Brazil's primary payment method. **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 Connector 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. **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.