mcp-ibge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_IBGE_TIMEOUT | No | Timeout (seconds) for each HTTP request to IBGE APIs. | 15 |
| MCP_IBGE_CACHE_TTL | No | Cache entry time-to-live in seconds. | 3600 |
| MCP_IBGE_LOG_LEVEL | No | Log level (DEBUG, INFO, WARNING, etc.). | INFO |
| MCP_IBGE_TRANSPORT | No | MCP transport (stdio or streamable-http). | stdio |
| MCP_IBGE_CACHE_ENABLED | No | Enable/disable in-memory cache. | true |
| MCP_IBGE_CACHE_MAX_SIZE | No | Maximum number of cached responses. | 256 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_regioesA | Lista as 5 grandes regiões geográficas do Brasil (Norte, Nordeste, Sudeste, Sul, CO). |
| listar_estadosC | Lista os 26 estados e o Distrito Federal, com sigla, nome e região. |
| obter_estadoA | Obtém os detalhes de um estado (UF) brasileiro. |
| listar_municipiosA | Lista municípios brasileiros, opcionalmente filtrados por estado. Sem o parâmetro |
| obter_municipioA | Obtém os detalhes completos de um município pelo código IBGE. |
| buscar_municipios_por_nomeA | Busca municípios cujo nome contenha o termo informado. A busca ignora maiúsculas/minúsculas e acentos (ex.: "sao jose" encontra "São José dos Campos"). Útil para descobrir o código IBGE de um município a partir do nome. |
| listar_agregadosA | Lista os agregados (tabelas estatísticas) disponíveis no SIDRA. Use esta tool para descobrir o ID de um agregado antes de chamar
|
| obter_metadados_agregadoA | Obtém os metadados de um agregado do SIDRA: variáveis, períodos e níveis territoriais. Use o resultado para escolher os parâmetros de |
| consultar_dados_agregadoA | Consulta valores de um agregado do SIDRA para variáveis, períodos e localidades específicos. Para descobrir IDs válidos de variáveis, períodos e níveis territoriais,
chame |
| obter_populacao_municipioA | Obtém a população residente estimada mais recente de um município. Baseado no agregado 6579 (Estimativas de população) do SIDRA. |
| obter_projecao_populacaoB | Obtém a projeção populacional do IBGE para o Brasil ou uma unidade federativa. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool has a distinct purpose: searching, listing, or obtaining details for different entities (municipios, estados, regioes, agregados). Even similar population tools (obter_populacao_municipio vs obter_projecao_populacao) differ in scope. No ambiguity.
All tools follow a consistent verb_noun pattern in snake_case using Portuguese verbs (buscar, consultar, listar, obter). The naming style is uniform and predictable.
11 tools is well-scoped for an IBGE data server. It covers geographic entities and SIDRA aggregates without being excessive or insufficient.
The tool surface covers essential CRUD-like operations for geographic data and statistical aggregates. Minor gaps exist (e.g., no direct tool for fetching multiple municipalities by code), but main workflows are supported.