Combien d'outils expose io.github.SidneyBissoli/ibge-br-mcp ?

io.github.SidneyBissoli/ibge-br-mcp expose 23 outil(s). Le coût de contexte pour les charger tous est d'environ 54106 tokens (coût unique au chargement, pas par appel).

accueil / serveurs / Recherche & Web / io.github.SidneyBissoli/ibge-br-mcp

io.github.SidneyBissoli/ibge-br-mcp

serveur MCP (Model Context Protocol) · ibge-br-mcp 5.10.0

▸ Recherche & Web

[ Non encore testé ]

Verdict MCP Hub
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.

streamable-httpType / transport

directAccès

~54106 tokensCoût de contexte

23Outils

Est-ce que io.github.SidneyBissoli/ibge-br-mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.SidneyBissoli/ibge-br-mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 23 outils

fetch≈ 1722 tokens
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.
Paramètres, retour & exemple (1)
Paramètres
- id · string · requis
  Identificador de um documento devolvido por `search`
Exemple d'appel
```
{"name": "fetch", "arguments": {"id": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "url": "texte", "text": "texte", "title": "texte", "metadata": {}, "provenance": {}, "attribution": []}}
```
ibge_calendario≈ 2026 tokens
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.
Paramètres, retour & exemple (6)
Paramètres
- de · string · optionnel
  Data inicial no formato DD/MM/AAAA (ex: '01/01/2024')
- ate · string · optionnel
  Data final no formato DD/MM/AAAA (ex: '31/12/2024')
- tipo · string · optionnel · divulgacao | coleta | todos
  Tipo de evento: 'divulgacao' (publicações), 'coleta' (pesquisas de campo), ou 'todos'
- pagina · number · optionnel
  Número da página (padrão: 1)
- produto · string · optionnel
  Filtrar por produto/pesquisa (ex: 'IPCA', 'PNAD', 'PIB')
- quantidade · number · optionnel
  Quantidade de resultados por página (padrão: 20)
Exemple d'appel
```
{"name": "ibge_calendario", "arguments": {"de": "texte", "ate": "texte", "tipo": "divulgacao", "pagina": 1, "produto": "texte", "quantidade": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"total": 1, "pagina": 1, "eventos": [], "produto": "texte", "provenance": {}, "attribution": [], "totalPaginas": 1}}
```
ibge_censo≈ 3620 tokens
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.
Paramètres, retour & exemple (9)
Paramètres
- ano · string · optionnel · 1970 | 1980 | 1991 | 2000 | 2010 | 2022 | todos
  Ano do censo (1970, 1980, 1991, 2000, 2010, 2022) ou 'todos' para série histórica
- tema · string · optionnel · populacao | alfabetizacao | domicilios | idade_sexo | religiao | cor_raca | rendimento | migracao
  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ão - cor_raca: Cor ou raça - rendimento: Rendimento mensal - migracao: Migração - educacao: Nível de instrução - trabalho: Ocupação e trabalho - indigenas: População indígena - quilombolas: População quilombola - saneamento: Abastecimento de água e esgoto - deficiencia: Pessoas com deficiência - nupcialidade: Estado civil - fecundidade: Taxa de fecundidade - listar: Lista tabelas disponíveis
- topN · integer · optionnel
  Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)
- campos · string · optionnel
  Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.
- formato · string · optionnel · tabela | json
  Formato de saída
- agruparPor · string · optionnel
  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ção. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido
- localidades · string · optionnel
  Códigos das localidades ou 'all'
- estatisticas · boolean · optionnel
  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', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato
- nivel_territorial · string · optionnel
  Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município
Exemple d'appel
```
{"name": "ibge_censo", "arguments": {"ano": "1970", "tema": "populacao", "topN": 1, "campos": "texte", "formato": "tabela", "agruparPor": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"ano": "texte", "tema": "texte", "tabela": "texte", "colunas": [], "unidades": [], "descricao": "texte", "registros": [], "provenance": {}, "attribution": [], "estatisticas": {}, "totalRegistros": 1}}
```
ibge_cidades≈ 1927 tokens
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.
Paramètres, retour & exemple (5)
Paramètres
- uf · string · optionnel
  Código ou sigla da UF para filtrar (ex: 35 ou SP)
