# IBGE Full Access — Dados Brasileiros MCP

> IBGE Full Access — Dados Brasileiros provides one unified connection to Brazil's official statistics. You can query census data, economic classifications (CNAE), name popularity trends since the 1930s, and deep demographics for any municipality or state. It pulls together information from multiple domains—from GDP figures to quality-of-life metrics—in a single API call.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** census-data, demographics, public-statistics, brazil-geography, data-intelligence, survey-indicators

## Description

This MCP gives you direct access to Brazil's vast official data sets, meaning you don't have to stitch together five different sources just to paint a picture of a region. Instead of dealing with fragmented APIs for census counts, economic sectors, and local demographics, your agent can treat it like one single, massive database. You get everything from listing the 27 states and finding specific city details down to querying complex aggregate tables using SIDRA.

Want to know what people were named in a certain decade? Need to map out which economic activity classifications are most common in São Paulo's suburbs? Or maybe you just need to compare Brazil’s GDP per capita with Australia’s?

It handles it. You connect this MCP through Vinkius, and your preferred AI client routes the complex queries, giving you a complete intelligence layer for any Brazilian market research project. It lets you build reports that cross demographics, history, and modern economic indicators without breaking a sweat on API management.

## Tools

### list_estados
Retrieves a complete list of all 27 Brazilian states by their names and codes.

### get_nome_frequencia
Calculates the frequency of a specific name for any given decade in Brazil's history.

### get_ranking_nomes
Provides rankings of the most popular Brazilian names, allowing filtering by sex or decade.

### list_secoes_cnae
Lists all 21 high-level economic sections (CNAE) used to classify business activities in Brazil.

### get_subclasse_cnae
Retrieves detailed information for specific, lower-level CNAE subclasses.

### get_noticias_ibge
Pulls the latest press releases and news updates directly from the official IBGE news agency.

### get_pais_indicadores
Retrieves comparative socioeconomic indicators for any country using its standardized M49 code.

### get_municipios_por_uf
Lists all municipalities located within a specified Brazilian state (UF).

### get_municipio
Fetches comprehensive details about a specific municipality using its official IBGE code.

### list_regioes
Provides the names and definitions of Brazil's five macro-regions.

### list_agregados
Lists all available aggregate tables within the SIDRA statistical system.

### get_agregado_data
Extracts raw data points from a specific SIDRA aggregate table, allowing filtering by geographic level (N1=Brazil, N3=State, N6=Municipality).

### get_agregado_metadados
Retrieves the descriptive metadata for any given SIDRA aggregate table.

### list_pesquisas
Lists all available major survey types conducted by IBGE (e.g., health, education).

### get_resultados_pesquisa
Gets specific results from an IBGE survey for a given municipality.

## Prompt Examples

**Prompt:** 
```
Complete profile of the city of Florianópolis — geography, economy, and demographics
```

**Response:** 
```
🏝️ **Florianópolis — Full Profile**

📍 IBGE: 4205407 | UF: SC | Region: Sul
👥 Population: 537,213 (2022)
💰 GDP: R$ 24.8B | Per capita: R$ 46,200
📚 Literacy: 98.4% | Schooling: 11.2 yrs
🏥 Life expectancy: 78.4 years
🏘️ Metropolitan region: 22 municipalities

Florianópolis is consistently ranked among Brazil's top 5 cities in quality of life.
```

**Prompt:** 
```
What is the most popular baby name in Brazil right now and what is its CNAE equivalent for a naming consultancy?
```

**Response:** 
```
👶 **Most Popular Name (2010s)**

Miguel (M) and Helena (F) lead the 2010s decade.

💼 **Naming Consultancy CNAE**
- 7020-4/00 — Management consulting
- 9329-8/99 — Other recreational activities

Cross-domain query executed: Names API + CNAE API in one shot!
```

**Prompt:** 
```
Latest IBGE news and how Brazil compares to Argentina in population
```

**Response:** 
```
📰 **Latest IBGE News**

1. 'Censo 2022 revela envelhecimento acelerado da população'
2. 'PIB cresce 2.9% em 2024, supera expectativas'
3. 'IPCA de março: 0.43%, acumulado 4.62%'

🌍 **Brazil vs Argentina — Population**
- Brazil: 214.3M | Argentina: 46.2M
- Brazil is 4.6× larger in population
- Brazil density: 25/km² | Argentina: 17/km²
```

