Log inSubmit server
Ibge Br MCP logo

Ibge Br MCP

by SidneyBissoli

Query live IBGE data on Brazilian geography, censuses, indicators, SIDRA tables, health, and maps through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Ibge Br MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sidneybissoli-ibge-br-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ibge-br-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

SidneyBissoli/ibge-br-mcp MCP server connects AI assistants to official IBGE APIs for live Brazilian geographic, demographic, economic, health, and statistical data. Its 23 tools cover locality lookup, SIDRA queries, Census data, municipal comparisons, country classifications, name frequencies, economic activities, geographic meshes, news, and release calendars. Responses include provenance details such as the source API, canonical URL, reference period when available, retrieval time, and citation data. Reach for it when an agent needs current IBGE figures or sourceable results instead of relying on model training data.

Use cases

  • Query Census values for a Brazilian municipality and year
  • Compare GDP or other indicators across localities
  • Find and inspect the correct SIDRA table before querying it
  • Retrieve geographic meshes for Brazilian regions or thematic areas
  • Look up municipality codes, neighbors, and population data

Key features

  • 23 tools for IBGE geography, statistics, demographics, and economics
  • SIDRA table search, metadata inspection, and data queries
  • Census coverage from 1970 through 2022
  • Municipality comparisons with rankings
  • GeoJSON, TopoJSON, and SVG geographic meshes
  • Provenance blocks with source URLs and citation details

Tools23

What Ibge Br MCP lets your agent do. Expand a tool for its parameters.

Self-reported~406 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/10 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · ibge-br-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars12Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed23Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Ibge Br MCP works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ibge Br MCP

SidneyBissoli/ibge-br-mcp is an MCP server that connects AI assistants to official IBGE APIs. Its main tools query SIDRA tables, Census data, economic and social indicators, municipalities, geographic meshes, health data, and IBGE catalogs. Responses include provenance details such as source URLs, periods, extraction times, and citations.

Consult the repository or npm package instructions for the client-specific installation steps.

Yes, Cursor is named in the project tutorial as a client for connecting to the server.

Use `ibge_sidra_tabelas` to search available tables, then use `ibge_sidra_metadados` to inspect variables, periods, and levels before calling `ibge_sidra`. The table search handles accents and can map everyday Portuguese wording to IBGE terminology.

Related MCP servers

All in Databases All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIbge Br MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sidneybissoli-ibge-br-mcp?style=directory)](https://allmcps.com/mcp/sidneybissoli-ibge-br-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/sidneybissoli-ibge-br-mcp"><img src="https://allmcps.com/api/badge/sidneybissoli-ibge-br-mcp?style=directory" alt="Ibge Br MCP on AllMCPs" /></a>