- tipo · string · optionnel · panorama | indicador | pesquisas | historico
  Tipo de consulta: panorama (resumo geral), indicador (específico), pesquisas (listar), historico
- pesquisa · string · optionnel
  ID da pesquisa para filtrar indicadores
- indicador · string · optionnel
  ID do indicador ou nome para busca
- municipio · string · optionnel
  Código IBGE do município (7 dígitos)
Exemple d'appel
```
{"name": "ibge_cidades", "arguments": {"uf": "texte", "tipo": "panorama", "pesquisa": "texte", "indicador": "texte", "municipio": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "tipo": "texte", "municipio": "texte", "provenance": {}, "attribution": [], "indicadores": []}}
```
ibge_cnae≈ 2592 tokens
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.
Paramètres, retour & exemple (4)
Paramètres
- busca · string · optionnel
  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 é traduzida para a da CNAE quando preciso — farmácia → produtos farmacêuticos, academia → condicionamento físico, lixo → resíduos — e a resposta diz quando traduziu.
- nivel · string · optionnel · secoes | divisoes | grupos | classes | subclasses
  Nível hierárquico para listar (padrão: mostra todos os níveis relevantes)
- codigo · string · optionnel
  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: "01.11" (cultivo de cereais) - Subclasse: "0111-3/01" (cultivo de arroz)
- limite · number · optionnel
  Número máximo de resultados (padrão: 20)
Exemple d'appel
```
{"name": "ibge_cnae", "arguments": {"busca": "texte", "nivel": "secoes", "codigo": "texte", "limite": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"modo": "busca", "busca": {}, "lista": {}, "codigo": {}, "provenance": {}, "attribution": []}}
```
ibge_comparar≈ 2383 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- formato · string · optionnel · tabela | json | ranking
  Formato de saída: tabela, json ou ranking (ordenado)
- indicador · string · optionnel · populacao | populacao_censo | pib | area | densidade | alfabetizacao | domicilios | listar
  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: Densidade demográfica (hab/km²) - alfabetizacao: Taxa de alfabetização - domicilios: Número de domicílios - listar: Lista indicadores disponíveis
- localidades · string · requis
  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.
Exemple d'appel
```
{"name": "ibge_comparar", "arguments": {"localidades": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "tabela": "texte", "formato": "texte", "unidades": [], "indicador": "texte", "provenance": {}, "attribution": [], "localidades": [], "estatisticas": {}}}
```
ibge_datasaude≈ 3533 tokens
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.
Paramètres, retour & exemple (9)
Paramètres
- topN · integer · optionnel
  Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)
- campos · string · optionnel
  Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.
- formato · string · optionnel · tabela | json
  Formato de saída
- periodo · string · optionnel
  Período: 'last', 'all', ou ano específico
- indicador · string · requis
  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 residência - fecundidade: Taxa de fecundidade - saneamento_agua: Abastecimento de água - saneamento_esgoto: Esgotamento sanitário - plano_saude: Cobertura de plano de saúde - listar: Lista indicadores disponíveis
- agruparPor · string · optionnel
  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ção. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido
- localidade · string · optionnel
  Código da localidade ou 'all'
- estatisticas · boolean · optionnel
  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', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato
- nivel_territorial · string · optionnel
  Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município
Exemple d'appel
```
{"name": "ibge_datasaude", "arguments": {"indicador": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "fonte": "texte", "colunas": [], "unidades": [], "indicador": "texte", "registros": [], "provenance": {}, "attribution": [], "estatisticas": {}, "totalRegistros": 1}}
```
ibge_estados≈ 1731 tokens
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.
Paramètres, retour & exemple (2)
Paramètres
- regiao · string · optionnel · N | NE | SE | S | CO
  Filtrar por região: N (Norte), NE (Nordeste), SE (Sudeste), S (Sul), CO (Centro-Oeste)
- ordenar · string · optionnel · id | nome | sigla
  Campo para ordenação dos resultados
Exemple d'appel
```
{"name": "ibge_estados", "arguments": {"regiao": "N", "ordenar": "id"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"total": 1, "estados": [], "provenance": {}, "attribution": []}}
```
ibge_geocodigo≈ 2278 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- uf · string · optionnel
  Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) para restringir a busca por nome de município
