# SidneyBissoli/ibge-br-mcp [Health: Active]

**Category:** 🗄️ Databases  
**Repository:** https://github.com/SidneyBissoli/ibge-br-mcp  
**GitHub Stars:** 12  
**npm Downloads (last month):** 1214  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/sidneybissoli-ibge-br-mcp

## Description
Brazilian Census Bureau (IBGE) data server with 23 tools for demographics, geography, economics, and statistics. Covers localities, SIDRA tables, Census data, population projections, and geographic meshes.

## Tools
Capabilities this server exposes over MCP:

- **ibge_estados** — List Brazilian states with region filtering
- **ibge_municipios** — List municipalities by state or search by name
- **ibge_localidade** — Get details of a locality by IBGE code
- **ibge_geocodigo** — Decode IBGE codes or search codes by name
- **ibge_vizinhos** — Find neighboring municipalities
- **ibge_sidra** — Query SIDRA tables (Census, PNAD, GDP, etc.)
- **ibge_sidra_tabelas** — List and search available SIDRA tables (accent-insensitive; everyday Portuguese resolved to the IBGE's wording, and the response says so)
- **ibge_sidra_metadados** — Get table metadata (variables, periods, levels)
- **ibge_pesquisas** — List IBGE research surveys and their tables
- **ibge_indicadores** — Economic and social indicators (GDP, IPCA, unemployment)
- **ibge_censo** — Census data (1970-2022) with 16 themes
- **ibge_comparar** — Compare indicators across localities with rankings
- **ibge_cidades** — Municipal indicators (population, HDI, GDP per capita, etc.)
- **ibge_paises** — Country data following UN M49 methodology
- **ibge_nomes** — Name frequency and rankings in Brazil
- **ibge_cnae** — CNAE (National Classification of Economic Activities)
- **ibge_malhas** — Geographic meshes (GeoJSON, TopoJSON, SVG)
- **ibge_malhas_tema** — What a thematic recorte contains (biomes, Legal Amazon, semi-arid, coastal, border strip, metro regions, RIDEs) + the URL to download its geometry
- **ibge_datasaude** — Health indicators via IBGE's SIDRA
- **ibge_noticias** — IBGE news and press releases
- **ibge_calendario** — IBGE release and collection calendar
- **search** — Searches the IBGE catalog (SIDRA tables, municipalities, known indicators) — OpenAI Deep Research contract
- **fetch** — Returns one catalog document (table metadata, municipality hierarchy + population, indicator series) with its public URL for citation

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What SidneyBissoli/ibge-br-mcp MCP server does

SidneyBissoli/ibge-br-mcp MCP server gives MCP-compatible AI assistants structured access to Brazilian public data published through IBGE APIs. It covers geographic hierarchies, municipalities, states, Census results from 1970 through 2022, SIDRA tables, economic and social indicators, health indicators, country data, demographic name rankings, CNAE classifications, and geographic meshes.

The server is suited to questions that require a specific locality, period, indicator, or table rather than a general explanation. For example, an agent can identify a municipality by name or IBGE code, retrieve a 2022 Census value, compare indicators across localities, or find the table metadata needed to interpret a SIDRA result.

## How it works

The tools query IBGE services and return structured results for the assistant to use. SIDRA-related tools separate table discovery, metadata inspection, and data retrieval: `ibge_sidra_tabelas` searches available tables, `ibge_sidra_metadados` describes variables and periods, and `ibge_sidra` queries the selected table. Everyday Portuguese terms can be resolved to IBGE terminology during table search, and the response indicates that resolution.

Successful responses include a provenance block with the queried source, a canonical reproducing URL, the source reference period when available, the upstream extraction time, a citation string, and attribution information. Text-only clients also receive a compact provenance footer. Cached responses preserve the original upstream extraction time. Results from server-side comparisons and statistical modes are identified as derived where applicable.

## Tools and capabilities

The 23 tools are grouped into these practical areas:

- **Geography:** list states and municipalities, inspect localities, decode or find IBGE codes, and identify neighboring municipalities.
- **Statistics:** query SIDRA, search tables, inspect metadata, and list IBGE surveys and their tables.
- **Indicators and Census:** retrieve GDP, IPCA, unemployment, municipal indicators, 16 Census themes, and comparisons with rankings.
- **Other datasets:** access country data under UN M49, Brazilian name frequencies, CNAE classifications, and health indicators through SIDRA.
- **Maps and publications:** obtain GeoJSON, TopoJSON, or SVG meshes; inspect thematic mesh recortes and their download URLs; search IBGE news and the release calendar.
- **Research access:** `search` searches the IBGE catalog, while `fetch` returns a catalog document such as table metadata, a municipality hierarchy with population, or an indicator series, together with a public citation URL.

SidneyBissoli/ibge-br-mcp MCP server therefore supports both direct lookup workflows and multi-step research, such as finding a table before querying it or comparing values across several municipalities.

## Limitations and notes

The data comes from IBGE APIs, so values and available periods depend on those upstream services. The material does not describe offline datasets or a separate non-IBGE data source. IBGE APIs do not declare their own license in the project documentation; the stated legal framework is Brazil's open-data regime under Lei 12.527/2011 and Decreto 8.777/2016, which permits reuse while requiring source credit.

Comparisons and statistical-mode responses may contain values calculated by the server rather than copied directly from an IBGE response. These outputs are marked as derived in the provenance information. SidneyBissoli/ibge-br-mcp MCP server also uses caching and retry behavior, so a cached result may retain the original upstream extraction timestamp rather than the time of the latest tool call.

_Full upstream README: https://allmcps.com/mcp/sidneybissoli-ibge-br-mcp/readme_