Municípios vizinhos
ibge_vizinhosFind nearby Brazilian municipalities by IBGE code or name using shared mesoregion as a proximity proxy, with optional population data.
Instructions
Finds nearby/neighboring municipalities.
Features:
Search by IBGE code (7 digits) or municipality name
Returns municipalities in the same mesoregion (proximity approximation)
Optionally includes population data
Note: Uses mesoregion as geographic proximity proxy. For exact spatial neighborhood, mesh processing would be required.
Examples:
By code: municipio="3550308"
By name: municipio="Campinas", uf="SP"
With population: municipio="3550308", incluir_dados=true
Note: proximity is approximated by shared mesoregion (not exact spatial adjacency). For listing/searching municipalities, use ibge_municipios.
Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown list.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"municipio": "<municipio>"
},
"name": "ibge_vizinhos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uf | No | Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) — obrigatório se usar nome do município | |
| raio | No | Raio em km para buscar municípios próximos (usa centróides) | |
| municipio | Yes | Código IBGE do município (7 dígitos) ou nome do município | |
| incluir_dados | No | Incluir dados populacionais dos vizinhos |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Quantidade de municípios próximos encontrados | |
| vizinhos | Yes | Lista de municípios próximos (mesma mesorregião) | |
| municipio | Yes | Município de referência da consulta | |
| provenance | Yes | Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença | |
| attribution | Yes | URLs canônicas das fontes desta resposta (lista de atribuição) |