- nome · string · optionnel
  Nome da localidade para encontrar o código IBGE (estado ou município)
- codigo · string · optionnel
  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
Exemple d'appel
```
{"name": "ibge_geocodigo", "arguments": {"uf": "texte", "nome": "texte", "codigo": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "tipo": "regiao", "sigla": "texte", "total": 1, "codigo": 1, "regiao": "texte", "estados": [], "matches": [], "hierarquia": [], "provenance": {}, "attribution": [], "codigoSidra": "texte"}}
```
ibge_indicadores≈ 3788 tokens
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 GDP per capita at current prices, R$ (Brazil only) - industria: industrial production index, general industry (2022=100) - comercio: retail sales volume index (2022=100) - servicos: services volume index (2022=100, Brazil only) **Prices:** - ipca: IPCA monthly change, % - ipca_acumulado: IPCA accumulated over 12 months, % - inpc: INPC monthly change, % **Labor:** - desemprego: Unemployment rate - ocupacao: Employed people (thousands) - rendimento: average real income from all jobs, R$ — each period is a ROLLING quarter (e.g. "jun-jul-ago 2026"), Brazil only - 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" Each indicator returns ONE variable — the one its name says; for another one of the same table (e.g. the year-to-date change) use ibge_sidra with variaveis. What each number is: every record carries the SIDRA period column (code and label, e.g. "Mês (Código)" 202403 / "Mês" "março 2024") and the "Variável" label — the only place that says whether a value is a monthly change, a year-to-date or 12-month accumulation, an index number or a level; read it before adding, subtracting or comparing values. A PNAD rolling quarter ("jun-jul-ago 2026") is a three-month window that moves every month, not a calendar quarter. Revisions: values are what SIDRA publishes at the extraction instant (retrieved_at); IBGE revises published figures (quarterly GDP at each release, PNAD reweighting, annual revisions of PIM/PMC/PMS) and the API keeps no earlier version. Statistics mode: for largest/smallest/mean/median/distribution/ranking questions ("which state has the highest unemployment?", "median informality rate 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.
Paramètres, retour & exemple (10)
Paramètres
- topN · integer · optionnel
  Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)
- campos · string · optionnel
  Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta.
- formato · string · optionnel · tabela | json
  Formato de saída
- periodos · string · optionnel
  Períodos (ex: '2023', 'last', 'last 4')
- categoria · string · optionnel · economico | precos | trabalho | populacao | agropecuaria | todos
  Filtrar por categoria de indicadores
- indicador · string · optionnel
  Nome do indicador (ex: "pib", "ipca", "desemprego", "populacao"). Use "listar" para ver todos os indicadores disponíveis.
- agruparPor · string · optionnel
  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ção. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido
- localidades · string · optionnel
  Códigos das localidades ou 'all'
- estatisticas · boolean · optionnel
  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', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato
- nivel_territorial · string · optionnel
  Nível territorial (código N): 1=Brasil, 2=Região, 3=UF
Exemple d'appel
```
{"name": "ibge_indicadores", "arguments": {"topN": 1, "campos": "texte", "formato": "tabela", "periodos": "texte", "categoria": "economico", "indicador": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "tabela": "texte", "colunas": [], "unidades": [], "indicador": "texte", "registros": [], "provenance": {}, "attribution": [], "estatisticas": {}, "totalRegistros": 1}}
```
ibge_localidade≈ 2296 tokens
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.
Paramètres, retour & exemple (2)
Paramètres
- tipo · string · optionnel · estado | municipio | distrito
  Tipo da localidade. Se não informado, será inferido pelo tamanho do código.
- codigo · number · requis
  Código IBGE da localidade (estado: 2 dígitos, município: 7 dígitos, distrito: 9 dígitos)
