IBGE Brasil MCP

NPM · IBGE-BR-MCP · 2 COMPONENTS · SCANNED AUG 3

MCP server for live, sourced Brazilian public data from the official IBGE APIs.

Available components

remote · ibge.sidneybissoli.com 69 npm · ibge-br-mcp 75

+25 this week 75 75 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to SidneyBissoli/ibge-br-mcp). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 42 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability73

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 8404 tokens (~311/item across 27 items; 22 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 Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

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

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · ibge-br-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add sidneybissoli-ibge-br-mcp -- npx -y ibge-br-mcp

# add to Codex CLI

codex mcp add sidneybissoli-ibge-br-mcp -- npx -y ibge-br-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sidneybissoli-ibge-br-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ibge-br-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add sidneybissoli-ibge-br-mcp --command npx --arg -y --arg ibge-br-mcp

# ~/.hermes/config.yaml

mcp_servers:
  sidneybissoli-ibge-br-mcp:
    command: "npx"
    args: ["-y", "ibge-br-mcp"]

// mcp.json

{
  "mcpServers": {
    "sidneybissoli-ibge-br-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ibge-br-mcp"
      ]
    }
  }
}

Changelog

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.

2 Aug 26 +33
- Provenance: pass → unverified ▼ security
- Install scripts: pass → unverified ▼ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- The attested source repository moved: SidneyBissoli/ibge-br-mcp security
- Maintenance: pass → unverified ▼ functional
- License: pass → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
1 Aug 26 +19
- Schema quality: unverified → 100 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
31 Jul 26 +17
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −52
- Provenance: pass → unverified ▼ security
- Known CVEs: partial → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- Install scripts: pass → unverified ▼ security
- The attested source repository moved: SidneyBissoli/ibge-br-mcp security
- Dependency health: partial → unverified ▼ functional
- License: pass → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Licence: MIT functional
29 Jul 26 +8
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- The attested source repository moved: SidneyBissoli/ibge-br-mcp security
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
27 Jul 26 50

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

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 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: SidneyBissoli/ibge-br-mcp
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/SidneyBissoli/ibge-br-mcp/.github/workflows/publish.yml@refs/heads/main
Rekor log index:: 1900973658
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:eb90b81049ea55cf6fa2e3bd18e0b3544b6ce2e3f83c8b7fb142ecb2eff010c7dec9f61bbc9a5ae4aafb6d40b24ca814faba654b655e1626e4567f514
Discovery method:: attestation_endpoint

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 22 exposed · ~8,257 tokens

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.

Tool Tokens

ibge_calendario ~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.

Input Output Examples

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
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
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 ~611

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" Use a different tool when: - Current real-time Brazil population → ibge_populacao - 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.

Input Output Examples

Name	Type	Req	Description
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.
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ã…

Name	Type	Req	Description
ano	string	—	Ano(s) de referência
colunas	array	yes	Rótulos das colunas, na ordem
descricao	string	—	Descrição da tabela
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 ~354

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: - Real-time Brazil population → ibge_populacao - 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.

Input Output Examples

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
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
tipo	string	yes	Tipo de consulta (panorama, indicador, pesquisas, historico)

No examples provided.

ibge_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.

Input Output Examples

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
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

No examples provided.

ibge_comparar ~448

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.

Input Output Examples

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 per capita - area: Área territorial (km²) - densidade: Densidade demográfic…
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
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
tabela	string	—	Tabela SIDRA de origem

No examples provided.

ibge_datasaude ~591

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 - obitos_causas: Deaths by cause (ICD-10) 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" 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.

Input Output Examples

Name	Type	Req	Description
campos	string	—	Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.
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

Name	Type	Req	Description
colunas	array	yes	Rótulos das colunas, na ordem
fonte	string	—	Fonte do dado
indicador	string	—	Chave do indicador de saúde consultado
nome	string	—	Nome do indicador
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 ~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.

Input Output Examples

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
estados	array	yes	Lista de estados
total	number	yes	Total de estados retornados

No examples provided.

ibge_geocodigo ~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.

Input Output Examples

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
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
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 ~460

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" 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.

Input Output Examples

Name	Type	Req	Description
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
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')

Name	Type	Req	Description
colunas	array	yes	Rótulos das colunas, na ordem
indicador	string	—	Chave do indicador consultado
nome	string	—	Nome do indicador
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 ~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.

Input Output Examples

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
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
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 ~454

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).

Input Output Examples

Name	Type	Req	Description
formato	string	—	Formato de saída (padrão: geojson)
intrarregiao	string	—	Código de região para filtrar (apenas quando localidade=BR)
localidade	string	yes	Código IBGE ou sigla da localidade (ex: 'BR', 'SP', '35', '3550308')
qualidade	string	—	Qualidade do traçado: 1=mínima, 2=baixa, 3=intermediária, 4=máxima
resolucao	string	—	Resolução/divisões internas: 0 = Sem divisões internas 1 = Macrorregiões (apenas para BR) 2 = Unidades da Federação 3 = Mesorregiões 4 = Microrregiões 5 = Municípios
tipo	string	—	Tipo de divisão territorial

Name	Type	Req	Description
formato	string	yes	Formato de saída solicitado (geojson, topojson ou svg)
intrarregiao	string	—	Código de região usado para filtrar (apenas quando localidade=BR)
localidade	string	yes	Código IBGE ou sigla da localidade consultada
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 ~450