## Capabilities

### Generate full city profiles
Build detailed municipal profiles by combining population metrics, health data, education levels, and GDP figures.

### Analyze historical name trends
Track the most popular names in Brazil over decades to understand cultural or demographic shifts.

### Map economic activity sectors
List and query the 1,332 CNAE codes to categorize industries within specific states or municipalities.

### Compare global indicators
Retrieve socioeconomic metrics for Brazil and compare them directly against any other country using its M49 code.

### Deep dive into census data
Access SIDRA tables to pull aggregate data on population, employment, or inflation at multiple geographic levels (macro-region down to municipality).

## Use Cases

### Assessing investment potential in a new state.
An analyst wants to know if Paraná is ready for a tech hub. They prompt the agent: 'Give me the economic profile and demographic trends.' The MCP uses `get_municipios_por_uf` to list all towns, then runs `list_secoes_cnae` on them, finally cross-referencing with population data from SIDRA aggregate tables (`get_agregado_data`) for a holistic view.

### Writing a report on social change in the Northeast.
A researcher needs to show how education levels have changed. They ask for survey results using `list_pesquisas` and then combine that with regional data by listing macro-regions (`list_regioes`) and fetching specific demographic indicators via SIDRA aggregates.

### Comparing Brazilian quality of life to global standards.
A policy advisor needs a quick comparison. They use `get_pais_indicadores` with Brazil's M49 code, allowing them to instantly compare its literacy rate and average income against multiple other nations in one query.

### Building a business plan around naming trends.
A consultant needs market data for a naming agency. They use `get_ranking_nomes` to find the top 5 names for a given decade, and then cross-reference that with CNAE codes (`list_secoes_cnae`) to suggest related business services.

## Benefits

- Avoids data silos. Instead of running separate queries for city geography (`get_municipio`) and economic activity (`list_secoes_cnae`), you get them merged instantly.
- Global comparison built-in. Need to benchmark São Paulo? Use `get_pais_indicadores` to compare its GDP metrics against any country in the world, eliminating manual data entry.
- Unmatched depth on names. Tracking name popularity over decades using `get_nome_frequencia` gives insight into cultural and social shifts that simple census numbers miss.
- Cross-domain reporting. Combine population totals from a survey (`list_pesquisas`) with the economic structure of a region via CNAE to build deep market reports.
- High granularity on data sets. You can pinpoint statistics at the municipality level using `get_agregado_data` or get specific localized results using `get_resultados_pesquisa`.

## How It Works

The bottom line is you send one natural language prompt and get complex, multi-source Brazilian statistics returned in one go.

1. Specify the required Brazilian dataset, such as a target state, a specific economic activity code, or a desired time period.
2. Your agent executes multiple targeted calls across different data layers—for example, combining `list_estados` with `get_agregado_data` and then adding name trends using `get_ranking_nomes`.
3. The MCP returns a single, consolidated data payload that includes all the requested metrics and classifications, ready for analysis.

## Frequently Asked Questions

**How do I get economic data using IBGE Full Access — Dados Brasileiros?**
You use the CNAE tools. First, run `list_secoes_cnae` to see all major categories, then use `get_subclasse_cnae` for specific details on the industry you're interested in.

**Can I compare Brazil's demographics with other countries using this MCP?**
Yes. Use the `get_pais_indicadores` tool and provide the M49 country code for any nation to run a direct socioeconomic comparison against Brazil.

**What data sources are available for city demographics in IBGE Full Access — Dados Brasileiros?**
You can access various sources. Use `get_municipio` for core details, and then use the survey tools like `list_pesquisas` and `get_resultados_pesquisa` to get specialized data.

**How do I find out about name popularity in Brazil?**
Use `get_ranking_nomes`. You can filter the results by decade or sex to see how popular a name was during specific time periods, giving you historical insight into demographics.

**Which tool should I use for aggregate census data across states?**
You need `get_agregado_data`. This tool allows you to query complex SIDRA tables and specify the exact geographic level, like a state (N3=UF), ensuring your metrics are correctly scoped.