# IBGE Brasil MCP

> IBGE Brasil MCP is an open-source MCP server for analytics and data. Live IBGE data on Brazil's geography, census, economy and health, with provenance. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://ibge.sidneybissoli.com
- **Repository:** https://github.com/sidneybissoli/ibge-br-mcp
- **MCP Registry name:** io.github.SidneyBissoli/ibge-br-mcp
- **Categories:** analytics and data
- **Listing updated:** 2026-11-14

## About

Rather than letting a model recall a population figure from training data, this server queries the official IBGE APIs at request time and returns the number together with the survey or table, the period and a URL that reproduces the query. Health indicators come through IBGE's SIDRA system. Sample questions from the project include the population of Belo Horizonte in the 2022 Census, the municipalities of Espírito Santo, GDP across Southeast capitals and unemployment in a given quarter.

The server exposes 23 tools: 21 ibge_* data tools plus search and fetch for ChatGPT Deep Research. It can return all 5,570 municipalities in one call with the full distribution (median, mean and percentiles) rather than a top ten that hides skew. Responses are cached with a configurable TTL, retried with exponential backoff and validated, and the README reports 565 automated tests.

Use the hosted endpoint over streamable HTTP with nothing to install, or run the npm package over stdio. It is an independent project by a developer, with a written tutorial for connecting it to Claude, ChatGPT, Cursor and VS Code.

## Features

- **Provenance block:** Each answer names the table, period, URL, retrieval time and citation.
- **Census and cities:** Look up population and city data from Census 2022 and other surveys.
- **Municipality listings:** List municipalities by state or all 5,570 with distribution statistics.
- **Comparisons:** Compare indicators such as GDP across places.
- **Health indicators:** Health data served through IBGE's SIDRA system.
- **Deep Research support:** search and fetch tools for ChatGPT Deep Research.

## Good for

- Get an exact census population with its source
- List the municipalities of a state
- Compare economic indicators across capitals
- Find the right SIDRA table for a statistic
- Rank all municipalities on a measure

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ibge-br-mcp https://ibge.sidneybissoli.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ibge.sidneybissoli.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ibge-br-mcp": {
      "serverUrl": "https://ibge.sidneybissoli.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `ibge_cidades`: Look up city data such as population.
- `ibge_censo`: Query census data.
- `ibge_municipios`: List municipalities, for example by state.
- `ibge_comparar`: Compare indicators such as GDP across places.
- `search`: Search IBGE data for ChatGPT Deep Research.
- `fetch`: Fetch a result for ChatGPT Deep Research.

## FAQ

### Do I need to install anything?

No. Point a client at https://ibge.sidneybissoli.com/mcp, or run the npm package ibge-br-mcp over stdio.

### How many tools does it have?

23: 21 ibge_* data tools plus search and fetch.

### Where do the figures come from?

Live from the official IBGE APIs, including SIDRA for health indicators.

### Is it an official IBGE product?

The registry entry describes it as a project by an independent developer; the README does not claim IBGE endorsement.

### Is IBGE Brasil MCP free?

Yes. IBGE Brasil MCP is open source, so you can use and self-host it for free.

### How do I add IBGE Brasil MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http ibge-br-mcp https://ibge.sidneybissoli.com/mcp

### What are the best alternatives to IBGE Brasil MCP?

The closest alternatives to IBGE Brasil MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/ibge-brasil-mcp
