{"report":{"v":1,"package":"ibge-br-mcp","version":"5.11.0","ranAt":"2026-11-16T11:39:22.691Z","install":{"ok":true,"integrity":"sha512-invQrW/wngat5NISMwiwHktvcRE4cRbPGtZtwVyvdXThqQ5wwTggc2C5vjCWLfmZoUwHSaG5ZJgJTRUqEUAw4g==","deps":7,"scripts":[],"bins":["ibge-br-mcp"],"license":"MIT","engines":"node >=22","repository":"git+https://github.com/SidneyBissoli/ibge-br-mcp.git","bin":"ibge-br-mcp"},"start":{"ok":true,"ms":191,"serverName":"ibge-br-mcp","serverVersion":"5.11.0","protocol":"2025-06-18","stderr":"ibge-br-mcp v5.11.0 started\n"},"tools":[{"name":"ibge_estados","description":"Lists all Brazilian states from IBGE.\n\nFeatures:\n- Lists all 27 states (26 states + Federal District)\n- Filter by region (North, Northeast, Southeast, South, Central-West)\n- Sort by ID, name, or abbreviation\n\nExamples:\n- List all states: (no parameters)\n- Northeast states: regiao=\"NE\"\n- Sorted by abbreviation: ordenar=\"sigla\"\n\nUse a different tool when:\n- Municipalities of a state → ibge_municipios\n- Details/hierarchy of one locality by code → ibge_localidade\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.","params":["regiao","ordenar"]},{"name":"ibge_municipios","description":"Lists Brazilian municipalities from IBGE.\n\nFeatures:\n- List municipalities by state (using state abbreviation)\n- List all municipalities in Brazil (5,570 municipalities)\n- Search by municipality name\n- Returns 7-digit IBGE code\n\nExamples:\n- São Paulo municipalities: uf=\"SP\"\n- Search by name: busca=\"Campinas\"\n- MG municipalities containing \"Belo\": uf=\"MG\", busca=\"Belo\"\n\nUse a different tool when:\n- Resolve/decode a code at any level (region, state, district), not just municipalities → ibge_geocodigo\n- Full details/hierarchy of one locality by code → ibge_localidade\n- Neighboring municipalities → ibge_vizinhos\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.","params":["uf","busca","limite"]},{"name":"ibge_localidade","description":"Returns details of a specific locality by IBGE code.\n\nFeatures:\n- State information (2-digit code)\n- Municipality information (7-digit code)\n- District information (9-digit code)\n- Complete hierarchy (region, mesoregion, microregion)\n\nExamples:\n- São Paulo state: codigo=35\n- São Paulo city: codigo=3550308\n- District: codigo=355030805\n\nThis tool returns the full record of ONE locality you already have the code for.\nUse a different tool when:\n- You have a name and need the code → ibge_municipios (municipalities) or ibge_geocodigo (any level)\n- You want to decompose/understand a code's structure → ibge_geocodigo\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown record.","params":["codigo","tipo"]},{"name":"ibge_sidra","description":"Queries SIDRA tables (IBGE's Automatic Recovery System).\n\nSIDRA contains data from IBGE surveys like Census, PNAD, GDP, etc.\n\nCommon tables:\n- 6579: Population estimates (annual)\n- 9514: Census 2022 population\n- 200: Census population (1970-2010)\n- 4714: Population, territorial area and density (Census 2022)\n- 4099: Unemployment rate (PNAD Contínua, quarterly)\n- 5436: Average real income (PNAD Contínua, quarterly)\n- 1846: Quarterly GDP at current prices (Brazil)\n- 5938: Municipal GDP at current prices (annual, down to municipality)\n- 6784: Annual GDP and GDP per capita (Brazil)\n\nTerritorial levels:\n- 1: Brazil\n- 2: Region (North, Northeast, etc.)\n- 3: State (UF)\n- 6: Municipality\n- 7: Metropolitan Region\n\nExamples:\n- Brazil population 2023: tabela=\"6579\", periodos=\"2023\"\n- Population by state: tabela=\"6579\", nivel_territorial=\"3\"\n- Census 2022 by municipality: tabela=\"9514\", nivel_territorial=\"6\", localidades=\"3550308\"\n\nWhat 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.\n\nStatistics 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.\n\nibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits:\n- Census themes (1970–2022) → ibge_censo\n- Economic/social time series → ibge_indicadores\n- Rank/compare 2–10 localities → ibge_comparar\n- One municipality's panel → ibge_cidades\nUse ibge_sidra_tabelas and ibge_sidra_","params":["tabela","variaveis","nivel_territorial","localidades","periodos","classificacoes","formato","pagina","campos","estatisticas","agruparPor","topN"]},{"name":"ibge_nomes","description":"Queries name frequency and rankings in Brazil (IBGE).\n\nFeatures:\n1. **Name frequency** (tipo='frequencia'):\n   - Birth frequency by decade\n   - Multiple names separated by comma\n   - Filter by sex and locality\n\n2. **Name ranking** (tipo='ranking'):\n   - Most popular names\n   - Filter by decade, sex, and locality\n\nAvailable decades: 1930-2010\n\nExamples:\n- Frequency of \"Maria\": tipo=\"frequencia\", nomes=\"Maria\"\n- Compare names: tipo=\"frequencia\", nomes=\"João,José,Pedro\"\n- 2000s ranking: tipo=\"ranking\", decada=2000\n- Female names: tipo=\"ranking\", sexo=\"F\"\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Nomes (Censo) API. Returns a Markdown table.","params":["tipo","nomes","decada","sexo","localidade","limite"]},{"name":"ibge_noticias","description":"Searches and lists already-published IBGE news articles and press releases.\n\nUse 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.\n\nParameters:\n- busca: free-text term to match (e.g. \"PIB\", \"censo\")\n- tipo: \"release\" (official publication of survey results) or \"noticia\" (general news); omit for both\n- de / ate: date range, format DD/MM/AAAA (e.g. de=\"01/01/2024\", ate=\"31/12/2024\")\n- destaque: true to return only featured items\n- quantidade: how many to return (default 10, max 100); pagina: page number to page through more\n\nEach 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.\n\nExamples:\n- Latest 10 news: (no parameters)\n- Search census: busca=\"censo\"\n- 2024 news: de=\"01/01/2024\", ate=\"31/12/2024\"\n- Releases only: tipo=\"release\"\n\nUse a different tool when:\n- Scheduled/upcoming release dates (not yet published) → ibge_calendario\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Notícias API. Returns a Markdown list.","params":["busca","quantidade","pagina","de","ate","tipo","destaque"]},{"name":"ibge_sidra_tabelas","description":"Lists and searches available SIDRA tables.\n\nFeatures:\n- List all SIDRA tables (aggregates)\n- 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\n- Filter by survey (Census, PNAD, GDP, etc.)\n- Shows code and name of each table\n\nSIDRA contains data from various surveys:\n- Demographic Census\n- PNAD Contínua (employment, income)\n- National Accounts (GDP)\n- Industrial Survey\n- Agricultural Survey\n\nExamples:\n- List tables: (no parameters)\n- Search population tables: busca=\"população\"\n- Census tables: pesquisa=\"censo\"\n\nThis is step 1 of the SIDRA workflow: find a table code → ibge_sidra_metadados (structure) → ibge_sidra (query).\nFor common data, a wrapper is usually easier: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades.\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns a Markdown table.","params":["busca","pesquisa","limite"]},{"name":"ibge_sidra_metadados","description":"Returns metadata for a specific SIDRA table.\n\nFeatures:\n- General info (name, survey, subject, periodicity)\n- Available territorial levels\n- Variable list with units\n- Classifications and categories\n- Available periods\n\nUse this tool to understand table structure BEFORE querying data with ibge_sidra.\n\nExamples:\n- Population table metadata: tabela=\"6579\"\n- Census 2022 metadata: tabela=\"9514\"\n- PNAD unemployment: tabela=\"4714\"\n\nUse this after finding a table code (ibge_sidra_tabelas) and before querying with ibge_sidra.\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown.","params":["tabela","incluir_periodos","incluir_localidades"]},{"name":"ibge_malhas","description":"Gets geographic meshes (maps) from IBGE in GeoJSON, TopoJSON, or SVG format.\n\nFeatures:\n- Meshes for Brazil, regions, states, municipalities\n- Different resolution levels (internal divisions)\n- Different quality levels\n- Formats: GeoJSON (data), TopoJSON (compact), SVG (image)\n\nLocality types:\n- \"BR\" or \"1\" = Entire Brazil\n- State abbreviation (e.g., \"SP\", \"RJ\")\n- State code (e.g., \"35\" for SP)\n- Municipality code (7 digits)\n\nResolution (internal divisions):\n- 0 = Outline only\n- 2 = States\n- 5 = Municipalities\n\nExamples:\n- Brazil with states: localidade=\"BR\", resolucao=\"2\"\n- São Paulo with municipalities: localidade=\"SP\", resolucao=\"5\"\n- SVG format: localidade=\"BR\", formato=\"svg\"\n\nUse a different tool when:\n- Thematic meshes (biomes, Legal Amazon, semi-arid, metropolitan regions) → ibge_malhas_tema\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Malhas API. Returns the mesh in the requested format (GeoJSON, TopoJSON, or SVG).","params":["localidade","tipo","formato","resolucao","qualidade","intrarregiao"]},{"name":"ibge_pesquisas","description":"Lists available IBGE surveys and their tables.\n\nFeatures:\n- List all IBGE surveys (Census, PNAD, GDP, etc.)\n- Search by name or code\n- Show details and tables of a specific survey\n- Categorize surveys by theme\n\nMain surveys:\n- **Census**: Demographic, Agricultural, MUNIC\n- **PNAD Contínua**: Employment, income, education\n- **National Accounts**: GDP, investments\n- **Economic Surveys**: Industry, Commerce, Services\n- **Price Indices**: IPCA, INPC\n\nExamples:\n- List all: (no parameters)\n- Search population: busca=\"população\"\n- PNAD details: detalhes=\"pnad\"\n\nThis 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).\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA/Pesquisas API. Returns a Markdown list.","params":["busca","detalhes"]},{"name":"ibge_censo","description":"Queries IBGE Demographic Census data (1970-2022).\n\nSimplified tool to access census data without knowing SIDRA table codes.\n\nAvailable years: 1970, 1980, 1991, 2000, 2010, 2022\n\nAvailable themes:\n- populacao: Resident population\n- alfabetizacao: Literacy rate\n- domicilios: Housing characteristics\n- idade_sexo: Age pyramid\n- religiao: Religion distribution\n- cor_raca: Race/color\n- rendimento: Monthly income\n- educacao: Education level\n- trabalho: Employment\n\nExamples:\n- Population 2022: ano=\"2022\", tema=\"populacao\"\n- Historical series: ano=\"todos\", tema=\"populacao\"\n- Literacy 2010 by state: ano=\"2010\", tema=\"alfabetizacao\", nivel_territorial=\"3\"\n- List tables: tema=\"listar\"\n\nStatistics 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.\n\nUse a different tool when:\n- One municipality's current panel (estimate, HDI, GDP) → ibge_cidades\n- Comparing/ranking localities → ibge_comparar\n- An arbitrary SIDRA table → ibge_sidra\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.","params":["ano","tema","nivel_territorial","localidades","formato","campos","estatisticas","agruparPor","topN"]},{"name":"ibge_indicadores","description":"Queries IBGE economic and social indicators.\n\nAvailable indicators:\n\n**Economic:**\n- pib: quarterly GDP at current prices, R$ million (Brazil only)\n- pib_variacao: quarterly GDP volume change, % over the same quarter of the previous year (Brazil only)\n- pib_per_capita: annual GDP per capita at current prices, R$ (Brazil only)\n- industria: industrial production index, general industry (2022=100)\n- comercio: retail sales volume index (2022=100)\n- servicos: services volume index (2022=100, Brazil only)\n\n**Prices:**\n- ipca: IPCA monthly change, %\n- ipca_acumulado: IPCA accumulated over 12 months, %\n- inpc: INPC monthly change, %\n\n**Labor:**\n- desemprego: Unemployment rate\n- ocupacao: Employed people (thousands)\n- rendimento: average real income from all jobs, R$ — each period is a ROLLING quarter (e.g. \"jun-jul-ago 2026\"), Brazil only\n- informalidade: Informality rate\n\n**Population:**\n- populacao: Population estimate\n- densidade: Population density\n\nExamples:\n- GDP: indicador=\"pib\"\n- IPCA last 12 months: indicador=\"ipca\", periodos=\"last 12\"\n- Unemployment by state: indicador=\"desemprego\", nivel_territorial=\"3\"\n- List indicators: indicador=\"listar\"\n\nEach 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.\n\nWhat 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.\n\nStatistics 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.\n\nUse a different tool when:\n- Comparing/ranking localities → ibge_comparar\n- Census themes → ibge_censo\n- One municipality's panel → ibge_cidades\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.","params":["indicador","categoria","nivel_territorial","localidades","periodos","formato","campos","estatisticas","agruparPor","topN"]},{"name":"ibge_cnae","description":"Queries CNAE (National Classification of Economic Activities) from IBGE.\n\nCNAE is the official classification for economic activities in Brazil.\n\nHierarchical structure:\n- Section (letter A-U): 21 main categories\n- Division (2 digits): 87 divisions\n- Group (3 digits): 285 groups\n- Class (4-5 digits): 673 classes\n- Subclass (7 digits): 1,332 subclasses\n\nFeatures:\n- Search by CNAE code\n- Search by activity description\n- List by hierarchical level\n- Show complete hierarchy\n\nExamples:\n- Search software: busca=\"software\"\n- Specific code: codigo=\"6201-5/01\"\n- View section: codigo=\"J\"\n- List divisions: nivel=\"divisoes\"\n\nBehavior: read-only and idempotent — a live GET against the public IBGE CNAE API. Returns Markdown.","params":["codigo","busca","nivel","limite"]},{"name":"ibge_geocodigo","description":"Decodes IBGE codes or searches codes by locality name.\n\nFeatures:\n- Decode region, state, municipality, or district codes\n- Search IBGE code by name\n- Show complete geographic hierarchy\n- Return related codes\n\nCode structure:\n- 1 digit: Region (1=North, 2=Northeast, 3=Southeast, 4=South, 5=Central-West)\n- 2 digits: State (11-53)\n- 7 digits: Municipality\n- 9 digits: District\n\nExamples:\n- Decode municipality: codigo=\"3550308\"\n- Decode state: codigo=\"35\"\n- Search by name: nome=\"São Paulo\"\n- Municipality in state: nome=\"Campinas\", uf=\"SP\"\n\nThis tool decodes a code's structure and resolves name→code at any level.\nUse a different tool when:\n- You only need to list/search municipalities → ibge_municipios\n- You want the full detailed record of one locality → ibge_localidade\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns Markdown.","params":["codigo","nome","uf"]},{"name":"ibge_calendario","description":"Queries IBGE release and collection calendar.\n\nFeatures:\n- List upcoming survey releases\n- Filter by product (IPCA, PNAD, GDP, etc.)\n- Filter by period\n- Distinguish releases from field collections\n\nEvent types:\n- **Release**: Publication of survey results\n- **Collection**: Field research period\n\nExamples:\n- Upcoming releases: (no parameters)\n- IPCA releases: produto=\"IPCA\"\n- 2024 calendar: de=\"01/01/2024\", ate=\"31/12/2024\"\n- Field collections: tipo=\"coleta\"\n\nUse a different tool when:\n- Already-published news and releases → ibge_noticias\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Calendário API. Returns a Markdown list.","params":["de","ate","produto","tipo","pagina","quantidade"]},{"name":"ibge_comparar","description":"Compares data between localities (municipalities or states).\n\nAvailable indicators:\n- populacao: Current population estimate\n- populacao_censo: Census 2022 population\n- pib: GDP per capita\n- area: Territorial area (km²)\n- densidade: Population density (inhab/km²)\n- alfabetizacao: Literacy rate\n- domicilios: Number of households\n\nFeatures:\n- Compare up to 10 localities at once\n- Calculate statistics (max, min, average, variation)\n- Generate ranked output\n- Accept municipality codes (7 digits) or state codes (2 digits)\n\nExamples:\n- Compare capitals: localidades=\"3550308,3304557,4106902\", indicador=\"populacao\"\n- Compare states: localidades=\"35,33,41\", indicador=\"pib\"\n- Area ranking: localidades=\"3550308,3304557\", formato=\"ranking\"\n- List indicators: indicador=\"listar\"\n\nUse this tool ONLY to rank/compare 2–10 localities on one indicator.\nFor a single locality, use ibge_cidades (municipal panel), ibge_censo, or ibge_sidra.\n\nBehavior: read-only and idempotent — a live GET against the public IBGE APIs (SIDRA and Localidades). Returns Markdown plus a typed structuredContent payload.","params":["localidades","indicador","formato"]},{"name":"ibge_malhas_tema","description":"Lists what a THEMATIC territorial recorte of Brazil contains: how many features, with which codes and names, and the URL to download its geometry.\n\nAvailable recortes:\n- biomas: the six continental biomes\n- amazonia_legal: Legal Amazon boundary\n- semiarido: semi-arid area\n- costeiro: coastal municipalities\n- fronteira: border-strip municipalities\n- metropolitana: metropolitan regions\n- ride: Integrated Development Regions\n- listar: the catalogue itself, without querying the source\n\nFiltering 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.\n\nGEOMETRY 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.\n\nUse a different tool when:\n- Administrative meshes WITH geometry (country/region/state/municipality outlines) → ibge_malhas\n\nBehavior: 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.","params":["tema","codigo","limite"]},{"name":"ibge_vizinhos","description":"Finds nearby/neighboring municipalities.\n\nFeatures:\n- Search by IBGE code (7 digits) or municipality name\n- Returns municipalities in the same mesoregion (proximity approximation)\n- Optionally includes population data\n\nNote: Uses mesoregion as geographic proximity proxy.\nFor exact spatial neighborhood, mesh processing would be required.\n\nExamples:\n- By code: municipio=\"3550308\"\n- By name: municipio=\"Campinas\", uf=\"SP\"\n- With population: municipio=\"3550308\", incluir_dados=true\n\nNote: proximity is approximated by shared mesoregion (not exact spatial adjacency).\nFor listing/searching municipalities, use ibge_municipios.\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown list.","params":["municipio","uf","raio","incluir_dados"]},{"name":"ibge_datasaude","description":"Queries Brazil health indicators, served through IBGE's SIDRA (some originally produced by DataSUS, e.g. mortality and births).\n\nMortality and Birth:\n- mortalidade_infantil: Infant mortality rate\n- nascidos_vivos: Live births by location\n- obitos: Deaths by residence\n\nDemographic Indicators:\n- esperanca_vida: Life expectancy at birth\n- fecundidade: Fertility rate\n\nSanitation:\n- saneamento_agua: Water supply\n- saneamento_esgoto: Sewage system\n\nHealth Coverage:\n- plano_saude: Health insurance coverage\n- autoavaliacao_saude: Self-rated health status\n\nTerritorial levels: 1=Brazil, 2=Region, 3=State, 6=Municipality\n\nExamples:\n- Infant mortality: indicador=\"mortalidade_infantil\"\n- Life expectancy by state: indicador=\"esperanca_vida\", nivel_territorial=\"3\"\n- Deaths in SP: indicador=\"obitos\", nivel_territorial=\"3\", localidade=\"35\"\n- List indicators: indicador=\"listar\"\n\nStatistics 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.\n\nUse a different tool when:\n- A single municipality's general panel (which also includes infant mortality) → ibge_cidades\n- Population/demographic counts (not health-specific) → ibge_censo or ibge_sidra\n\nBehavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.","params":["indicador","nivel_territorial","localidade","periodo","formato","campos","estatisticas","agruparPor","topN"]},{"name":"ibge_paises","description":"Queries international country data via IBGE.\n\nFeatures:\n- List all countries (following UN M49 methodology)\n- Country details (area, languages, currency, location) with the latest published value of\n  country indicators — by default population, GDP, GDP per capita, HDI and life expectancy\n- Pick other indicators with indicadores=\"<ids or aliases separated by |>\"\n- Indicator catalog as published by IBGE (34 indicators: economy, population, health,\n  environment, networks), with unit and scale\n- Search countries by name\n- Filter by region/continent\n\nEach indicator value is the most recent one the source publishes for that country, with its year\nor period (some are 3- or 5-year ranges like \"2021-2023\"), as text (it can be \"<2.5\"), plus unit\nand scale (multiplicador) — null when the source has none.\n\nAvailable regions: americas, europa, africa, asia, oceania\n\nCountry codes: Use ISO-ALPHA-2 (e.g., BR, US, AR, PT, JP)\n\nExamples:\n- List all: tipo=\"listar\"\n- Brazil details: tipo=\"detalhes\", pais=\"BR\"\n- Chosen indicators: tipo=\"detalhes\", pais=\"AR\", indicadores=\"idh|77852\"\n- Search: tipo=\"buscar\", busca=\"Argentina\"\n- Americas countries: tipo=\"listar\", regiao=\"americas\"\n- Indicator catalog: tipo=\"indicadores\"\n\nBehavior: read-only and idempotent — a live GET against the public IBGE Países API. Returns Markdown.","params":["tipo","pais","busca","indicadores","regiao"]},{"name":"ibge_cidades","description":"Queries municipal indicators from IBGE (similar to Cidades@ portal).\n\nFeatures:\n- General overview of a municipality (population, HDI, GDP, etc.)\n- Query specific indicators\n- Historical indicator data over years\n- List available surveys and indicators\n\nAvailable indicators: populacao, area, densidade, pib_per_capita, idh,\nescolarizacao, mortalidade, salario_medio, receitas, despesas\n\nExamples:\n- São Paulo overview: tipo=\"panorama\", municipio=\"3550308\"\n- Population history: tipo=\"historico\", municipio=\"3550308\", indicador=\"populacao\"\n- View surveys: tipo=\"pesquisas\"\n- Available indicators: tipo=\"indicador\"\n\nThis tool is the panel for a SINGLE municipality (Cidades@).\nUse a different tool when:\n- Census themes / historical series → ibge_censo\n- Comparing multiple municipalities → ibge_comparar\n- A macro indicator time series → ibge_indicadores\n\nBehavior: read-only and idempotent — a live GET against the public IBGE APIs (Cidades@/agregados). Returns Markdown plus a typed structuredContent payload.","params":["tipo","municipio","uf","indicador","pesquisa"]},{"name":"search","description":"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).\n\nThis 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.\nFor 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.\n\nQuery: natural language or keywords, Portuguese or English; accents and case are ignored.\n\nBehavior: read-only and idempotent — the catalog comes from the public source and is cached in memory.","params":["query"]},{"name":"fetch","description":"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.\n\nCompanion 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.\nThe `ibge_*` tools (`ibge_sidra`, `ibge_cidades`, `ibge_indicadores`, `ibge_comparar`…) remain the tools for data queries.\n\nBehavior: read-only and idempotent — a live GET against the public source when the document needs it.","params":["id"]}],"toolsHash":"b751d443e55d9bfcd68b2efc49e0fe25a53fba5ed17d337183fa209d95e2a0b0","wrote":[],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"ibge_sidra","quote":"3000 characters or more"},{"kind":"very-long","tool":"ibge_indicadores","quote":"2733 characters or more"}],"tools":23,"wrote":0,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"ibge-br-mcp","version":"5.11.0","ranAt":"2026-11-16T11:39:22.691Z","outcome":"started","tools":23,"contacts":0,"flags":2,"serious":0,"toolsHash":"b751d443e55d9bfcd68b2efc49e0fe25a53fba5ed17d337183fa209d95e2a0b0"}],"page":"https://bragproof.smaverk.com/r/ibge-br-mcp"}