# BCB Full MCP for AI Agents MCP > BCB Full is the definitive connection to Brazil's Central Bank data. It gives your AI client instant access to 20,000+ historical time series across four major domains: currency exchange, interest rates (Selic, CDI), inflation indices (IPCA, IGP-M), and key economic indicators like GDP, debt, and trade balance. Stop searching multiple government sites; get everything in one place. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** central-bank-data, macroeconomics, inflation-indices, interest-rates, financial-time-series, economic-forecasting ## Description Need to model the Brazilian economy? This MCP connects your AI client directly to 20,000+ time series from the Central Bank of Brazil. Forget digging through complex data portals or cross-referencing different rate sheets. With this connector, you ask for a specific metric—say, how did the IPCA compare to the Selic target over the last decade—and you get clean, actionable historical data back. You can track currency fluctuations using PTAX rates across 150+ global currencies, or pull monthly GDP variations and national debt as a percentage of PIB. This level of depth is crucial for any serious financial analysis. If your workflow needs reliable, deep dives into Brazilian macroeconomics, this MCP makes it happen, all managed through the Vinkius catalog. ## Tools ### get_cotacao_dolar Gets the official PTAX quote for the US dollar, including both buy and sell values, for a single day. ### get_dolar_periodo Retrieves the historical series of the PTAX dollar rate over a specified date range, showing open, intermediate, and close values. ### get_cotacao_moeda Fetches the current buy and sell exchange rates for any foreign currency code, such as EUR or JPY. ### listar_moedas Lists every available exotic and major currency code supported by the Central Bank's PTAX system. ### get_dolar_sgs Gets a historical series for the commercial dollar rate (buy/sell) using the more flexible SGS standard, requiring DD/MM/YYYY format. ### get_pib Retrieves the monthly percentage change in Brazil's Economic Activity Index (IBC-Br), which serves as a proxy for GDP. ### get_divida_pib Calculates the public sector net debt as a ratio to the GDP using the SGS series. ### get_reservas Pulls the international reserves held by Brazil in USD, crucial for assessing external commitment capacity. ### get_balanca_comercial Retrieves the net balance of Brazil's trade account using the SGS series. ### get_desemprego Gathers the quarterly unemployment rate for Brazil according to the PNAD survey. ### get_pix_estatisticas Provides statistics on the volume and count of transactions processed through Brazil's instant PIX payment system. ### get_serie_bcb Consults over 200 general time series data points from the Central Bank using their specific SGS codes. ### get_ipca Obtains the Index of Broad Consumer Prices (IPCA), which is the main inflation target used by the BCB. ### get_ipca15 Provides a forecast for the official inflation rate, known as IPCA-15. ### get_igpm Calculates the General Price Index - Market (IGP-M), often used to index rent agreements and contracts. ### get_inpc Retrieves the National Consumer Price Index (INPC), which measures inflation for lower-income households, often guiding minimum wage adjustments. ### get_expectativas_inflacao Gathers market consensus data on inflation forecasts across indicators like IPCA and IGP-DI from the Focus Survey report. ### get_selic_meta Provides the current target rate for Selic, the basic interest rate benchmark set by the COPOM committee. ### get_selic_diaria Pulls the effective daily Selic rate, reflecting the real-time execution of monetary policy. ### get_cdi Retrieves the CDI (Interbank Deposit Certificate) rate, a common benchmark for fixed income investments in Brazil. ### get_expectativas_selic Gathers market consensus data on Selic rate projections from the Focus Survey report. ## Prompt Examples **Prompt:** ``` Give me a briefing on the last 10 years of Brazilian financial health: dollar, Selic, and IPCA. ``` **Response:** ``` **🇧🇷 Brazil Macro Snapshot (Last 10 Years)** * **USD/BRL PTAX:** Started at R$ 3.5x and averaged around R$ 4.5x. * **Selic Rate:** Fluctuated wildly, peaking near 14% before dropping to recent levels. * **IPCA (Annual Avg.):** Showed an average annual rate of approximately 5.2%, illustrating periods of high volatility and subsequent stabilization. (Data sourced from multiple BCB series.) ``` **Prompt:** ``` Compare the trend of GDP growth versus the public debt/PIB ratio since 2010. ``` **Response:** ``` **📈 Brazil Fiscal & Growth Outlook** | Year | IBC-Br (Proxy GDP) | Debt/PIB Ratio | | :--- | :---: | :---: | | 2010 | +5.2% | 48% | | 2015 | -3.3% | 60% | | 2020 | -3.9% | 75% | *Observation:* The decline in GDP correlates strongly with an increase in the debt-to-PIB ratio. ``` **Prompt:** ``` What are the key differences between PTAX and SGS for tracking dollar rates? ``` **Response:** ``` **💱 Dollar Rate Comparison** * **PTAX (Official):** Best for general, official reporting. It's the reference rate used by most financial news. * **SGS (Commercial):** Better for long-term data analysis and modeling because it uses a more flexible structure for historical series tracking. This is what you want when running complex time-series queries. ``` ## Capabilities ### Track Currency Exchange Rates Get historical PTAX and SGS data for the US dollar or any of the 150+ available foreign currencies. ### Analyze Inflation Trends Compare major inflation metrics like IPCA, IGP-M, INPC, and market expectations (Focus Survey) over time. ### Monitor Interest Rate Cycles Retrieve the Selic target rate, daily effective rates, and the CDI benchmark for investment analysis. ### Calculate Economic Indicators Access fundamental metrics like GDP (via IBC-Br proxy), public debt to PIB ratio, and international reserves. ### Assess Market Activity Retrieve data on the PIX payment system's volume or analyze Brazil’s trade balance over periods. ## Use Cases ### Assessing investment risk in Brazil A portfolio manager needs to know if a fixed-income asset is safe. They ask their agent to compare the current CDI rate and Selic target against historical data, providing immediate context on yield fluctuations. ### Writing an inflation report An economist drafts a paper comparing consumer cost pressures. They query get_ipca for the main index, but also use get_igpm and get_inpc to show how different segments of the population are affected. ### Forecasting currency stability A corporate treasurer needs to hedge against potential BRL devaluation. They ask the agent to pull both the PTAX dollar quote (get_cotacao_dolar) and the SGS historical data (get_dolar_sgs) for maximum coverage. ### Analyzing economic growth cycles A research team wants to link GDP performance to debt levels. They combine get_pib results with the get_divida_pib series to plot long-term fiscal sustainability trends. ## Benefits - Compare inflation metrics instantly. You can compare the official IPCA rate against alternative indices like IGP-M or INPC without manually querying different datasets. - Deep dive into currency movements. Use get_dolar_periodo to track PTAX rates over years, while also using list_moedas for access to 150+ exotic currencies. - Build comprehensive economic models. Access multiple critical metrics like GDP (get_pib), public debt (get_divida_pib), and international reserves (get_reservas) in one query. - Understand interest rate cycles. Track the Selic target (get_selic_meta) alongside the daily effective rate (get_selic_diaria) to model policy impact. - Forecast market movements. Compare institutional projections using get_expectativas_inflacao or get_expectativas_selic against historical data points. ## How It Works The bottom line is, you get immediate, unified access to some of the most detailed and historical financial metrics available in Brazil. 1. Tell your AI client what specific Brazilian economic metric you need, including the target date range and currency. 2. The MCP executes multiple calls to the Central Bank's structural data engines (SGS + Olinda OData) simultaneously. 3. You receive a consolidated report containing the requested time series data for all specified indicators. ## Frequently Asked Questions **How do I use the BCB Full MCP to compare inflation over multiple years?** You can easily pull comparative data for major indices like IPCA, IGP-M, and INPC. You just tell your AI client which series you need and the date range, getting all three results in one clean comparison. **Can BCB Full help me track currency exchange rates for non-USD currencies?** Yes, this MCP supports over 150 currencies. You can use its tools to get the PTAX quote or historical data for almost any major foreign currency you need. **What is the best way to check Brazil's economic growth history?** Use the MCP to query the IBC-Br (Índice de Atividade Econômica) series. This provides a strong, reliable proxy for GDP variation over time, which is essential for macro analysis. **Is BCB Full better than just using the government website?** It's much faster and more flexible. Instead of manually downloading multiple CSV files from different pages, your AI client handles all the data retrieval, cleaning, and structuring in one go. **Can I compare market expectations to actual rates using BCB Full?** Absolutely. You can pull both the historical Selic rate (get_selic_diaria) and the latest market projections from the Focus Survey report (get_expectativas_selic) for a full picture. **What kinds of debt metrics can I get using BCB Full?** You can pull the public sector net debt as a percentage of GDP. This key indicator helps you assess Brazil's overall fiscal sustainability over time.