Exemple d'appel
```
{"name": "ibge_localidade", "arguments": {"codigo": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": 1, "nome": "texte", "tipo": "estado", "sigla": "texte", "estado": {}, "regiao": {}, "municipio": {}, "provenance": {}, "attribution": [], "mesorregiao": {}, "microrregiao": {}, "regiaoImediata": {}}}
```
ibge_malhas≈ 2168 tokens
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).
Paramètres, retour & exemple (6)
Paramètres
- tipo · string · optionnel · paises | regioes | estados | mesorregioes | microrregioes | municipios | regioes-imediatas | regioes-intermediarias
  Tipo de divisão territorial
- formato · string · optionnel · geojson | topojson | svg
  Formato de saída (padrão: geojson)
- qualidade · string · optionnel · 1 | 2 | 3 | 4 | minima | intermediaria | maxima
  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 · optionnel · 0 | 1 | 2 | 3 | 4 | 5
  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 = Mesorregiões 4 = Microrregiões 5 = Municípios Cada nível aceita só as divisões menores que ele: município aceita nenhuma, UF aceita 3, 4 e 5.
- localidade · string · requis
  Código IBGE ou sigla da localidade (ex: 'BR', 'SP', '35', '3550308')
- intrarregiao · string · optionnel
  Divisão interna pelo nome, alternativa a resolucao: 'regiao', 'UF', 'regiao-intermediaria', 'regiao-imediata', 'mesorregiao', 'microrregiao' ou 'municipio'. Quando informado, prevalece sobre resolucao.
Exemple d'appel
```
{"name": "ibge_malhas", "arguments": {"localidade": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"url": "texte", "tipo": "texte", "formato": "texte", "qualidade": "texte", "resolucao": "texte", "localidade": "texte", "provenance": {}, "attribution": [], "intrarregiao": "texte"}}
```
ibge_malhas_tema≈ 2278 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- tema · string · requis · biomas | amazonia_legal | semiarido | costeiro | fronteira | metropolitana | ride | listar
  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: municípios da faixa de fronteira - metropolitana: regiões metropolitanas - ride: Regiões Integradas de Desenvolvimento - listar: lista os recortes disponíveis, sem consultar a fonte
- codigo · string · optionnel
  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 é recusada com a lista do que aceita.
- limite · integer · optionnel
  Quantas feições trazer (padrão 50, máx. 600). O total do recorte vem sempre, mesmo quando o limite corta a lista.
Exemple d'appel
```
{"name": "ibge_malhas_tema", "arguments": {"tema": "biomas"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tema": "texte", "temas": [], "camada": "texte", "codigo": "texte", "feicoes": 1, "registros": [], "provenance": {}, "attribution": [], "url_geometria": "texte", "feicoes_retornadas": 1}}
```
ibge_municipios≈ 1823 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- uf · string · optionnel
  Estado por sigla (SP), nome (São Paulo) ou código IBGE (35). Se não informado, retorna todos os municípios do Brasil.
- busca · string · optionnel
  Termo para buscar no nome do município
- limite · number · optionnel
  Número máximo de resultados (padrão: 100, máximo: 5570)
Exemple d'appel
```
{"name": "ibge_municipios", "arguments": {"uf": "texte", "busca": "texte", "limite": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"uf": "texte", "busca": "texte", "total": 1, "municipios": [], "provenance": {}, "attribution": []}}
```
ibge_nomes≈ 2238 tokens
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.
Paramètres, retour & exemple (6)
Paramètres
- sexo · string · optionnel · M | F
  Filtrar por sexo: M (masculino) ou F (feminino)
- tipo · string · requis · frequencia | ranking
  Tipo de consulta: 'frequencia' para buscar nomes específicos ou 'ranking' para ver os mais populares
- nomes · string · optionnel
  Para tipo='frequencia': Nome ou nomes separados por vírgula
- decada · number · optionnel
  Para tipo='ranking': Década do ranking (ex: 1990, 2000, 2010)
- limite · number · optionnel
  Para tipo='ranking': Número de nomes (padrão: 20)
- localidade · string · optionnel
  Código IBGE da localidade (UF: 2 dígitos, Município: 7 dígitos)
Exemple d'appel
```
{"name": "ibge_nomes", "arguments": {"tipo": "frequencia"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tipo": "frequencia", "ranking": {}, "frequencia": [], "provenance": {}, "attribution": []}}
```
ibge_noticias≈ 2220 tokens
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.
Paramètres, retour & exemple (7)
Paramètres
- de · string · optionnel
  Data inicial no formato DD/MM/AAAA (ex: 01/01/2024)
