Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

IBGE Brasil MCP

by SidneyBissoliversion 5.11.0i★ 14iComputer or cloudOfficial site ↗
Registry nameio.github.SidneyBissoli/ibge-br-mcp

How to install

What it does

IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Clinics & health

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars32/100Popularity 12 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-10-28

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 5/5 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install IBGE Brasil MCP. Follow https://mcp.popnx.com/i/sidneybissoli-ibge-br-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (ibge.sidneybissoli.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameIBGE Brasil MCP
    Remote MCP server URL · Addresshttps://ibge.sidneybissoli.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsIBGE Brasil MCP

  4. Try it

    Use IBGE Brasil MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using IBGE Brasil MCP or shows a IBGE Brasil MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameIBGE Brasil MCP
    Connection · Addresshttps://ibge.sidneybissoli.com/mcp
  3. Pick IBGE Brasil MCP in a chat

    Start a new chat and pick IBGE Brasil MCP from your plugins before typing

  4. Try it

    Use IBGE Brasil MCP and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using IBGE Brasil MCP or shows a IBGE Brasil MCP tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user ibge-br https://ibge.sidneybissoli.com/mcp
  3. Type /mcp in Claude Code

    You should see IBGE Brasil MCP listed as connected

  4. Try it

    Use IBGE Brasil MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using IBGE Brasil MCP or shows a IBGE Brasil MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use IBGE Brasil MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using IBGE Brasil MCP or shows a IBGE Brasil MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use IBGE Brasil MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using IBGE Brasil MCP or shows a IBGE Brasil MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://ibge.sidneybissoli.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use IBGE Brasil MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ibge-br": {
      "url": "https://ibge.sidneybissoli.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ibge-br": {
      "type": "http",
      "url": "https://ibge.sidneybissoli.com/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user ibge-br -- npx -y ibge-br-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "ibge-br": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ibge-br-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
381/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
5.11.0
Published to registryi
Oct 28, 2026
Code last changedi
Nov 17, 2026
Last checked
Nov 18, 2026
Maker
SidneyBissoli
Packages
npm: ibge-br-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • ibge_estados

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

  • ibge_municipios

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

  • ibge_localidade

    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 Pa

  • ibge_sidra

    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 are

  • ibge_nomes

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

  • ibge_noticias

    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 parame

  • ibge_sidra_tabelas

    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

  • ibge_sidra_metadados

    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 da

  • ibge_malhas

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

  • ibge_pesquisas

    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 C

  • ibge_censo

    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 c

  • ibge_indicadores

    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 p

  • ibge_cnae

    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 -

  • ibge_geocodigo

    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=

  • ibge_calendario

    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 r

  • ibge_comparar

    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:

  • ibge_malhas_tema

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

  • ibge_vizinhos

    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

  • ibge_datasaude

    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 I

  • ibge_paises

    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 expe

  • ibge_cidades

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

  • search

    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 contr

  • fetch

    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

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account SidneyBissoli, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 176 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 23 tool descriptions and found no hidden instructions to the AI

The cloud address answered 4 of the last 4 checks · latest 176 ms · checked Nov 18, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for ibge-br-mcp@5.11.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/sidneybissoli-ibge-br-mcp.svg)](https://mcp.popnx.com/en/servers/sidneybissoli-ibge-br-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Clinics & healthi

  • More stars than 96% of the other 1182 servers in this category
  • Published to the registry more recently than 54% of the other 1182 servers in this category
  • Basic checks equal to or better than 99% of the other 1182 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is IBGE Brasil MCP safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (5.11.0) reached the registry 22 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Medplum MCP, Mirobody, Codescene MCP Server, WHOOP — MissingMCP, Marrow

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

by medplumWidely used★ 2.8KUpdated 4 months ago

Runs in the cloud✓ service owner · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

by thetahealthGrowing↓ 725/wk★ 1.6KUpdated 9 days ago

Runs on your computer✓ thetahealth.ai

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

by codescene-ossGrowing↓ 3.8K/wk★ 85Updated 8 months ago

Runs on your computer✓ service owner · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

by skeletonarmytechEarly↓ 62/wk★ 4Updated 28 days ago

Runs on your computer✓ skeletonarmy.tech
Compared with similar ones
This one
IBGE Brasil MCP
Medplum MCPMirobodyCodescene MCP ServerWHOOP — MissingMCPMarrow
Runs whereCloud or install on your computerRuns in the cloud, nothing to installInstalls on your computerInstalls on your computerRuns in the cloud, nothing to installInstalls on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/43/32/32/43/3
LicenseMITApache-2.0Apache-2.0NOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

IBGE Brasil MCP Server

Live, exact Brazilian public data for your AI assistant — with provenance, not guesswork.

Ask an LLM _"what was Belo Horizonte's population in the 2022 Census?"_ and you get a plausible number from its training data: maybe right, maybe outdated, with no source. ibge-br-mcp instead has your assistant query the official IBGE APIs in real time — returning the exact figure together with the table and period it came from.

🇧🇷 Leia em Português

This server implements the Model Context Protocol (MCP) to give AI assistants live, structured access to Brazil's public geographic, demographic, economic, and health data — sourced from the IBGE APIs (including health indicators served through IBGE's SIDRA system).

