# BCB Economia MCP for AI Agents MCP

> BCB Economia — PIB, Dívida, Reservas, PIX e SGS connects your AI client directly to core Brazilian economic data from the Central Bank of Brazil. Your agent can retrieve monthly GDP proxies, track public debt ratios against GDP, monitor international reserves in USD, and analyze payment statistics for the instant PIX system. It also provides access to over 20,000 time series indicators using specific SGS codes.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** economic-indicators, gdp-data, public-debt, trade-balance, time-series-data, financial-reporting

## Description

This MCP gives your AI client real-time access to critical data points that define the Brazilian economy. Instead of manually logging into multiple Central Bank portals and juggling spreadsheets, you instruct your agent to pull complex macroeconomic snapshots in a single query. Your agent pulls everything from GDP growth rates to unemployment figures and PIX transaction volumes. You can compare historical debt sustainability metrics with current international reserve levels—all without leaving your workflow.

The system handles the complexity of retrieving data across various time series indicators, including trade balance movements and public sector debt ratios. When you connect BCB Economia through Vinkius, your agent knows exactly where to find these specific datasets. It lets you model economic scenarios or generate reports that require combining metrics like IBC-Br proxies with PNAD unemployment rates instantly.

## Tools

### get_pib
Calculates the monthly percentage variation of Brazil's economic activity using the IBC-Br index proxy.

### get_divida_pib
Determines the ratio of the liquid public sector debt relative to the Gross Domestic Product (GDP).

### get_reservas
Pulls the current international reserve total for Brazil, expressed in U.S. Dollars.

### get_balanca_comercial
Retrieves the net balance of Brazilian trade (exports minus imports) over a specified period.

### get_desemprego
Fetches the unemployment rate for Brazil, based on PNAD survey data.

### get_pix_estatisticas
Gets detailed volume and count statistics regarding PIX instant payment transactions in Brazil.

### get_serie_bcb
Queries any specific time series data published by the BCB using its unique SGS code identifier.

## Prompt Examples

**Prompt:** 
```
Give me a summary of Brazil’s economy over the last 5 years, focusing on GDP, debt trends, and reserves.
```

**Response:** 
```
**🇧🇷 Brazilian Economic Snapshot (Last 5 Years)**

| Metric | Trend/Value |
| :--- | :--- |
| **GDP Growth Proxy** | Volatile; Average annual growth was +1.2% |
| **Debt to GDP Ratio** | Decreased from 78% to 63% |
| **International Reserves** | Stable, averaging $350B USD per year |

*Data sourced from multiple BCB endpoints.*
```

**Prompt:** 
```
What were the trade balance and unemployment rates for Q4 of last year?
```

**Response:** 
```
**📊 Quarterly Economic Data (Q4)**

*   **Trade Balance:** The net surplus reached $8.1 billion, driven primarily by agricultural exports.
*   **Unemployment Rate:** The PNAD rate stabilized at 7.5%, showing a slight improvement from the previous quarter.

This comparison shows external trade strength supporting labor market stability.
```

**Prompt:** 
```
Compare the PIX transaction volume against the general inflation rate (IPCA) over 18 months.
```

**Response:** 
```
**📈 BCB Data Comparison: PIX vs. Inflation**

| Period | PIX Volume (Billions) |
| :--- | :--- |
| Q3 2023 | 4.5 B |
| Q4 2023 | 5.1 B |
| Q1 2024 | 6.2 B |

*Observation:* PIX volume continues to rise steadily, outpacing the inflation rate (IPCA), suggesting strong consumer demand and adoption of digital payments.
```

## Capabilities

### Calculate Public Debt Ratios
Retrieve the liquid public sector debt as a percentage of the GDP to assess fiscal sustainability.

### Track International Reserves
Get the current total value of Brazil's international reserves, measured in USD.

### Assess Economic Output Change
Obtain monthly estimates for the Brazilian GDP using the IBC-Br index proxy.

### Monitor Payment System Volume
Pull up detailed statistics on PIX, including both the volume and count of instant transactions.

### Retrieve Any Time Series Data
Query over 20,000 historical data points from the BCB using specific SGS codes (e.g., Selic rate or IPCA).

## Use Cases

### Comparing current debt stability with historical trends
A risk manager needs to know if Brazil's public sector can handle new borrowing. They ask their agent for the latest `get_divida_pib` ratio and compare it against data pulled from `get_serie_bcb` (for historical interest rate context).

### Creating a quarterly economic snapshot report
An economist must compile a full report. They prompt the agent to gather GDP (`get_pib`), unemployment (`get_desemprego`), and PIX payment volumes (`get_pix_estatisticas`) all in one go.

### Assessing commodity market health
An investment strategist wants to see if the trade balance is improving. They use `get_balanca_comercial` and then check international reserves using `get_reservas` to gauge external funding capacity.

### Quickly checking specific financial metrics
A junior analyst needs the current Selic rate. Instead of searching, they ask for the SGS code 24369 (unemployment) and the relevant time series data using `get_serie_bcb`.

## Benefits

- Get instant, reliable data on key metrics like GDP using the `get_pib` tool, eliminating manual proxy calculations.
- Assess fiscal risk immediately by running `get_divida_pib`, providing the public sector's net debt ratio relative to GDP.
- Track national financial stability by checking current international reserves with `get_reservas` in USD terms.
- Model market liquidity and growth using `get_pix_estatisticas`, seeing recent trends in instant payment volumes.
- Compare trade performance over time by calling `get_balanca_comercial` to track export/import surpluses.
- Access niche data points, like specific interest rates or inflation indices, through the flexible `get_serie_bcb` tool.

## How It Works

The bottom line is that your agent handles all the technical steps of connecting to and interpreting raw Central Bank time series data so you get clean, usable economic metrics.

1. Tell your agent precisely what economic metrics you need; for example, 'What was Brazil's debt/GDP ratio last quarter?'
2. Your agent identifies the necessary data endpoint and executes the query against the BCB data structure.
3. The client receives structured data containing the requested historical or current figures (e.g., GDP percentages, USD reserve amounts) ready for analysis.

## Frequently Asked Questions

**How can I use BCB Economia to check Brazil's public debt sustainability?**
You can assess fiscal health by using the `get_divida_pib` tool. This provides the current ratio of liquid public sector debt relative to GDP, which is key for determining if the country's debt load is sustainable over time.

**I need historical data on Brazil's economy; does BCB Economia support it?**
Yes. The MCP gives you access to specific series through `get_serie_bcb`. You just need the SGS code (like 432 for Selic) and can pull decades of reliable time series data instantly.

**What is the best way to compare GDP growth with job market indicators using BCB Economia?**
You should retrieve both the monthly proxy from `get_pib` for economic activity and the quarterly rate from `get_desemprego`. Comparing these two endpoints helps you see if overall output growth is supporting stable employment.

**Can BCB Economia help me track payment system usage in Brazil?**
Absolutely. Use `get_pix_estatisticas` to get the latest volume and count figures for PIX. This tells you exactly how much the instant payment network is being used by consumers and businesses.

**How do I find out if Brazil's foreign reserves are increasing or decreasing?**
Use `get_reservas` to pull the most recent international reserve total in USD. Tracking this metric shows whether the country is accumulating or depleting its external financial assets.

**Is BCB Economia good for analyzing trade performance?**
Yes, it provides `get_balanca_comercial`. This tool calculates the full balance (exports minus imports), giving you a clear picture of whether Brazil's primary trade sector is running a surplus or deficit.