# IBGE Agregados (SIDRA) MCP for AI Agents AI Agent Connect

> IBGE Agregados (SIDRA) MCP connects your AI client to Brazil's official statistical database. Query demographic, economic, and census data directly without navigating complex web portals or manually scraping tables. It gives your agent the ability to fetch precise variables, geographic levels, and historical periods for official Brazilian statistics.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_gztrRO9h9OaBHl3vpII3qZud4Kr06xUkVSzGTi0K/ai-agent-connect
- **Tags:** brazil, demographics, statistics, census, economic-indicators, data-query

## Description

This Connector connects your AI client to the IBGE SIDRA database, which serves as the primary source for official Brazilian statistics. Instead of hunting through confusing web menus or manually downloading CSVs from a government portal, you can just ask your agent to find specific data points. It handles the heavy lifting of navigating Brazil's demographic and economic datasets, making it easy to pull information on everything from regional GDP to municipal census figures. You'll find that it works well within the Vinkius catalog, giving you a direct connection to verified government data. It's built for people who need accuracy and want to skip the manual data-gathering phase of their research. Your agent can identify which surveys are available, check the specific variables included in a dataset, and determine what geographic regions are covered before you even start your analysis. This means you can move from a general question about Brazilian demographics to a specific data set in a single conversation. It removes the friction of navigating a public data portal and puts official statistics into your chat interface. You can quickly verify the methodology behind a particular survey or see the exact time periods a dataset covers, ensuring that your analysis is based on the most relevant and up-to-date information available from the IBGE.

## Tools

### get_localidades
Use get_localidades to find out which geographic regions like states or cities are included in a report. You can confirm if the data covers the specific areas you need to study.

### get_metadados
Use get_metadados to fetch the full context and methodology for a specific data aggregate. This ensures you understand the background of the numbers you are analyzing.

### get_periodos
Use get_periodos to check which years or months are covered by a particular dataset. It helps you verify if the survey has enough historical depth for your project.

### get_variaveis
Use get_variaveis to see every specific data point available within a chosen survey. This allows you to confirm exactly what information is included before you start your work.

### list_agregados
Use list_agregados to search and filter through the various official IBGE surveys and tables. It helps you find the correct data source for your research topic without manual browsing.

## Prompt Examples

**Prompt:** 
```
Find me all surveys about Brazil's GDP.
```

**Response:** 
```
I've found several aggregates related to GDP. For example, **Aggregate 5932** (PIB a preços correntes) and **Aggregate 1612** (Contas Regionais). Which one would you like to explore?
```

**Prompt:** 
```
What variables are in aggregate 1737?
```

**Response:** 
```
For aggregate 1737, the available variables include:

* **Número de empresas e outras organizações** (ID: 628)
* **Pessoal ocupado total** (ID: 629)
* **Salários e outras remunerações** (ID: 630)
```

**Prompt:** 
```
Does aggregate 5932 have city-level data?
```

**Response:** 
```
Aggregate 5932 supports the following geographic levels:

* **Brasil** (N1)
* **Grande Região** (N2)
* **Unidade da Federação** (N3)
* **Município** (N6)
```

## Capabilities

### Filter and find official Brazilian surveys
Search through the vast library of IBGE datasets to find the exact survey you need.

### Retrieve detailed metadata for specific data tables
Get the methodology and context for any given aggregate to ensure your analysis is accurate.

### Identify all available variables within a dataset
See every specific data point included in a survey before you start your query.

### Check time periods for historical data series
Find out the exact start and end dates for any given dataset to build your timeline.

### Discover available geographic levels for specific reports
Verify if a dataset includes national, state, city, or other regional data points.

## Use Cases

### Finding GDP data
A researcher asks for 'PIB' data and the agent finds the specific aggregate ID using list_agregados.

### Checking census variables
A developer needs to see if 'number of companies' is in a specific table and uses get_variaveis to confirm.

### Geographic filtering
An analyst wants to know if a dataset covers specific municipalities and checks the levels with get_localidades.

### Metadata verification
A student wants to know the official methodology for a social survey and retrieves it using get_metadados.

## Benefits

- Skip the manual search on the SIDRA portal by finding surveys instantly with list_agregados.
- Get precise data points by checking available fields with get_variaveis before you run a query.
- Ensure your data is geographically accurate by checking regions with get_localidades.
- Understand the methodology behind the numbers using get_metadados to keep your research valid.
- Build accurate historical series by identifying all available dates with get_periodos.

## How It Works

The bottom line is that it turns a complex government database into a direct chat interface for Brazilian statistics.

1. Subscribe to the Connector through the Vinkius marketplace.
2. Connect your preferred client like Claude or Cursor.
3. Start asking questions about Brazilian demographics or economic stats.

## Frequently Asked Questions

**Can I use IBGE Agregados (SIDRA) to find census data?**
Yes, this Connector provides a direct connection to the IBGE SIDRA database, which is the primary source for official census and demographic data in Brazil.

**Does IBGE Agregados (SIDRA) require an API key?**
No, this Connector connects to a public data service, so you don't need to manage complex API keys to start querying statistics.

**Can I use IBGE Agregados (SIDRA) for economic indicators like GDP?**
Yes, it covers a wide range of economic indicators. You can ask your agent to find specific surveys related to GDP, inflation, or regional accounts.

**How does IBGE Agregados (SIDRA) handle geographic levels?**
It allows you to check exactly which regions a dataset covers, from national levels down to specific states and municipalities.

**Is IBGE Agregados (SIDRA) good for academic research?**
It is excellent for research because it can retrieve the official methodology and metadata for any survey, ensuring your data is used correctly.

**Can I use IBGE Agregados (SIDRA) to see historical time periods?**
Yes, you can check the available time periods for any survey to see if it has the historical depth needed for your analysis.

**How can I find specific surveys related to a topic like 'Employment'?**
Use the `list_agregados` tool and provide a keyword in the `assunto` parameter. The agent will return a list of all relevant aggregate tables and their IDs.

**Can I see which years or months are available for a specific table ID?**
Yes! By using the `get_periodos` tool with the specific Aggregate ID, you can retrieve all available time intervals for that dataset.

**How do I know if a table has data at the city level (municípios)?**
Run the `get_localidades` tool for the target Aggregate ID. It will list all supported geographic levels, such as 'Brasil', 'Unidade da Federação', or 'Município'.