See it in action

Ask your assistant, in English or Portuguese:

  • *"What was Belo Horizonte's population in the 2022 Census?"* → ibge_cidades / ibge_censo
  • *"List the municipalities of Espírito Santo."* → ibge_municipios
  • *"Compare GDP across the Southeast state capitals."* → ibge_comparar

The answers come live from the official IBGE APIs — exact figures with the table and period they came from, not numbers guessed from training data.

Want to see a whole analysis rather than a single answer? The end-to-end demo works one real question — *which state grew most between the 2010 and 2022 Censuses, and what drove it* — from first call to conclusion, with every figure as it came back. The practical examples are seven shorter recipes, including ranking all 5,570 municipalities in a single call.

Features

  • 23 tools covering all major IBGE data domains — 21 ibge_* data tools plus search/fetch for ChatGPT Deep Research
  • Provenance block on every response — source, canonical URL, reference period, real extraction timestamp, ready-to-use citation, and legal regime (see Data provenance)
  • Reference resources & analysis prompts (MCP catalogs + ready-made templates)
  • 565 automated tests — 88% overall coverage, 92% across the tools
  • Automatic caching with configurable TTL for optimal performance
  • Retry mechanism with exponential backoff for network resilience
  • Comprehensive validation for all input parameters
  • Standardized error handling with helpful suggestions
  • Full TypeScript support with strict typing

📖 Article (in Portuguese): Como achar a tabela certa no SIDRA — e como saber que é a certa — finding the right SIDRA table, the metadata that settles it, a full worked example on 2022 Census data, and the four traps that cost the most. Also published on the site, in Portuguese and English: sidneybissoli.com.

🔌 Tutorial: Querying SIDRA through MCP in Claude and ChatGPT — how to connect this server in claude.ai, Claude Desktop, Claude Code, ChatGPT (developer mode and Deep Research), Cursor, VS Code and Gemini CLI, then one real query end to end with the provenance block it returns. Em português.

Data provenance

Since v3.3.0 every successful tool response carries a provenance block (portfolio contract v1.0), so each number is citable, auditable, and reproducible. The block is emitted on three channels:

  1. structuredContent.provenance (parseable, visible to the model) — exactly six keys: source (the IBGE API queried), source_url (canonical URL that reproduces the query), data_vintage (reference period when the source exposes one; null otherwise), retrieved_at (the REAL upstream extraction instant, preserved across cache hits, Brasília time), citation ("Fonte: IBGE — [pesquisa/tabela], [URL], extraído em [data]."), and license — plus attribution, the canonical list of source URLs.
  2. _meta under br.com.sidneybissoli.ibge/provenance and .../attribution (out-of-band mirror for audit/UI, zero model tokens).
  3. A compact text footer appended to the Markdown, for text-only clients.

The IBGE APIs declare no license of their own; the legal regime is Brazil's open-data framework — Lei 12.527/2011 (LAI) and Decreto 8.777/2016 (unrestricted reuse, free use, obligation limited to crediting the source). Statistics-mode responses (estatisticas=true) and ibge_comparar are marked derived with an explanatory note in the canonical block, since the aggregates are computed server-side from the raw IBGE values.

What each number is, and which version of it. A SIDRA value says neither its period nor whether it is a monthly change, a year-to-date or 12-month accumulation, an index or a level — the record's period column and its Variável label do, and each ibge_indicadores entry is pinned to the one variable its name promises (since 5.7.0; before, nine of them mixed every variable of the table). data_vintage is ordered by the SIDRA period code, so a January–December request reads "janeiro 2024–dezembro 2024". Every value is the version SIDRA publishes at retrieved_at: IBGE revises published figures (quarterly GDP, PNAD reweighting, PIM/PMC/PMS) and keeps no earlier version.

