{"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\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjAwMTI0NmNlNDIzZDM1ZTc2NjkzMjE4OWVkMmFlMjQyNTQ2MzI2N2JjZTRhODM3ODRhNDc4OTI3YjU2ZDRhYmEiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM5OCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTQ2OSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MjkxNjksImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiMWRjMjYxOTktMGU1Ny00OGUxLTliMjctNDQ3YmI5ZjZiY2Q3IiwibmJmIjoxNzk0ODI4ODY5LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.tf70FLB8tgm5-fbIXvd862LVuvp4QCX2yF3zqplvWcf5Hv9BHtyF1asbu3SUlLasw6ks8ggU32IYx_Kwgr2XP7qyWaiKCisnQ2gfmdjIPLSHvEIZsTosZ6_DQogT0Ty0r1t-iKAI0zoSMn6Y3qjqnuah0j-h30IA2FM_93QaIa5EWZy4vcL7g4MZdvebYjJdYtbBdff5c0fk4Zpfhh3ayI2sMRl2tFZxUiV8-4TKPn-YUdn6ixeGKQnQnr4RUVTQn0BDC7DnYBjLtM1VtRQgw3op3RreiHrGjWRhZ14rJyRsEOyXzBNxQ6LgeYDXWTchNXUtm1AmPRj3YT-3iycU-A"}