- ate · string · optionnel
  Data final no formato DD/MM/AAAA (ex: 31/12/2024)
- tipo · string · optionnel · release | noticia
  Tipo de publicação: 'release' ou 'noticia'
- busca · string · optionnel
  Termo para buscar nas notícias
- pagina · number · optionnel
  Número da página para paginação
- destaque · boolean · optionnel
  Filtrar apenas notícias em destaque
- quantidade · number · optionnel
  Quantidade de notícias a retornar (padrão: 10, máximo: 100)
Exemple d'appel
```
{"name": "ibge_noticias", "arguments": {"de": "texte", "ate": "texte", "tipo": "release", "busca": "texte", "pagina": 1, "destaque": true}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"busca": "texte", "total": 1, "pagina": 1, "noticias": [], "provenance": {}, "attribution": [], "totalPaginas": 1}}
```
ibge_paises≈ 3046 tokens
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 expectancy - Pick other indicators with indicadores="<ids or aliases separated by |>" - Indicator catalog as published by IBGE (34 indicators: economy, population, health, environment, networks), with unit and scale - Search countries by name - Filter by region/continent Each indicator value is the most recent one the source publishes for that country, with its year or period (some are 3- or 5-year ranges like "2021-2023"), as text (it can be "<2.5"), plus unit and scale (multiplicador) — null when the source has none. 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" - Chosen indicators: tipo="detalhes", pais="AR", indicadores="idh|77852" - Search: tipo="buscar", busca="Argentina" - Americas countries: tipo="listar", regiao="americas" - Indicator catalog: tipo="indicadores" Behavior: read-only and idempotent — a live GET against the public IBGE Países API. Returns Markdown.
Paramètres, retour & exemple (5)
Paramètres
- pais · string · optionnel
  Código ISO-ALPHA-2 do país (ex: BR, US, AR) ou código M49
- tipo · string · optionnel · listar | detalhes | indicadores | buscar
  Tipo de consulta: listar (todos), detalhes (de um país), indicadores, buscar
- busca · string · optionnel
  Termo de busca para filtrar países pelo nome
- regiao · string · optionnel
  Filtrar por região/continente: americas, europa, africa, asia, oceania
- indicadores · string · optionnel
  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, IDH e esperança de vida
Exemple d'appel
```
{"name": "ibge_paises", "arguments": {"pais": "texte", "tipo": "listar", "busca": "texte", "regiao": "texte", "indicadores": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"pais": {}, "tipo": "listar", "busca": "texte", "total": 1, "paises": [], "regiao": "texte", "provenance": {}, "attribution": [], "indicadores": []}}
```
ibge_pesquisas≈ 2021 tokens
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.
Paramètres, retour & exemple (2)
Paramètres
- busca · string · optionnel
  Termo para buscar no nome ou ID da pesquisa
- detalhes · string · optionnel
  Código da pesquisa para ver detalhes e tabelas disponíveis
Exemple d'appel
```
{"name": "ibge_pesquisas", "arguments": {"busca": "texte", "detalhes": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"modo": "lista", "busca": "texte", "total": 1, "pesquisa": {}, "pesquisas": [], "provenance": {}, "attribution": []}}
```
ibge_sidra≈ 4170 tokens
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) - 1846: Quarterly GDP at current prices (Brazil) - 5938: Municipal GDP at current prices (annual, down to municipality) - 6784: Annual GDP and GDP per capita (Brazil) 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" What each number is: every record carries the SIDRA period column (code and label, e.g. "Mês (Código)" 202403 / "Mês" "março 2024") and the "Variável" label — the only place that says whether a value is a monthly change, a year-to-date or 12-month accumulation, an index number or a level; read it before adding, subtracting or comparing values. A PNAD rolling quarter ("jun-jul-ago 2026") is a three-month window that moves every month, not a calendar quarter. Revisions: values are what SIDRA publishes at the extraction instant (retrieved_at); IBGE revises published figures (quarterly GDP at each release, PNAD reweighting, annual revisions of PIM/PMC/PMS) and the API keeps no earlier version. 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) → 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.
Paramètres, retour & exemple (12)
Paramètres
- topN · integer · optionnel
  Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)
