API de municípios e estados do IBGE
Receba os 27 estados ou todos os municípios de uma UF com o código oficial do IBGE e a microrregião, para preencher formulários, validar endereços e cruzar dados. Consulta gratuita, pela API ou pelo seu agente de IA.
Exemplo real
Consulta feita em 08/10/2026 pela API de localidades do IBGE, respondida em 794 ms. Lista encurtada; o Acre tem 22 municípios.
curl -X POST https://superpowers.tools/v1/run \
-H 'Authorization: Bearer $SUPERPOWERS_KEY' \
-H 'content-type: application/json' \
-d '{"tool":"ibge.localities","idempotency_key":"example-1","input":{"uf":"AC"}}'{
"uf": "AC",
"count": 22,
"items": [
{
"ibge_code": "1200013",
"name": "Acrelândia",
"microregion": "Rio Branco"
},
{
"ibge_code": "1200054",
"name": "Assis Brasil",
"microregion": "Brasiléia"
},
{
"ibge_code": "1200104",
"name": "Brasiléia",
"microregion": "Brasiléia"
},
"…"
]
}Fontes
Mesma entrada e mesma saída em todas. Taxa de sucesso dos últimos 30 dias aparece a partir de 5 consultas reais.
| Fonte | Preço por consulta | Situação |
|---|---|---|
| IBGE | Grátis | Disponível |
Campos retornados
uf | Estado consultado |
count | Quantidade de municípios |
items[].ibge_code | Código IBGE do município (7 dígitos) |
items[].name | Nome do município |
items[].microregion | Microrregião |
Use no seu agente de IA
Adicione o servidor MCP no Claude, Cursor ou outro cliente e peça em linguagem natural.
{
"mcpServers": {
"superpowers": {
"url": "https://superpowers.tools/mcp",
"headers": {
"Authorization": "Bearer sp_live_…"
}
}
}
}Perguntas frequentes
Como listar os estados?
Chame sem o parâmetro uf. A resposta traz os 27 estados com sigla, nome, código IBGE e região.
A consulta é paga?
Não. A consulta de localidades do IBGE é gratuita. A conta só é necessária para ter uma chave de API, e o crédito inicial de US$5 serve para as outras ferramentas.
Para que serve o código IBGE do município?
É o identificador oficial usado em notas fiscais eletrônicas, em cadastros públicos e nas bases do IBGE. Guardar o código evita erros com nomes repetidos ou grafados de formas diferentes.
Os dados são atualizados?
Vêm da API de localidades do IBGE no momento da consulta, então mudanças oficiais aparecem assim que o IBGE publica.
Dá para usar com Claude, ChatGPT ou Cursor?
Sim. Com o servidor MCP da Superpowers configurado, o agente consulta municípios e códigos IBGE sozinho, por exemplo ao montar uma planilha por cidade.
Comece com US$5 de crédito
Esta consulta é gratuita; o crédito serve para as outras ferramentas. Sem cartão para começar.