IBGE Brasil MCP

sidneybissoli/ibge-br-mcp

Connects Claude to IBGE's public APIs, giving you programmatic access to Brazil's official geographic, demographic, and statistical data. You get 23 tools covering localities (states, municipalities, neighbors), SIDRA tables for census and survey data, economic indicators like GDP and IPCA, population projections, name frequency analysis, and geographic meshes in GeoJSON or SVG. Also pulls from Central Bank for financial data and DataSUS for health metrics. Built with caching, retry logic, and 227 tests. Useful when you need authoritative Brazilian data for research, reporting, or geographic analysis without manually navigating government portals or scraping sites.

GitHub stars: 14
tools: 23
transport: STDIO, HTTP
last updated: Oct 28, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://ibge.sidneybissoli.com/mcp --name ibge-br-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http ibge-br-mcp https://ibge.sidneybissoli.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 23 tools

Verified live against the running server on Nov 6, 2026.

ibge_estadosLists 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: regia...2 params

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: regia...

Parameters* required

ordenarstring

Campo para ordenação dos resultadosone of id · nome · sigladefault: nome

regiaostring

Filtrar por região: N (Norte), NE (Nordeste), SE (Sudeste), S (Sul), CO (Centro-Oeste)one of N · NE · SE · S · CO

ibge_municipiosLists 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" - Se...3 params

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

Parameters* required

buscastring

Termo para buscar no nome do município

limitenumber

Número máximo de resultados (padrão: 100, máximo: 5570)default: 100

ufstring

Estado por sigla (SP), nome (São Paulo) ou código IBGE (35). Se não informado, retorna todos os municípios do Brasil.

ibge_localidadeReturns 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...2 params

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

Parameters* required

codigo*number

Código IBGE da localidade (estado: 2 dígitos, município: 7 dígitos, distrito: 9 dígitos)

tipostring

Tipo da localidade. Se não informado, será inferido pelo tamanho do código.one of estado · municipio · distrito

ibge_sidraQueries 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...12 params

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

Parameters* required

agruparPorstring

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

camposstring

Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. Omitir traz todas.

classificacoesstring

Classificações no formato 'id[categorias]' (ex: '2[6794]' para sexo masculino)

estatisticasboolean

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', 'm...default: false

formatostring

Formato de saída: 'json' para dados brutos ou 'tabela' para formato legívelone of json · tabeladefault: tabela

localidadesstring

Códigos das localidades separados por vírgula, ou 'all' para todasdefault: all

nivel_territorialstring

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,...default: 1

paginainteger

Página de resultados (100 registros por página)default: 1

periodosstring

Períodos: 'last' para último, 'all' para todos, ou anos específicos (ex: 2020,2021,2022)default: last

tabela*string

Código da tabela SIDRA (ex: 6579 para estimativas de população, 9514 para censo 2022)

topNinteger

Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)default: 10

variaveisstring

IDs das variáveis separados por vírgula, ou 'allxp' para todasdefault: allxp

ibge_nomesQueries 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...6 params

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

Parameters* required

decadanumber

Para tipo='ranking': Década do ranking (ex: 1990, 2000, 2010)

limitenumber

Para tipo='ranking': Número de nomes (padrão: 20)default: 20

localidadestring

Código IBGE da localidade (UF: 2 dígitos, Município: 7 dígitos)

nomesstring

Para tipo='frequencia': Nome ou nomes separados por vírgula

sexostring

Filtrar por sexo: M (masculino) ou F (feminino)one of M · F

tipo*string

Tipo de consulta: 'frequencia' para buscar nomes específicos ou 'ranking' para ver os mais popularesone of frequencia · ranking

ibge_noticiasSearches 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 par...7 params

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

Parameters* required

atestring

Data final no formato DD/MM/AAAA (ex: 31/12/2024)

buscastring

Termo para buscar nas notícias

destring

Data inicial no formato DD/MM/AAAA (ex: 01/01/2024)

destaqueboolean

Filtrar apenas notícias em destaque

paginanumber

Número da página para paginaçãodefault: 1

quantidadenumber

Quantidade de notícias a retornar (padrão: 10, máximo: 100)default: 10

tipostring

Tipo de publicação: 'release' ou 'noticia'one of release · noticia

ibge_sidra_tabelasLists 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, cid...3 params

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, cid...

Parameters* required

buscastring

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çã...