- campos · string · optionnel
  Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. Omitir traz todas.
- pagina · integer · optionnel
  Página de resultados (100 registros por página)
- tabela · string · requis
  Código da tabela SIDRA (ex: 6579 para estimativas de população, 9514 para censo 2022)
- formato · string · optionnel · json | tabela
  Formato de saída: 'json' para dados brutos ou 'tabela' para formato legível
- periodos · string · optionnel
  Períodos: 'last' para último, 'all' para todos, ou anos específicos (ex: 2020,2021,2022)
- variaveis · string · optionnel
  IDs das variáveis separados por vírgula, ou 'allxp' para todas
- agruparPor · string · optionnel
  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ção. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido
- localidades · string · optionnel
  Códigos das localidades separados por vírgula, ou 'all' para todas
- estatisticas · boolean · optionnel
  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', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato
- classificacoes · string · optionnel
  Classificações no formato 'id[categorias]' (ex: '2[6794]' para sexo masculino)
- nivel_territorial · string · optionnel
  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=Região Geográfica Imediata, 18=Região Geográfica Intermediária, 105=Macrorregião de Saúde, 106=Região de Saúde, 114=Aglomerado Subnormal, 127=Amazônia Legal, 128=Semiárido
Exemple d'appel
```
{"name": "ibge_sidra", "arguments": {"tabela": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"nome": "texte", "tabela": "texte", "colunas": [], "unidades": [], "paginacao": {}, "registros": [], "provenance": {}, "attribution": [], "estatisticas": {}, "totalRegistros": 1}}
```
ibge_sidra_metadados≈ 2325 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- tabela · string · requis
  Código da tabela/agregado SIDRA (ex: '6579', '9514', '4714')
- incluir_periodos · boolean · optionnel
  Incluir lista de períodos disponíveis (padrão: true)
- incluir_localidades · boolean · optionnel
  Incluir níveis territoriais disponíveis (padrão: false)
Exemple d'appel
```
{"name": "ibge_sidra_metadados", "arguments": {"tabela": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"url": "texte", "nome": "texte", "codigo": "texte", "assunto": "texte", "periodos": [], "pesquisa": "texte", "variaveis": [], "provenance": {}, "attribution": [], "periodicidade": {}, "niveisTerritoriais": []}}
```
ibge_sidra_tabelas≈ 1997 tokens
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.
Paramètres, retour & exemple (3)
Paramètres
- busca · string · optionnel
  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, cidade→município)
- limite · number · optionnel
  Número máximo de resultados (padrão: 20)
- pesquisa · string · optionnel
  Filtrar por código ou nome da pesquisa (ex: 'censo', 'pnad', 'pib')
Exemple d'appel
```
{"name": "ibge_sidra_tabelas", "arguments": {"busca": "texte", "limite": 1, "pesquisa": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"busca": "texte", "total": 1, "tabelas": [], "pesquisa": "texte", "provenance": {}, "attribution": [], "notas_vocabulario": []}}
```
ibge_vizinhos≈ 1939 tokens
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.
Paramètres, retour & exemple (4)
Paramètres
- uf · string · optionnel
  Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) — obrigatório se usar nome do município
- raio · number · optionnel
  Raio em km para buscar municípios próximos (usa centróides)
- municipio · string · requis
  Código IBGE do município (7 dígitos) ou nome do município
- incluir_dados · boolean · optionnel
  Incluir dados populacionais dos vizinhos
Exemple d'appel
```
{"name": "ibge_vizinhos", "arguments": {"municipio": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"total": 1, "vizinhos": [], "municipio": {}, "provenance": {}, "attribution": []}}
```
search≈ 1777 tokens
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.
Paramètres, retour & exemple (1)
Paramètres
- query · string · requis
  Termos de busca em linguagem natural ou palavras-chave (acentos e caixa são ignorados)
Exemple d'appel
```
{"name": "search", "arguments": {"query": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}], "structuredContent": {"results": [], "provenance": {}, "attribution": []}}
```

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://ibge.sidneybissoli.com/mcp