ibge_localidade
Retrieve detailed information about a Brazilian state, municipality, or district using its IBGE code. Includes hierarchical location data from region to microregion.
Instructions
Returns details of a specific locality by IBGE code.
Features:
State information (2-digit code)
Municipality information (7-digit code)
District information (9-digit code)
Complete hierarchy (region, mesoregion, microregion)
Examples:
São Paulo state: codigo=35
São Paulo city: codigo=3550308
District: codigo=355030805
This tool returns the full record of ONE locality you already have the code for. Use a different tool when:
You have a name and need the code → ibge_municipios (municipalities) or ibge_geocodigo (any level)
You want to decompose/understand a code's structure → ibge_geocodigo
Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown record.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codigo | Yes | Código IBGE da localidade (estado: 2 dígitos, município: 7 dígitos, distrito: 9 dígitos) | |
| tipo | No | Tipo da localidade. Se não informado, será inferido pelo tamanho do código. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tipo | Yes | Tipo da localidade retornada | |
| id | Yes | Código IBGE da localidade | |
| nome | Yes | Nome da localidade | |
| sigla | No | Sigla da UF (apenas para estados) | |
| regiao | No | Região do estado (apenas para estados) | |
| mesorregiao | No | Mesorregião do município | |
| microrregiao | No | Microrregião do município | |
| regiaoImediata | No | Região imediata do município | |
| regiaoIntermediaria | No | Região intermediária do município | |
| municipio | No | Município ao qual o distrito pertence (apenas para distritos) | |
| estado | No | Estado da localidade (município ou distrito) |