limitenumber

Número máximo de resultados (padrão: 20)default: 20

pesquisastring

Filtrar por código ou nome da pesquisa (ex: 'censo', 'pnad', 'pib')

ibge_sidra_metadadosReturns 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...3 params

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

Parameters* required

incluir_localidadesboolean

Incluir níveis territoriais disponíveis (padrão: false)default: false

incluir_periodosboolean

Incluir lista de períodos disponíveis (padrão: true)default: true

tabela*string

Código da tabela/agregado SIDRA (ex: '6579', '9514', '4714')

ibge_malhasGets 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)...6 params

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

Parameters* required

formatostring

Formato de saída (padrão: geojson)one of geojson · topojson · svgdefault: geojson

intrarregiaostring

Divisão interna pelo nome, alternativa a resolucao: 'regiao', 'UF', 'regiao-intermediaria', 'regiao-imediata', 'mesorregiao', 'microrregiao' ou 'municipio'. Quando informado, prevalece sobre resolu...

localidade*string

Código IBGE ou sigla da localidade (ex: 'BR', 'SP', '35', '3550308')

qualidadestring

Qualidade do traçado: 'minima', 'intermediaria' ou 'maxima' (padrão). Os números 1–4 do IBGE antigo continuam aceitos e são traduzidos.one of 1 · 2 · 3 · 4 · minima · intermediariadefault: maxima

resolucaostring

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 = Mesor...one of 0 · 1 · 2 · 3 · 4 · 5default: 0

tipostring

Tipo de divisão territorialone of paises · regioes · estados · mesorregioes · microrregioes · municipios

ibge_pesquisasLists 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 - **PNA...2 params

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 - **PNA...

Parameters* required

buscastring

Termo para buscar no nome ou ID da pesquisa

detalhesstring

Código da pesquisa para ver detalhes e tabelas disponíveis

ibge_censoQueries 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: Housin...9 params

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: Housin...

Parameters* required

agruparPorstring

anostring

Ano do censo (1970, 1980, 1991, 2000, 2010, 2022) ou 'todos' para série históricaone of 1970 · 1980 · 1991 · 2000 · 2010 · 2022

camposstring

Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.

estatisticasboolean

formatostring

Formato de saídaone of tabela · jsondefault: tabela

localidadesstring

Códigos das localidades ou 'all'default: all

nivel_territorialstring

Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Municípiodefault: 1

temastring

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 relig...one of populacao · alfabetizacao · domicilios · idade_sexo · religiao · cor_racadefault: populacao

topNinteger

Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)default: 10

ibge_indicadoresQueries IBGE economic and social indicators. Available indicators: **Economic:** - pib: quarterly GDP at current prices, R$ million (Brazil only) - pib_variacao: quarterly GDP volume change, % over the same quarter of the previous year (Brazil only) - pib_per_capita: annual GD...10 params

Queries IBGE economic and social indicators. Available indicators: **Economic:** - pib: quarterly GDP at current prices, R$ million (Brazil only) - pib_variacao: quarterly GDP volume change, % over the same quarter of the previous year (Brazil only) - pib_per_capita: annual GD...

Parameters* required

agruparPorstring

camposstring

Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.

categoriastring

Filtrar por categoria de indicadoresone of economico · precos · trabalho · populacao · agropecuaria · todos

estatisticasboolean

formatostring

Formato de saídaone of tabela · jsondefault: tabela

indicadorstring

Nome do indicador (ex: "pib", "ipca", "desemprego", "populacao"). Use "listar" para ver todos os indicadores disponíveis.

localidadesstring

Códigos das localidades ou 'all'default: all

nivel_territorialstring

Nível territorial (código N): 1=Brasil, 2=Região, 3=UFdefault: 1

periodosstring

Períodos (ex: '2023', 'last', 'last 4')default: last

topNinteger

Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)default: 10

ibge_cnaeQueries 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...4 params

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

Parameters* required

buscastring

Termo para buscar na descrição das atividades (ex: 'software', 'restaurante', 'comércio'). Acento e caixa não importam, e várias palavras casam em E ('comercio varejista'). A palavra de todo dia é...

codigostring

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

limitenumber

Número máximo de resultados (padrão: 20)default: 20

nivelstring

Nível hierárquico para listar (padrão: mostra todos os níveis relevantes)one of secoes · divisoes · grupos · classes · subclasses

