IBGE Brasil MCP
REMOTE · IBGE.SIDNEYBISSOLI.COM · 2 COMPONENTS · SCANNED SEP 20
IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security74
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability74
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 11109 tokens (~396/item across 28 items; 23 tools + 5 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management95
- Stability check failed: schema churn in the 30 days we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 2 additions. See how to fix → Fail
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 23 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the IBGE Brasil MCP server?
IBGE Brasil MCP is a hosted endpoint at https://ibge.sidneybissoli.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · ibge.sidneybissoli.com
claude mcp add --transport http sidneybissoli-ibge-br-mcp 'https://ibge.sidneybissoli.com/mcp'
{
"mcpServers": {
"sidneybissoli-ibge-br-mcp": {
"url": "https://ibge.sidneybissoli.com/mcp"
}
}
} {
"servers": {
"sidneybissoli-ibge-br-mcp": {
"type": "http",
"url": "https://ibge.sidneybissoli.com/mcp"
}
}
} [mcp_servers.sidneybissoli-ibge-br-mcp] url = "https://ibge.sidneybissoli.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"sidneybissoli-ibge-br-mcp": {
"type": "remote",
"url": "https://ibge.sidneybissoli.com/mcp",
"enabled": true
}
}
} openclaw mcp add sidneybissoli-ibge-br-mcp --url 'https://ibge.sidneybissoli.com/mcp' --transport streamable-http
mcp_servers:
sidneybissoli-ibge-br-mcp:
url: "https://ibge.sidneybissoli.com/mcp" {
"McpServers": {
"sidneybissoli-ibge-br-mcp": {
"Transport": "http",
"Url": "https://ibge.sidneybissoli.com/mcp"
}
}
} assistant mcp add sidneybissoli-ibge-br-mcp -t streamable-http -u 'https://ibge.sidneybissoli.com/mcp'
{
"mcpServers": {
"sidneybissoli-ibge-br-mcp": {
"type": "http",
"url": "https://ibge.sidneybissoli.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 17 Sept 26 0
- Server version: 5.1.0 → 5.1.1 functional
- 16 Sept 26 0
- Tool “ibge_sidra” rewrote its description, which is the text the model reads security
- Tool “ibge_sidra_tabelas” rewrote its description, which is the text the model reads security
- Server version: 5.0.1 → 5.1.0 functional
- Server version: 5.0.0 → 5.0.1 functional
- “ibge_sidra_tabelas” reworded the description of “busca” cosmetic
- 11 Sept 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “ibge_malhas_tema” rewrote its description, which is the text the model reads security
- Server version: 4.3.0 → 5.0.0 functional
- “ibge_malhas_tema” added an optional parameter “limite” cosmetic
- “ibge_malhas_tema” reworded the description of “codigo” cosmetic
- “ibge_censo” reworded the description of “agruparPor” cosmetic
- “ibge_datasaude” reworded the description of “agruparPor” cosmetic
- “ibge_indicadores” reworded the description of “agruparPor” cosmetic
- “ibge_malhas” reworded the description of “intrarregiao” cosmetic
- “ibge_malhas” reworded the description of “qualidade” cosmetic
- “ibge_malhas” reworded the description of “resolucao” cosmetic
- “ibge_sidra” reworded the description of “agruparPor” cosmetic
- “ibge_malhas_tema” reworded the description of “tema” cosmetic
- “ibge_malhas_tema” dropped the optional parameter “resolucao” cosmetic
- “ibge_malhas_tema” dropped the optional parameter “qualidade” cosmetic
- “ibge_malhas_tema” dropped the optional parameter “formato” cosmetic
- 8 Sept 26 0
- Tool “fetch” rewrote its description, which is the text the model reads security
- 4 Sept 26 −1
- Stability: pass → fail ▼ security
- 3 Sept 26 +5
- HTTPS: unverified → pass ▲ security
- Stability: fail → pass ▲ security
- Server version: 4.2.0 → 4.3.0 functional
- New tool “fetch” functional
- New tool “search” functional
- 31 Aug 26 0
- Server version: 4.1.0 → 4.2.0 functional
- Server version: 4.0.2 → 4.1.0 functional
- 29 Aug 26 −1
- Stability: pass → fail ▼ security
- Tool “ibge_populacao” was removed ▼ security
- The server rewrote its instructions, which are the text every model session reads security
- Tool “ibge_censo” rewrote its description, which is the text the model reads security
- Tool “ibge_cidades” rewrote its description, which is the text the model reads security
- Server version: 4.0.0 → 4.0.2 functional
- Server version: 3.3.0 → 4.0.0 functional
- “ibge_comparar” reworded the description of “indicador” cosmetic
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Probed https://ibge.sidneybissoli.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=sidneybissoli.com | CN=WE1,O=Google Trust Services,C=US | 17 Aug 2026 | 15 Nov 2026 | ECDSA 256 | ECDSA-SHA256 | d7e32aa6140c36a10e1996cde903e2cd |
| SANs: sidneybissoli.com, ibge.sidneybissoli.com, *.ibge.sidneybissoli.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of ibge.sidneybissoli.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| sidneybissoli.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://ibge.sidneybissoli.com/mcp | Verified | 200 | |
| http (plaintext) | http://ibge.sidneybissoli.com/mcp | HTTPS enforced | 301 | https://ibge.sidneybissoli.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
fetch Documento para Deep Research ~184
Returns the full document for an id obtained from `search`, as { id, title, text, url, metadata }: `text` is the readable content (Markdown) and `url` the canonical public page to cite. Companion of `search` in the OpenAI Deep Research contract, over the IBGE (Brazilian official statistics: SIDRA tables, municipalities, known indicators) catalog. Only ids returned by `search` are valid; an unknown id returns an error. The `ibge_*` tools (`ibge_sidra`, `ibge_cidades`, `ibge_indicadores`, `ibge_comparar`…) remain the tools for data queries. Behavior: read-only and idempotent — a live GET against the public source when the document needs it.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Identificador de um documento devolvido por `search` |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| id | string | yes | Identificador único do documento no servidor; é o que `fetch` recebe |
| metadata | object | – | Pares chave/valor adicionais sobre o documento (tipo, fonte, período…) |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| text | string | yes | Conteúdo integral do documento, legível (Markdown) |
| title | string | yes | Título legível do documento |
| url | string | yes | URL pública canônica do documento — a citação do ChatGPT depende dela |
No examples provided.
ibge_calendario Calendário de divulgações ~326
Queries IBGE release and collection calendar. Features: - List upcoming survey releases - Filter by product (IPCA, PNAD, GDP, etc.) - Filter by period - Distinguish releases from field collections Event types: - **Release**: Publication of survey results - **Collection**: Field research period Examples: - Upcoming releases: (no parameters) - IPCA releases: produto="IPCA" - 2024 calendar: de="01/01/2024", ate="31/12/2024" - Field collections: tipo="coleta" Use a different tool when: - Already-published news and releases → ibge_noticias Behavior: read-only and idempotent — a live GET against the public IBGE Calendário API. Returns a Markdown list.
| Name | Type | Req | Description |
|---|---|---|---|
| ate | string | – | Data final no formato DD/MM/AAAA (ex: '31/12/2024') |
| de | string | – | Data inicial no formato DD/MM/AAAA (ex: '01/01/2024') |
| pagina | number | – | Número da página (padrão: 1) |
| produto | string | – | Filtrar por produto/pesquisa (ex: 'IPCA', 'PNAD', 'PIB') |
| quantidade | number | – | Quantidade de resultados por página (padrão: 20) |
| tipo | string | – | Tipo de evento: 'divulgacao' (publicações), 'coleta' (pesquisas de campo), ou 'todos' |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| eventos | array | yes | Lista de eventos do calendário (divulgações/coletas) |
| pagina | number | – | Página atual retornada |
| produto | string | – | Filtro de produto aplicado, quando informado |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | yes | Total de eventos disponíveis para os critérios |
| totalPaginas | number | – | Total de páginas disponíveis |
No examples provided.
ibge_censo Censo Demográfico ~922
Queries IBGE Demographic Census data (1970-2022). Simplified tool to access census data without knowing SIDRA table codes. Available years: 1970, 1980, 1991, 2000, 2010, 2022 Available themes: - populacao: Resident population - alfabetizacao: Literacy rate - domicilios: Housing characteristics - idade_sexo: Age pyramid - religiao: Religion distribution - cor_raca: Race/color - rendimento: Monthly income - educacao: Education level - trabalho: Employment Examples: - Population 2022: ano="2022", tema="populacao" - Historical series: ano="todos", tema="populacao" - Literacy 2010 by state: ano="2010", tema="alfabetizacao", nivel_territorial="3" - List tables: tema="listar" Statistics mode: for largest/smallest/mean/median/distribution/ranking questions over census data ("which municipality had the largest 2022 population?") use estatisticas=true — full distribution + top/bottom computed over ALL rows before truncation; agruparPor="<column label>" ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - One municipality's current panel (estimate, HDI, GDP) → ibge_cidades - Comparing/ranking localities → ibge_comparar - An arbitrary SIDRA table → ibge_sidra Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| agruparPor | string | – | Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuiç… |
| ano | string | – | Ano do censo (1970, 1980, 1991, 2000, 2010, 2022) ou 'todos' para série histórica |
| campos | string | – | Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. |
| estatisticas | boolean | – | Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'med… |
| formato | string | – | Formato de saída |
| localidades | string | – | Códigos das localidades ou 'all' |
| nivel_territorial | string | – | Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município |
| tema | string | – | Tema dos dados: - populacao: População residente - alfabetizacao: Taxa de alfabetização - domicilios: Características dos domicílios - idade_sexo: Pirâmide etária - religiao: Distribuição por religiã… |
| topN | integer | – | Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100) |
| Name | Type | Req | Description |
|---|---|---|---|
| ano | string | – | Ano(s) de referência |
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| colunas | array | yes | Rótulos das colunas, na ordem |
| descricao | string | – | Descrição da tabela |
| estatisticas | object | – | Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo) |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| registros | array | yes | Registros: cada um mapeia rótulo da coluna -> valor |
| tabela | string | – | Tabela SIDRA de origem |
| tema | string | – | Tema do censo consultado |
| totalRegistros | number | yes | Total de registros de dados |
No examples provided.
ibge_cidades Panorama municipal (Cidades@) ~342
Queries municipal indicators from IBGE (similar to Cidades@ portal). Features: - General overview of a municipality (population, HDI, GDP, etc.) - Query specific indicators - Historical indicator data over years - List available surveys and indicators Available indicators: populacao, area, densidade, pib_per_capita, idh, escolarizacao, mortalidade, salario_medio, receitas, despesas Examples: - São Paulo overview: tipo="panorama", municipio="3550308" - Population history: tipo="historico", municipio="3550308", indicador="populacao" - View surveys: tipo="pesquisas" - Available indicators: tipo="indicador" This tool is the panel for a SINGLE municipality (Cidades@). Use a different tool when: - Census themes / historical series → ibge_censo - Comparing multiple municipalities → ibge_comparar - A macro indicator time series → ibge_indicadores Behavior: read-only and idempotent — a live GET against the public IBGE APIs (Cidades@/agregados). Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| indicador | string | – | ID do indicador ou nome para busca |
| municipio | string | – | Código IBGE do município (7 dígitos) |
| pesquisa | string | – | ID da pesquisa para filtrar indicadores |
| tipo | string | – | Tipo de consulta: panorama (resumo geral), indicador (específico), pesquisas (listar), historico |
| uf | string | – | Código ou sigla da UF para filtrar (ex: 35 ou SP) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| indicadores | array | yes | Indicadores retornados (vazio para respostas de catálogo) |
| municipio | string | – | Código IBGE do município |
| nome | string | – | Nome do município/indicador |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| tipo | string | yes | Tipo de consulta (panorama, indicador, pesquisas, historico) |
No examples provided.
ibge_cnae Classificação CNAE ~364
Queries CNAE (National Classification of Economic Activities) from IBGE. CNAE is the official classification for economic activities in Brazil. Hierarchical structure: - Section (letter A-U): 21 main categories - Division (2 digits): 87 divisions - Group (3 digits): 285 groups - Class (4-5 digits): 673 classes - Subclass (7 digits): 1,332 subclasses Features: - Search by CNAE code - Search by activity description - List by hierarchical level - Show complete hierarchy Examples: - Search software: busca="software" - Specific code: codigo="6201-5/01" - View section: codigo="J" - List divisions: nivel="divisoes" Behavior: read-only and idempotent — a live GET against the public IBGE CNAE API. Returns Markdown.
| Name | Type | Req | Description |
|---|---|---|---|
| busca | string | – | Termo para buscar na descrição das atividades (ex: 'software', 'restaurante', 'comércio') |
| codigo | string | – | Código CNAE para buscar (seção, divisão, grupo, classe ou subclasse). Exemplos: - Seção: "A" (agricultura) - Divisão: "01" (agricultura e pecuária) - Grupo: "01.1" (produção de lavouras) - Classe: "0… |
| limite | number | – | Número máximo de resultados (padrão: 20) |
| nivel | string | – | Nível hierárquico para listar (padrão: mostra todos os níveis relevantes) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | object | – | Presente no modo de busca por termo |
| codigo | object | – | Presente no modo de consulta por código |
| lista | object | – | Presente no modo de listagem por nível |
| modo | string | yes | Modo de resposta que gerou os dados |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
No examples provided.
ibge_comparar Comparação entre localidades ~454
Compares data between localities (municipalities or states). Available indicators: - populacao: Current population estimate - populacao_censo: Census 2022 population - pib: GDP per capita - area: Territorial area (km²) - densidade: Population density (inhab/km²) - alfabetizacao: Literacy rate - domicilios: Number of households Features: - Compare up to 10 localities at once - Calculate statistics (max, min, average, variation) - Generate ranked output - Accept municipality codes (7 digits) or state codes (2 digits) Examples: - Compare capitals: localidades="3550308,3304557,4106902", indicador="populacao" - Compare states: localidades="35,33,41", indicador="pib" - Area ranking: localidades="3550308,3304557", formato="ranking" - List indicators: indicador="listar" Use this tool ONLY to rank/compare 2–10 localities on one indicator. For a single locality, use ibge_cidades (municipal panel), ibge_censo, or ibge_sidra. Behavior: read-only and idempotent — a live GET against the public IBGE APIs (SIDRA and Localidades). Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| formato | string | – | Formato de saída: tabela, json ou ranking (ordenado) |
| indicador | string | – | Indicador para comparação: - populacao: Estimativa populacional atual - populacao_censo: População do Censo 2022 - pib: PIB a preços correntes (Mil Reais) - area: Área territorial (km²) - densidade:… |
| localidades | string | yes | Códigos IBGE das localidades separados por vírgula (ex: "3550308,3304557,4106902"). Use 7 dígitos para municípios, 2 dígitos para UFs. |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| estatisticas | object | – | Estatísticas agregadas (quando há ao menos 2 valores positivos) |
| formato | string | – | Formato solicitado |
| indicador | string | – | Indicador comparado |
| localidades | array | yes | Localidades comparadas, com o valor do indicador |
| nome | string | – | Nome do indicador |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| tabela | string | – | Tabela SIDRA de origem |
No examples provided.
ibge_datasaude Indicadores de saúde ~882
Queries Brazil health indicators, served through IBGE's SIDRA (some originally produced by DataSUS, e.g. mortality and births). Mortality and Birth: - mortalidade_infantil: Infant mortality rate - nascidos_vivos: Live births by location - obitos: Deaths by residence Demographic Indicators: - esperanca_vida: Life expectancy at birth - fecundidade: Fertility rate Sanitation: - saneamento_agua: Water supply - saneamento_esgoto: Sewage system Health Coverage: - plano_saude: Health insurance coverage - autoavaliacao_saude: Self-rated health status Territorial levels: 1=Brazil, 2=Region, 3=State, 6=Municipality Examples: - Infant mortality: indicador="mortalidade_infantil" - Life expectancy by state: indicador="esperanca_vida", nivel_territorial="3" - Deaths in SP: indicador="obitos", nivel_territorial="3", localidade="35" - List indicators: indicador="listar" Statistics mode: for largest/smallest/mean/median/distribution/ranking questions ("which state has the highest infant mortality?", "median life expectancy across states") use estatisticas=true — full distribution + top/bottom over ALL rows before truncation; agruparPor="<column label>" ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - A single municipality's general panel (which also includes infant mortality) → ibge_cidades - Population/demographic counts (not health-specific) → ibge_censo or ibge_sidra Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| agruparPor | string | – | Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuiç… |
| campos | string | – | Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. |
| estatisticas | boolean | – | Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'med… |
| formato | string | – | Formato de saída |
| indicador | string | yes | Indicador de saúde. Disponíveis: - mortalidade_infantil: Taxa de mortalidade infantil - esperanca_vida: Esperança de vida ao nascer - nascidos_vivos: Nascidos vivos - obitos: Óbitos por local de resi… |
| localidade | string | – | Código da localidade ou 'all' |
| nivel_territorial | string | – | Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município |
| periodo | string | – | Período: 'last', 'all', ou ano específico |
| topN | integer | – | Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| colunas | array | yes | Rótulos das colunas, na ordem |
| estatisticas | object | – | Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo) |
| fonte | string | – | Fonte do dado |
| indicador | string | – | Chave do indicador de saúde consultado |
| nome | string | – | Nome do indicador |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| registros | array | yes | Registros: cada um mapeia rótulo da coluna -> valor |
| totalRegistros | number | yes | Total de registros de dados |
No examples provided.
ibge_estados Estados do Brasil ~199
Lists all Brazilian states from IBGE. Features: - Lists all 27 states (26 states + Federal District) - Filter by region (North, Northeast, Southeast, South, Central-West) - Sort by ID, name, or abbreviation Examples: - List all states: (no parameters) - Northeast states: regiao="NE" - Sorted by abbreviation: ordenar="sigla" Use a different tool when: - Municipalities of a state → ibge_municipios - Details/hierarchy of one locality by code → ibge_localidade Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.
| Name | Type | Req | Description |
|---|---|---|---|
| ordenar | string | – | Campo para ordenação dos resultados |
| regiao | string | – | Filtrar por região: N (Norte), NE (Nordeste), SE (Sudeste), S (Sul), CO (Centro-Oeste) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| estados | array | yes | Lista de estados |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | yes | Total de estados retornados |
No examples provided.
ibge_geocodigo Códigos geográficos do IBGE ~359
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.
| Name | Type | Req | Description |
|---|---|---|---|
| codigo | string | – | 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 | string | – | Nome da localidade para encontrar o código IBGE (estado ou município) |
| uf | string | – | Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) para restringir a busca por nome de município |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| codigo | number | – | Código IBGE da localidade resolvida (ausente em resultados do tipo lista) |
| codigoSidra | string | – | Código SIDRA de 6 dígitos do município (apenas tipo municipio) |
| estados | array | – | Estados pertencentes à região (apenas tipo regiao) |
| hierarquia | array | – | Hierarquia geográfica completa, da região ao município/distrito (tipo municipio/distrito) |
| matches | array | – | Municípios encontrados na busca por nome (apenas tipo lista) |
| nome | string | – | Nome da localidade resolvida |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| regiao | string | – | Nome da região à qual a UF pertence (apenas tipo uf) |
| regiaoCodigo | number | – | Código IBGE da região à qual a UF pertence (apenas tipo uf) |
| sigla | string | – | Sigla da região ou UF, quando aplicável |
| tipo | string | yes | Tipo do resultado: localidade decodificada (regiao/uf/municipio/distrito) ou lista de municípios encontrados (lista) |
| total | number | – | Quantidade de municípios encontrados na busca por nome (apenas tipo lista) |
No examples provided.
ibge_indicadores Indicadores econômicos e sociais ~798
Queries IBGE economic and social indicators. Available indicators: **Economic:** - pib: GDP at current prices - pib_variacao: GDP variation (%) - pib_per_capita: GDP per capita - industria: Industrial production - comercio: Retail sales - servicos: Services volume **Prices:** - ipca: Monthly IPCA - ipca_acumulado: 12-month IPCA - inpc: Monthly INPC **Labor:** - desemprego: Unemployment rate - ocupacao: Employed people - rendimento: Average income - informalidade: Informality rate **Population:** - populacao: Population estimate - densidade: Population density Examples: - GDP: indicador="pib" - IPCA last 12 months: indicador="ipca", periodos="last 12" - Unemployment by state: indicador="desemprego", nivel_territorial="3" - List indicators: indicador="listar" Statistics mode: for largest/smallest/mean/median/distribution/ranking questions ("which state has the highest unemployment?", "median GDP per capita across states") use estatisticas=true — full distribution + top/bottom over ALL rows before truncation; agruparPor="<column label>" (e.g. "Unidade da Federação", "Trimestre") ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - Comparing/ranking localities → ibge_comparar - Census themes → ibge_censo - One municipality's panel → ibge_cidades Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| agruparPor | string | – | Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuiç… |
| campos | string | – | Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. |
| categoria | string | – | Filtrar por categoria de indicadores |
| estatisticas | boolean | – | Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'med… |
| formato | string | – | Formato de saída |
| indicador | string | – | Nome do indicador (ex: "pib", "ipca", "desemprego", "populacao"). Use "listar" para ver todos os indicadores disponíveis. |
| localidades | string | – | Códigos das localidades ou 'all' |
| nivel_territorial | string | – | Nível territorial (código N): 1=Brasil, 2=Região, 3=UF |
| periodos | string | – | Períodos (ex: '2023', 'last', 'last 4') |
| topN | integer | – | Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| colunas | array | yes | Rótulos das colunas, na ordem |
| estatisticas | object | – | Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo) |
| indicador | string | – | Chave do indicador consultado |
| nome | string | – | Nome do indicador |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| registros | array | yes | Registros: cada um mapeia rótulo da coluna -> valor |
| tabela | string | – | Tabela SIDRA de origem |
| totalRegistros | number | yes | Total de registros de dados |
No examples provided.
ibge_localidade Detalhes de localidade ~249
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.
| Name | Type | Req | Description |
|---|---|---|---|
| codigo | number | yes | Código IBGE da localidade (estado: 2 dígitos, município: 7 dígitos, distrito: 9 dígitos) |
| tipo | string | – | Tipo da localidade. Se não informado, será inferido pelo tamanho do código. |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| estado | object | – | Estado da localidade (município ou distrito) |
| id | number | yes | Código IBGE da localidade |
| mesorregiao | object | – | Mesorregião do município |
| microrregiao | object | – | Microrregião do município |
| municipio | object | – | Município ao qual o distrito pertence (apenas para distritos) |
| nome | string | yes | Nome da localidade |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| regiao | object | – | Região do estado (apenas para estados) |
| regiaoImediata | object | – | Região imediata do município |
| regiaoIntermediaria | object | – | Região intermediária do município |
| sigla | string | – | Sigla da UF (apenas para estados) |
| tipo | string | yes | Tipo da localidade retornada |
No examples provided.
ibge_malhas Malhas geográficas ~556
Gets geographic meshes (maps) from IBGE in GeoJSON, TopoJSON, or SVG format. Features: - Meshes for Brazil, regions, states, municipalities - Different resolution levels (internal divisions) - Different quality levels - Formats: GeoJSON (data), TopoJSON (compact), SVG (image) Locality types: - "BR" or "1" = Entire Brazil - State abbreviation (e.g., "SP", "RJ") - State code (e.g., "35" for SP) - Municipality code (7 digits) Resolution (internal divisions): - 0 = Outline only - 2 = States - 5 = Municipalities Examples: - Brazil with states: localidade="BR", resolucao="2" - São Paulo with municipalities: localidade="SP", resolucao="5" - SVG format: localidade="BR", formato="svg" Use a different tool when: - Thematic meshes (biomes, Legal Amazon, semi-arid, metropolitan regions) → ibge_malhas_tema Behavior: read-only and idempotent — a live GET against the public IBGE Malhas API. Returns the mesh in the requested format (GeoJSON, TopoJSON, or SVG).
| Name | Type | Req | Description |
|---|---|---|---|
| formato | string | – | Formato de saída (padrão: geojson) |
| intrarregiao | string | – | Divisão interna pelo nome, alternativa a resolucao: 'regiao', 'UF', 'regiao-intermediaria', 'regiao-imediata', 'mesorregiao', 'microrregiao' ou 'municipio'. Quando informado, prevalece sobre resoluca… |
| localidade | string | yes | Código IBGE ou sigla da localidade (ex: 'BR', 'SP', '35', '3550308') |
| qualidade | string | – | Qualidade do traçado: 'minima', 'intermediaria' ou 'maxima' (padrão). Os números 1–4 do IBGE antigo continuam aceitos e são traduzidos. |
| resolucao | string | – | Divisões internas a desenhar dentro da malha pedida: 0 = Sem divisões internas (só o contorno) 1 = Macrorregiões (apenas quando localidade=BR) 2 = Unidades da Federação (BR ou uma região) 3 = Mesorre… |
| tipo | string | – | Tipo de divisão territorial |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| formato | string | yes | Formato de saída solicitado (geojson, topojson ou svg) |
| intrarregiao | string | – | Divisão interna desenhada dentro da malha (vocabulário da API v3) |
| localidade | string | yes | Código IBGE ou sigla da localidade consultada |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| qualidade | string | – | Qualidade do traçado solicitada |
| resolucao | string | – | Resolução/divisões internas solicitada |
| tipo | string | – | Tipo de divisão territorial, quando informado |
| url | string | – | URL para download da malha completa |
No examples provided.
ibge_malhas_tema Malhas temáticas ~535
Lists what a THEMATIC territorial recorte of Brazil contains: how many features, with which codes and names, and the URL to download its geometry. Available recortes: - biomas: the six continental biomes - amazonia_legal: Legal Amazon boundary - semiarido: semi-arid area - costeiro: coastal municipalities - fronteira: border-strip municipalities - metropolitana: metropolitan regions - ride: Integrated Development Regions - listar: the catalogue itself, without querying the source Filtering with `codigo`: only the recortes that have a per-feature code accept it — biomas (the biome code) and the two municipality ones, costeiro and fronteira (the 7-digit IBGE municipality code). Ask without `codigo` to see what exists; biome codes come from the source, not from a fixed table. GEOMETRY IS NOT IN THE RESPONSE, on purpose: one biome polygon alone is over 9 MB. The response carries the attributes plus a canonical WFS URL that returns the recorte with geometry in GeoJSON. Use a different tool when: - Administrative meshes WITH geometry (country/region/state/municipality outlines) → ibge_malhas Behavior: read-only and idempotent — a live GET against the public IBGE Geosserviços WFS (IBGE Geociências), which is a different service from the Malhas API and the only one that publishes these recortes. Returns Markdown plus a typed structuredContent payload.
| Name | Type | Req | Description |
|---|---|---|---|
| codigo | string | – | Filtra uma feição do recorte. Só os recortes que têm código próprio aceitam: biomas (cd_bioma, ex. "1") e os dois de municípios, costeiro e fronteira (código IBGE de 7 dígitos). Nos demais a chamada… |
| limite | integer | – | Quantas feições trazer (padrão 50, máx. 600). O total do recorte vem sempre, mesmo quando o limite corta a lista. |
| tema | string | yes | Recorte temático do território: - biomas: os seis biomas continentais - amazonia_legal: limite da Amazônia Legal - semiarido: área do semiárido - costeiro: municípios da zona costeira - fronteira: mu… |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| camada | string | – | Camada WFS do IBGE Geosserviços consultada |
| codigo | string | – | Código usado como filtro, quando informado |
| feicoes | number | – | Total de feições do recorte na fonte |
| feicoes_retornadas | number | – | Quantas vieram nesta resposta |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| registros | array | – | Atributos de cada feição (sem geometria) |
| tema | string | yes | Recorte solicitado (ou 'listar') |
| temas | array | – | Lista de recortes disponíveis (somente no modo 'listar') |
| url_geometria | string | – | URL canônica do WFS que devolve a malha COM geometria, em GeoJSON |
No examples provided.
ibge_municipios Municípios do Brasil ~255
Lists Brazilian municipalities from IBGE. Features: - List municipalities by state (using state abbreviation) - List all municipalities in Brazil (5,570 municipalities) - Search by municipality name - Returns 7-digit IBGE code Examples: - São Paulo municipalities: uf="SP" - Search by name: busca="Campinas" - MG municipalities containing "Belo": uf="MG", busca="Belo" Use a different tool when: - Resolve/decode a code at any level (region, state, district), not just municipalities → ibge_geocodigo - Full details/hierarchy of one locality by code → ibge_localidade - Neighboring municipalities → ibge_vizinhos Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.
| Name | Type | Req | Description |
|---|---|---|---|
| busca | string | – | Termo para buscar no nome do município |
| limite | number | – | Número máximo de resultados (padrão: 100, máximo: 5570) |
| uf | string | – | Estado por sigla (SP), nome (São Paulo) ou código IBGE (35). Se não informado, retorna todos os municípios do Brasil. |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | string | – | Termo de busca aplicado ao nome do município |
| municipios | array | yes | Lista de municípios retornados (após filtro e limite) |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | yes | Total de municípios encontrados antes do limite |
| uf | string | – | UF informada no filtro (como recebida na entrada) |
No examples provided.
ibge_nomes Frequência e ranking de nomes ~351
Queries name frequency and rankings in Brazil (IBGE). Features: 1. **Name frequency** (tipo='frequencia'): - Birth frequency by decade - Multiple names separated by comma - Filter by sex and locality 2. **Name ranking** (tipo='ranking'): - Most popular names - Filter by decade, sex, and locality Available decades: 1930-2010 Examples: - Frequency of "Maria": tipo="frequencia", nomes="Maria" - Compare names: tipo="frequencia", nomes="João,José,Pedro" - 2000s ranking: tipo="ranking", decada=2000 - Female names: tipo="ranking", sexo="F" Behavior: read-only and idempotent — a live GET against the public IBGE Nomes (Censo) API. Returns a Markdown table.
| Name | Type | Req | Description |
|---|---|---|---|
| decada | number | – | Para tipo='ranking': Década do ranking (ex: 1990, 2000, 2010) |
| limite | number | – | Para tipo='ranking': Número de nomes (padrão: 20) |
| localidade | string | – | Código IBGE da localidade (UF: 2 dígitos, Município: 7 dígitos) |
| nomes | string | – | Para tipo='frequencia': Nome ou nomes separados por vírgula |
| sexo | string | – | Filtrar por sexo: M (masculino) ou F (feminino) |
| tipo | string | yes | Tipo de consulta: 'frequencia' para buscar nomes específicos ou 'ranking' para ver os mais populares |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| frequencia | array | – | Resultados de frequência (presente quando tipo='frequencia') |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| ranking | object | – | Resultado do ranking (presente quando tipo='ranking') |
| tipo | string | yes | Tipo da consulta realizada |
No examples provided.
ibge_noticias Notícias do IBGE ~479
Searches and lists already-published IBGE news articles and press releases. Use this to find recent IBGE publications or announcements about a survey or topic — when an indicator was released, or news mentioning a term like "censo". Results are sorted newest-first; with no parameters it returns the 10 most recent items. Parameters: - busca: free-text term to match (e.g. "PIB", "censo") - tipo: "release" (official publication of survey results) or "noticia" (general news); omit for both - de / ate: date range, format DD/MM/AAAA (e.g. de="01/01/2024", ate="31/12/2024") - destaque: true to return only featured items - quantidade: how many to return (default 10, max 100); pagina: page number to page through more Each item returns: title, type (release/news), publication date, editoria (section), related products/surveys, a featured flag, a plain-text summary, and a link to the full article. The header reports the total count and current page. Examples: - Latest 10 news: (no parameters) - Search census: busca="censo" - 2024 news: de="01/01/2024", ate="31/12/2024" - Releases only: tipo="release" Use a different tool when: - Scheduled/upcoming release dates (not yet published) → ibge_calendario Behavior: read-only and idempotent — a live GET against the public IBGE Notícias API. Returns a Markdown list.
| Name | Type | Req | Description |
|---|---|---|---|
| ate | string | – | Data final no formato DD/MM/AAAA (ex: 31/12/2024) |
| busca | string | – | Termo para buscar nas notícias |
| de | string | – | Data inicial no formato DD/MM/AAAA (ex: 01/01/2024) |
| destaque | boolean | – | Filtrar apenas notícias em destaque |
| pagina | number | – | Número da página para paginação |
| quantidade | number | – | Quantidade de notícias a retornar (padrão: 10, máximo: 100) |
| tipo | string | – | Tipo de publicação: 'release' ou 'noticia' |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | string | – | Termo de busca aplicado, se houver |
| noticias | array | yes | Lista de notícias retornadas |
| pagina | number | yes | Página atual |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | yes | Total de notícias encontradas na consulta |
| totalPaginas | number | yes | Número total de páginas |
No examples provided.
ibge_paises Dados de países ~296
Queries international country data via IBGE. Features: - List all countries (following UN M49 methodology) - Country details (area, languages, currency, location) - Search countries by name - Filter by region/continent Available regions: americas, europa, africa, asia, oceania Country codes: Use ISO-ALPHA-2 (e.g., BR, US, AR, PT, JP) Examples: - List all: tipo="listar" - Brazil details: tipo="detalhes", pais="BR" - Search: tipo="buscar", busca="Argentina" - Americas countries: tipo="listar", regiao="americas" - Available indicators: tipo="indicadores" Behavior: read-only and idempotent — a live GET against the public IBGE Países API. Returns Markdown.
| Name | Type | Req | Description |
|---|---|---|---|
| busca | string | – | Termo de busca para filtrar países pelo nome |
| indicadores | string | – | IDs dos indicadores separados por | (ex: 77819|77820) |
| pais | string | – | Código ISO-ALPHA-2 do país (ex: BR, US, AR) ou código M49 |
| regiao | string | – | Filtrar por região/continente: americas, europa, africa, asia, oceania |
| tipo | string | – | Tipo de consulta: listar (todos), detalhes (de um país), indicadores, buscar |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | string | – | Termo de busca aplicado, se houver |
| indicadores | array | – | Indicadores disponíveis para consulta de países (modo indicadores) |
| pais | object | – | Detalhes de um país específico (modo detalhes) |
| paises | array | – | Lista de países (modos listar/buscar). Limitada aos 50 primeiros na exibição |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| regiao | string | – | Filtro de região/continente aplicado, se houver |
| tipo | string | yes | Modo de consulta que originou este resultado |
| total | number | – | Total de países encontrados (modos listar/buscar) |
No examples provided.
ibge_pesquisas Pesquisas do IBGE ~278
Lists available IBGE surveys and their tables. Features: - List all IBGE surveys (Census, PNAD, GDP, etc.) - Search by name or code - Show details and tables of a specific survey - Categorize surveys by theme Main surveys: - **Census**: Demographic, Agricultural, MUNIC - **PNAD Contínua**: Employment, income, education - **National Accounts**: GDP, investments - **Economic Surveys**: Industry, Commerce, Services - **Price Indices**: IPCA, INPC Examples: - List all: (no parameters) - Search population: busca="população" - PNAD details: detalhes="pnad" This lists surveys, not data. To find table codes use ibge_sidra_tabelas; to query data use ibge_sidra (or a wrapper: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades). Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA/Pesquisas API. Returns a Markdown list.
| Name | Type | Req | Description |
|---|---|---|---|
| busca | string | – | Termo para buscar no nome ou ID da pesquisa |
| detalhes | string | – | Código da pesquisa para ver detalhes e tabelas disponíveis |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | string | – | Termo de busca aplicado, se houver (modo lista) |
| modo | string | yes | Modo de consulta que originou este resultado: lista de pesquisas ou detalhes de uma |
| pesquisa | object | – | Detalhes de uma pesquisa específica (modo detalhes) |
| pesquisas | array | – | Lista de pesquisas (modo lista) |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | – | Total de pesquisas encontradas (modo lista) |
No examples provided.
ibge_sidra Consulta de tabelas SIDRA ~1,285
Queries SIDRA tables (IBGE's Automatic Recovery System). SIDRA contains data from IBGE surveys like Census, PNAD, GDP, etc. Common tables: - 6579: Population estimates (annual) - 9514: Census 2022 population - 200: Census population (1970-2010) - 4714: Population, territorial area and density (Census 2022) - 4099: Unemployment rate (PNAD Contínua, quarterly) - 5436: Average real income (PNAD Contínua, quarterly) - 6706: GDP at current prices - 5938: GDP per capita Territorial levels: - 1: Brazil - 2: Region (North, Northeast, etc.) - 3: State (UF) - 6: Municipality - 7: Metropolitan Region Examples: - Brazil population 2023: tabela="6579", periodos="2023" - Population by state: tabela="6579", nivel_territorial="3" - Census 2022 by municipality: tabela="9514", nivel_territorial="6", localidades="3550308" Statistics mode: for **largest/smallest/mean/median/distribution/ranking** questions ("which municipality has the largest population?", "median GDP by state") use estatisticas=true — it computes min/max/mean/median/std-dev/labeled percentiles over ALL data rows BEFORE pagination and returns top/bottom rankings (default 10, cap 100 via topN), so one call answers what would otherwise require paging thousands of records. With agruparPor="<column label>" (e.g. "Unidade da Federação", "Ano") it ranks groups by descending sum, each with its own mini-distribution. Queries mixing several variables auto-group by "Variável" (units differ). SIDRA absence markers ("-", "..", "...", "X") are excluded from n. In this mode pagina/campos/formato are ignored and registros comes empty. Very large queries are refused by the source (since 2026-09-16 SIDRA tables are read through the Aggregates API, whose ceiling is lower than SIDRA's old 100,000-value cap: all municipalities × 12 yearly periods fails, × 8 works) — narrow periodos (e.g. "last 4") or raise nivel_territorial. ibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits: - Census themes (1970–2022) →…
| Name | Type | Req | Description |
|---|---|---|---|
| agruparPor | string | – | Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuiç… |
| campos | string | – | Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. Omitir traz todas. |
| classificacoes | string | – | Classificações no formato 'id[categorias]' (ex: '2[6794]' para sexo masculino) |
| estatisticas | boolean | – | Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'med… |
| formato | string | – | Formato de saída: 'json' para dados brutos ou 'tabela' para formato legível |
| localidades | string | – | Códigos das localidades separados por vírgula, ou 'all' para todas |
| nivel_territorial | string | – | Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município, 7=Região Metropolitana, 8=Mesorregião, 9=Microrregião, 10=Distrito, 11=Subdistrito, 13=RM/RIDE, 14=RIDE, 15=Aglomeração Urbana, 17… |
| pagina | integer | – | Página de resultados (100 registros por página) |
| periodos | string | – | Períodos: 'last' para último, 'all' para todos, ou anos específicos (ex: 2020,2021,2022) |
| tabela | string | yes | Código da tabela SIDRA (ex: 6579 para estimativas de população, 9514 para censo 2022) |
| topN | integer | – | Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100) |
| variaveis | string | – | IDs das variáveis separados por vírgula, ou 'allxp' para todas |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| colunas | array | yes | Rótulos das colunas, na ordem |
| estatisticas | object | – | Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo) |
| nome | string | yes | Nome da tabela (quando conhecido) |
| paginacao | object | yes | Metadados de paginação para continuação |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| registros | array | yes | Registros da página atual: cada um mapeia rótulo da coluna -> valor |
| tabela | string | yes | Código da tabela SIDRA consultada |
| totalRegistros | number | yes | Total de registros de dados disponíveis (todas as páginas) |
No examples provided.
ibge_sidra_metadados Metadados de tabela SIDRA ~227
Returns metadata for a specific SIDRA table. Features: - General info (name, survey, subject, periodicity) - Available territorial levels - Variable list with units - Classifications and categories - Available periods Use this tool to understand table structure BEFORE querying data with ibge_sidra. Examples: - Population table metadata: tabela="6579" - Census 2022 metadata: tabela="9514" - PNAD unemployment: tabela="4714" Use this after finding a table code (ibge_sidra_tabelas) and before querying with ibge_sidra. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown.
| Name | Type | Req | Description |
|---|---|---|---|
| incluir_localidades | boolean | – | Incluir níveis territoriais disponíveis (padrão: false) |
| incluir_periodos | boolean | – | Incluir lista de períodos disponíveis (padrão: true) |
| tabela | string | yes | Código da tabela/agregado SIDRA (ex: '6579', '9514', '4714') |
| Name | Type | Req | Description |
|---|---|---|---|
| assunto | string | – | Assunto/tema da tabela |
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| codigo | string | yes | Código da tabela/agregado SIDRA |
| niveisTerritoriais | array | – | Níveis territoriais disponíveis para a tabela |
| nome | string | yes | Nome da tabela |
| periodicidade | object | – | Periodicidade da pesquisa |
| periodos | array | – | Períodos disponíveis para a tabela (quando incluir_periodos) |
| pesquisa | string | – | Nome da pesquisa de origem |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| url | string | – | URL da tabela no SIDRA |
| variaveis | array | – | Variáveis da tabela, com unidades e classificações/categorias |
No examples provided.
ibge_sidra_tabelas Busca de tabelas SIDRA ~394
Lists and searches available SIDRA tables. Features: - List all SIDRA tables (aggregates) - Search by table name: every word must match (AND), accents and case ignored, and everyday Portuguese is resolved to the IBGE's own wording (renda→rendimento, desemprego→desocupação, cidade→município, gênero→sexo); when that happens the response says so in notas_vocabulario - Filter by survey (Census, PNAD, GDP, etc.) - Shows code and name of each table SIDRA contains data from various surveys: - Demographic Census - PNAD Contínua (employment, income) - National Accounts (GDP) - Industrial Survey - Agricultural Survey Examples: - List tables: (no parameters) - Search population tables: busca="população" - Census tables: pesquisa="censo" This is step 1 of the SIDRA workflow: find a table code → ibge_sidra_metadados (structure) → ibge_sidra (query). For common data, a wrapper is usually easier: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns a Markdown table.
| Name | Type | Req | Description |
|---|---|---|---|
| busca | string | – | Termos para buscar no nome das tabelas/agregados (sem distinção de acento ou caixa; AND entre as palavras; a palavra de todo dia é traduzida para a do IBGE — renda→rendimento, desemprego→desocupação,… |
| limite | number | – | Número máximo de resultados (padrão: 20) |
| pesquisa | string | – | Filtrar por código ou nome da pesquisa (ex: 'censo', 'pnad', 'pib') |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| busca | string | – | Termo de busca aplicado, se houver |
| notas_vocabulario | array | – | Quando a busca foi ampliada para a palavra que o IBGE usa (renda→rendimento), diz qual |
| pesquisa | string | – | Filtro de pesquisa aplicado, se houver |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| tabelas | array | yes | Lista de tabelas SIDRA retornadas |
| total | number | yes | Total de tabelas que correspondem aos critérios |
No examples provided.
ibge_vizinhos Municípios vizinhos ~265
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.
| Name | Type | Req | Description |
|---|---|---|---|
| incluir_dados | boolean | – | Incluir dados populacionais dos vizinhos |
| municipio | string | yes | Código IBGE do município (7 dígitos) ou nome do município |
| raio | number | – | Raio em km para buscar municípios próximos (usa centróides) |
| uf | string | – | Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) — obrigatório se usar nome do município |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| municipio | object | yes | Município de referência da consulta |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| total | number | yes | Quantidade de municípios próximos encontrados |
| vizinhos | array | yes | Lista de municípios próximos (mesma mesorregião) |
No examples provided.
search Busca para Deep Research ~236
Searches the IBGE (Brazilian official statistics: SIDRA tables, municipalities, known indicators) catalog and returns up to 10 matching documents as { id, title, url }, ordered by relevance (an empty list means nothing matched). This tool exists for the OpenAI Deep Research contract: ChatGPT deep research, company knowledge and research workflows over the Responses API require exactly the tools `search` and `fetch`. Pass one of the returned ids to `fetch` to read the document. For direct questions and for data (values, series, rankings) prefer the `ibge_*` tools (`ibge_sidra`, `ibge_cidades`, `ibge_indicadores`, `ibge_comparar`…), which return the actual data with provenance — this is a catalog index, not a data query. Query: natural language or keywords, Portuguese or English; accents and case are ignored. Behavior: read-only and idempotent — the catalog comes from the public source and is cached in memory.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Termos de busca em linguagem natural ou palavras-chave (acentos e caixa são ignorados) |
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | array | yes | URLs canônicas das fontes desta resposta (lista de atribuição) |
| provenance | object | yes | Bloco de proveniência (contrato v1.0): fonte, URL, período, extração e licença |
| results | array | yes | Documentos encontrados, em ordem de relevância |
No examples provided.
What is the IBGE Brasil MCP server?
IBGE Brasil MCP is listed in the public MCP registry as io.github.SidneyBissoli/ibge-br-mcp. IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools. This page covers its hosted endpoint (https://ibge.sidneybissoli.com/mcp).
Is the IBGE Brasil MCP server safe to use?
IBGE Brasil MCP scores 84 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the IBGE Brasil MCP server expose?
IBGE Brasil MCP exposes 23 tools: ibge_estados, ibge_municipios, ibge_localidade, ibge_sidra, ibge_nomes, and 18 more. Their descriptions and schemas cost roughly 10,236 tokens of context every time the server is loaded.
Does the IBGE Brasil MCP server require authentication?
No. We connected to IBGE Brasil MCP without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the IBGE Brasil MCP server still maintained?
IBGE Brasil MCP is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.