Gets thematic geographic meshes from IBGE. Available themes: - biomas: Brazilian biomes (Amazon, Cerrado, Atlantic Forest, Caatinga, Pampa, Pantanal) - amazonia_legal: Legal Amazon area - semiarido: Semi-arid region - costeiro: Coastal zone - fronteira: Border strip - metropolitana: Metropolitan regions - ride: Integrated Development Regions Biome codes: - 1: Amazon - 2: Cerrado - 3: Atlantic Forest - 4: Caatinga - 5: Pampa - 6: Pantanal Examples: - All biomes: tema="biomas" - Amazon biome: tema="biomas", codigo="1" - Legal Amazon: tema="amazonia_legal" - Metropolitan regions: tema="metropolitana" - With municipalities: tema="biomas", resolucao="5" - List themes: tema="listar" Use a different tool when: - Administrative meshes (Brazil/region/state/municipality outlines) → ibge_malhas 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).

Input Output Examples

Name	Type	Req	Description
codigo	string	—	Código específico do tema (ex: código do bioma, da região metropolitana)
formato	string	—	Formato de saída
qualidade	string	—	Qualidade do traçado: 1=mínima, 4=máxima
resolucao	string	—	0 = Apenas contorno, 5 = Com municípios
tema	string	yes	Tema da malha: - biomas: Biomas brasileiros (Amazônia, Cerrado, etc.) - amazonia_legal: Área da Amazônia Legal - semiarido: Região do semiárido - costeiro: Zona costeira - fronteira: Faixa de frontei…

Name	Type	Req	Description
codigo	string	—	Código específico do tema, quando informado
formato	string	—	Formato de saída (geojson, topojson, svg)
resolucao	string	—	Resolução da malha (0 = contorno, 5 = com municípios)
tema	string	yes	Tema da malha solicitada (ou 'listar')
temas	array	—	Lista de temas disponíveis (somente no modo 'listar')

No examples provided.

ibge_municipios ~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.

Input Output Examples

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
busca	string	—	Termo de busca aplicado ao nome do município
municipios	array	yes	Lista de municípios retornados (após filtro e limite)
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 ~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.

Input Output Examples

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
frequencia	array	—	Resultados de frequência (presente quando tipo='frequencia')
ranking	object	—	Resultado do ranking (presente quando tipo='ranking')
tipo	string	yes	Tipo da consulta realizada

No examples provided.

ibge_noticias ~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.

Input Output Examples

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
busca	string	—	Termo de busca aplicado, se houver
noticias	array	yes	Lista de notícias retornadas
pagina	number	yes	Página atual
total	number	yes	Total de notícias encontradas na consulta
totalPaginas	number	yes	Número total de páginas

No examples provided.

ibge_paises ~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.

Input Output Examples

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
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
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 ~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.

Input Output Examples

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
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)
total	number	—	Total de pesquisas encontradas (modo lista)

No examples provided.

ibge_populacao ~190

Returns real-time Brazilian population projection. Features: - Current population estimate - Birth rate (average time between births) - Death rate (average time between deaths) - Daily population increment Source: IBGE - Brazilian Population Projection This tool ONLY returns Brazil's real-time national projection. Use a different tool when: - Population of a specific municipality/state → ibge_cidades (panorama) - Census or historical population → ibge_censo - Comparing/ranking multiple localities → ibge_comparar - Population time series → ibge_indicadores - An arbitrary SIDRA table → ibge_sidra Behavior: read-only and idempotent — a live GET against the public IBGE population-projection API. Returns Markdown plus a typed structuredContent payload.

Input Output Examples

Name	Type	Req	Description
localidade	string	—	Localidade para projeção populacional (atualmente apenas BR disponível)

Name	Type	Req	Description
horario	string	yes	Data/hora da consulta
localidade	string	yes	Localidade da projeção
periodoMedio	object	yes	Indicadores do período médio
populacao	number	yes	População projetada (habitantes)

No examples provided.

ibge_sidra ~763

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: Unemployment rate (PNAD Contínua) - 6381: Average income (PNAD Contínua) - 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" ibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits: - Census themes (1970–2022) → ibge_censo - Economic/social time series → ibge_indicadores - Rank/compare 2–10 localities → ibge_comparar - One municipality's panel → ibge_cidades Use ibge_sidra_tabelas and ibge_sidra_metadados to find a table code and its structure before querying. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.

Input Output Examples

Name	Type	Req	Description
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)
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)
variaveis	string	—	IDs das variáveis separados por vírgula, ou 'allxp' para todas

Name	Type	Req	Description
colunas	array	yes	Rótulos das colunas, na ordem
nome	string	yes	Nome da tabela (quando conhecido)
paginacao	object	yes	Metadados de paginação para continuação
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 ~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.

Input Output Examples

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
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
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 ~288

Lists and searches available SIDRA tables. Features: - List all SIDRA tables (aggregates) - Search by table name - 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.

Input Output Examples

Name	Type	Req	Description
busca	string	—	Termo para buscar no nome das tabelas/agregados
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
busca	string	—	Termo de busca aplicado, se houver
pesquisa	string	—	Filtro de pesquisa aplicado, se houver
tabelas	array	yes	Lista de tabelas SIDRA retornadas
total	number	yes	Total de tabelas que correspondem aos critérios

No examples provided.

ibge_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.

Input Output Examples

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
municipio	object	yes	Município de referência da consulta
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.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug

Day	Score
27 Jul	50
28 Jul	50
29 Jul	58
30 Jul	6
31 Jul	23
1 Aug	42
2 Aug	75
3 Aug	75