ibge_geocodigo
Decodes IBGE geographic codes and searches codes by locality name. Provides region, state, municipality, or district code breakdown.
Instructions
Decodes IBGE codes or searches codes by locality name.
Features:
Decode region, state, municipality, or district codes
Search IBGE code by name
Show complete geographic hierarchy
Return related codes
Code structure:
1 digit: Region (1=North, 2=Northeast, 3=Southeast, 4=South, 5=Central-West)
2 digits: State (11-53)
7 digits: Municipality
9 digits: District
Examples:
Decode municipality: codigo="3550308"
Decode state: codigo="35"
Search by name: nome="São Paulo"
Municipality in state: nome="Campinas", uf="SP"
This tool decodes a code's structure and resolves name→code at any level. Use a different tool when:
You only need to list/search municipalities → ibge_municipios
You want the full detailed record of one locality → ibge_localidade
Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns Markdown.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codigo | No | Código IBGE para decodificar. Formatos aceitos: - 1 dígito: Região (1-5) - 2 dígitos: UF (11-53) - 7 dígitos: Município - 9 dígitos: Distrito | |
| nome | No | Nome da localidade para encontrar o código IBGE (estado ou município) | |
| uf | No | Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) para restringir a busca por nome de município |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tipo | Yes | Tipo do resultado: localidade decodificada (regiao/uf/municipio/distrito) ou lista de municípios encontrados (lista) | |
| codigo | No | Código IBGE da localidade resolvida (ausente em resultados do tipo lista) | |
| nome | No | Nome da localidade resolvida | |
| sigla | No | Sigla da região ou UF, quando aplicável | |
| regiao | No | Nome da região à qual a UF pertence (apenas tipo uf) | |
| regiaoCodigo | No | Código IBGE da região à qual a UF pertence (apenas tipo uf) | |
| hierarquia | No | Hierarquia geográfica completa, da região ao município/distrito (tipo municipio/distrito) | |
| codigoSidra | No | Código SIDRA de 6 dígitos do município (apenas tipo municipio) | |
| estados | No | Estados pertencentes à região (apenas tipo regiao) | |
| matches | No | Municípios encontrados na busca por nome (apenas tipo lista) | |
| total | No | Quantidade de municípios encontrados na busca por nome (apenas tipo lista) |