ibge_geocodigoDecodes 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,...3 params

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

Parameters* required

codigostring

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

nomestring

Nome da localidade para encontrar o código IBGE (estado ou município)

ufstring

Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) para restringir a busca por nome de município

ibge_calendarioQueries 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**: Fiel...6 params

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**: Fiel...

Parameters* required

atestring

Data final no formato DD/MM/AAAA (ex: '31/12/2024')

destring

Data inicial no formato DD/MM/AAAA (ex: '01/01/2024')

paginanumber

Número da página (padrão: 1)default: 1

produtostring

Filtrar por produto/pesquisa (ex: 'IPCA', 'PNAD', 'PIB')

quantidadenumber

Quantidade de resultados por página (padrão: 20)default: 20

tipostring

Tipo de evento: 'divulgacao' (publicações), 'coleta' (pesquisas de campo), ou 'todos'one of divulgacao · coleta · todosdefault: divulgacao

ibge_compararCompares 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²) - alfabetizaca...3 params

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

Parameters* required

formatostring

Formato de saída: tabela, json ou ranking (ordenado)one of tabela · json · rankingdefault: tabela

indicadorstring

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...one of populacao · populacao_censo · pib · area · densidade · alfabetizacaodefault: populacao

localidades*string

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.

ibge_malhas_temaLists 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 - cos...3 params

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

Parameters* required

codigostring

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

limiteinteger

Quantas feições trazer (padrão 50, máx. 600). O total do recorte vem sempre, mesmo quando o limite corta a lista.default: 50

tema*string

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:...one of biomas · amazonia_legal · semiarido · costeiro · fronteira · metropolitana

ibge_vizinhosFinds 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 exa...4 params

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

Parameters* required

incluir_dadosboolean

Incluir dados populacionais dos vizinhosdefault: false

municipio*string

Código IBGE do município (7 dígitos) ou nome do município

raionumber

Raio em km para buscar municípios próximos (usa centróides)

ufstring

Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) — obrigatório se usar nome do município

ibge_datasaudeQueries 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 Demographi...9 params

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

Parameters* required

agruparPorstring

camposstring

Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.

estatisticasboolean

formatostring

Formato de saídaone of tabela · jsondefault: tabela

indicador*string

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

localidadestring

Código da localidade ou 'all'default: all

nivel_territorialstring

Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Municípiodefault: 1

periodostring

Período: 'last', 'all', ou ano específicodefault: last

topNinteger

Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)default: 10

ibge_paisesQueries international country data via IBGE. Features: - List all countries (following UN M49 methodology) - Country details (area, languages, currency, location) with the latest published value of country indicators — by default population, GDP, GDP per capita, HDI and life e...5 params

Queries international country data via IBGE. Features: - List all countries (following UN M49 methodology) - Country details (area, languages, currency, location) with the latest published value of country indicators — by default population, GDP, GDP per capita, HDI and life e...

Parameters* required

buscastring

Termo de busca para filtrar países pelo nome

indicadoresstring

Indicadores a trazer no modo detalhes, separados por | — IDs ou apelidos (ex: 77819|77820 ou idh|populacao). Lista completa: tipo='indicadores'. Sem este parâmetro: população, PIB, PIB per capita,...

paisstring

Código ISO-ALPHA-2 do país (ex: BR, US, AR) ou código M49

regiaostring

Filtrar por região/continente: americas, europa, africa, asia, oceania

tipostring

Tipo de consulta: listar (todos), detalhes (de um país), indicadores, buscarone of listar · detalhes · indicadores · buscardefault: listar

ibge_cidadesQueries 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: pop...5 params

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: pop...

Parameters* required

indicadorstring

ID do indicador ou nome para busca

municipiostring

Código IBGE do município (7 dígitos)

pesquisastring

ID da pesquisa para filtrar indicadores

tipostring

Tipo de consulta: panorama (resumo geral), indicador (específico), pesquisas (listar), historicoone of panorama · indicador · pesquisas · historicodefault: panorama

ufstring

Código ou sigla da UF para filtrar (ex: 35 ou SP)

searchSearches 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 co...1 params

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

Parameters* required

query*string

Termos de busca em linguagem natural ou palavras-chave (acentos e caixa são ignorados)

fetchReturns 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 offici...1 params

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

Parameters* required

id*string

Identificador de um documento devolvido por `search`