Available Tools

Localities & Geography
ToolDescription
ibge_estadosList Brazilian states with region filtering
ibge_municipiosList municipalities by state or search by name
ibge_localidadeGet details of a locality by IBGE code
ibge_geocodigoDecode IBGE codes or search codes by name
ibge_vizinhosFind neighboring municipalities
Statistical Data (SIDRA)
ToolDescription
ibge_sidraQuery SIDRA tables (Census, PNAD, GDP, etc.)
ibge_sidra_tabelasList and search available SIDRA tables (accent-insensitive; everyday Portuguese resolved to the IBGE's wording, and the response says so)
ibge_sidra_metadadosGet table metadata (variables, periods, levels)
ibge_pesquisasList IBGE research surveys and their tables
Economic & Social Indicators
ToolDescription
ibge_indicadoresEconomic and social indicators (GDP, IPCA, unemployment)
ibge_censoCensus data (1970-2022) with 16 themes
ibge_compararCompare indicators across localities with rankings
Municipal Data (Cidades@)
ToolDescription
ibge_cidadesMunicipal indicators (population, HDI, GDP per capita, etc.)
International Data
ToolDescription
ibge_paisesCountry data following UN M49 methodology
Demographics
ToolDescription
ibge_nomesName frequency and rankings in Brazil
Classifications
ToolDescription
ibge_cnaeCNAE (National Classification of Economic Activities)
Maps & Geographic Meshes
ToolDescription
ibge_malhasGeographic meshes (GeoJSON, TopoJSON, SVG)
ibge_malhas_temaWhat a thematic recorte contains (biomes, Legal Amazon, semi-arid, coastal, border strip, metro regions, RIDEs) + the URL to download its geometry
Health
ToolDescription
ibge_datasaudeHealth indicators via IBGE's SIDRA
News & Calendar
ToolDescription
ibge_noticiasIBGE news and press releases
ibge_calendarioIBGE release and collection calendar
ChatGPT Deep Research
ToolDescription
searchSearches the IBGE catalog (SIDRA tables, municipalities, known indicators) — OpenAI Deep Research contract
fetchReturns one catalog document (table metadata, municipality hierarchy + population, indicator series) with its public URL for citation

The two are the only tools without the ibge_ prefix: their names are fixed by the OpenAI contract. For data queries keep using the ibge_* tools.

Which tool should I use?

With 23 tools, several can touch the same topic. Quick guide for the common overlaps:

Population & demographics
You want…Use
A single municipality/state panel (population, HDI, GDP…)ibge_cidades
Census data or historical series (1970–2022)ibge_censo
Rank/compare 2–10 localities on one indicatoribge_comparar
A macro indicator time series (GDP, IPCA, unemployment…)ibge_indicadores
A specific SIDRA table / fine controlibge_sidra
The largest/smallest/mean/median across a whole tableibge_sidra/ibge_censo/ibge_indicadores/ibge_datasaude with estatisticas=true
Economic indicators
You want…Use
IPCA, INPC, GDP, unemployment (IBGE, primary source)ibge_indicadores
Localities & codes
You want…Use
List/search municipalitiesibge_municipios
List statesibge_estados
Resolve a name→code at any level, or decode a code's structureibge_geocodigo
Full record of one locality you already have the code foribge_localidade
Neighboring municipalitiesibge_vizinhos
SIDRA workflow

Discover → inspect → query: ibge_pesquisas / ibge_sidra_tabelas (find a table) → ibge_sidra_metadados (its structure) → ibge_sidra (query). For common data, the wrappers above (ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades) are usually easier.

Ask in your words, not the IBGE's

The IBGE names its tables in official statistical Portuguese, and ibge_sidra_tabelas matched your words against the table name as a plain substring, accents included — so populacao (no tilde, as anyone types it) returned *nothing at all*, and so did the everyday word for a concept the IBGE names differently. Measured over the 9,336 tables of the Aggregates API (2026-09-16), fixed since 5.1.0: both sides are normalised, every word must match (AND), and the everyday word is expanded to the IBGE's own — the response says so in notas_vocabulario, and zero results come with a way out.

you askhits beforethe IBGE writeshits

| populacao,

Only the beginning is shown; read the rest in the repo