# IBGE Localidades — Cidades do Brasil MCP for AI Agents AI Agent Connect

> IBGE Localidades — Cidades do Brasil MCP provides your agent with a precise map of Brazil. It covers all 5,570 municipalities, 27 states, 5 macro-regions, and metropolitan areas. You get the complete administrative hierarchy with official IBGE codes and zero authentication required.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/ai-agent-connect
- **Tags:** municipalities, geospatial-data, administrative-hierarchy, brazil-geography, location-services

## Description

This Connector connects your agent to the official IBGE geographic database to get accurate data on every corner of Brazil. This is the same source government agencies and logistics companies rely on for their daily operations. Instead of your agent guessing where a city is or hallucinating a zip code, it can pull the actual 7-digit IBGE code, state abbreviations, and macro-region details. If you're building a CRM, a shipping tool, or a market analysis platform, you can have your agent look up specific municipality details or list all cities in a state like São Paulo. It handles the nested structure of the entire federation, including metropolitan areas for major hubs like Rio de Janeiro and Belo Horizonte. Because it's open government data, there's no need for API keys or complex authentication. You just plug it into your workflow via Vinkius and let your agent handle the geographic heavy lifting. This means you can build features like automated address verification or regional market segmentation without worrying about data integrity. Your agent will always provide the same official hierarchy, whether it's identifying a mesoregion or confirming a state abbreviation. This tool removes the need for manual data entry and ensures your agent stays grounded in the real-world geography of Brazil.

## Tools

### get_municipio
Returns specific details for a city using its unique 7-digit IBGE code. It includes the mesoregion and macro-region info.

### list_estados
Lists all 27 Brazilian states (UFs) for your agent to reference. It provides the official abbreviations used by the government.

### get_municipios_por_uf
Pulls a full list of cities in a state when you provide a 2-letter abbreviation. This is useful for populating dropdowns or regional lists.

### list_regioes
Shows the 5 macro-regions of Brazil including their nested structures. Use this to group data by large geographic areas.

### list_regioes_metropolitanas
Identifies metropolitan areas across different Brazilian states. It helps map out major urban hubs and their surrounding areas.

## Prompt Examples

**Prompt:** 
```
What are the metropolitan regions in the state of Minas Gerais?
```

**Response:** 
```
🏙️ **Minas Gerais — Metropolitan Regions**

1. RM de Belo Horizonte (34 municipalities, pop ~5.8M)
2. RM do Vale do Aço (28 municipalities)
3. Colar Metropolitano (16 municipalities)

The Belo Horizonte metro area is Brazil's third largest, after São Paulo and Rio de Janeiro.
```

**Prompt:** 
```
What is the IBGE code for the city of Rio de Janeiro?
```

**Response:** 
```
📍 **Rio de Janeiro**

- IBGE Code: 3304557
- Microregion: Rio de Janeiro
- Mesoregion: Metropolitana do Rio de Janeiro
- State: RJ (33)
- Macro-region: Sudeste
```

**Prompt:** 
```
List all municipalities in the state of São Paulo
```

**Response:** 
```
🇧🇷 **São Paulo — 645 Municipalities**

1. Adamantina (3500105)
2. Adolfo (3500204)
3. Aguaí (3500303)
...
645. Votorantim (3557006)

São Paulo is Brazil's largest state by municipality count, representing 11.6% of all Brazilian cities.
```

## Capabilities

### List every Brazilian state
Your agent can pull the full list of all 27 Brazilian states including their official abbreviations.

### Find all cities in a state
Provide a 2-letter state code to get every municipality within that specific state.

### Get specific city details
Retrieve 7-digit IBGE codes and regional hierarchies for any specific municipality.

### Browse macro-regions
Access the 5 major macro-regions of Brazil and their nested administrative structures.

### Identify metropolitan areas
Get details on metropolitan regions for major hubs like São Paulo and Rio de Janeiro.

## Use Cases

### Listing all cities in a specific state
A user wants to know every city in Minas Gerais. The agent uses get_municipios_por_uf with 'MG' to return a complete list of every municipality in the state.

### Verifying a city's regional hierarchy
A developer needs to verify a city's region. The agent uses get_municipio with a 7-digit code to find the specific mesoregion and macro-region.

### Identifying major urban hubs
A logistics planner wants to see metro areas. The agent uses list_regioes_metropolitanas to identify major urban hubs like Belo Horizonte or Rio de Janeiro.

### Grouping data by macro-regions
A researcher needs to group cities. The agent uses list_regioes to organize data into the 5 official Brazilian macro-regions.

## Benefits

- Get official IBGE codes for every city to ensure your data matches government standards using get_municipio.
- Eliminate hallucinations by giving your agent a hard database of 5,570 municipalities.
- Save development time because you don't have to manage API keys or auth for this data.
- Quickly pull lists of cities for specific states using simple 2-letter abbreviations with get_municipios_por_uf.
- Map out metropolitan areas and macro-regions for better regional analysis using list_regioes_metropolitanas.
- Build reliable address validation tools using the same data as major Brazilian fintechs.

## How It Works

The bottom line is you get instant, official Brazilian geographic data without the headache of managing API keys.

1. Subscribe to the IBGE Localidades — Cidades do Brasil MCP on the Vinkius Marketplace.
2. Connect your preferred AI client to the Connector without needing any API keys or credentials.
3. Ask your agent to find, list, or describe any city, state, or region in Brazil.

## Frequently Asked Questions

**Does the IBGE Localidades — Cidades do Brasil MCP require an API key?**
No, it uses open government data from the IBGE, so you can connect it to your AI client instantly without managing keys.

**Can I use IBGE Localidades — Cidades do Brasil MCP for logistics?**
Yes, it provides the official IBGE codes used by shipping and logistics companies to ensure accurate regional mapping.

**Does IBGE Localidades — Cidades do Brasil MCP include all Brazilian states?**
Yes, it covers all 27 states, their municipalities, and the 5 major macro-regions of Brazil.

**How does IBGE Localidades — Cidades do Brasil MCP handle metropolitan areas?**
It lists metropolitan regions by state, allowing your agent to identify major urban hubs like Rio de Janeiro and Belo Horizonte.

**Is the data in IBGE Localidades — Cidades do Brasil MCP up to date?**
It pulls from the official IBGE geographic database, which is the standard authoritative source for all Brazilian geography.

**Can my AI agent use IBGE Localidades — Cidades do Brasil MCP for address validation?**
Yes, it provides the administrative hierarchy needed to verify city, state, and region data against official records.

**Do I need an API key?**
No! IBGE data is 100% open government data. This server works instantly with zero configuration — just subscribe and start querying Brazilian geography.