# IBGE Brasil MCP

Lets your assistant query the official IBGE APIs directly: Brazilian geography, census figures, economy and health, each answer carrying its source.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: SidneyBissoli
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SidneyBissoli/ibge-br-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ibge-brasil-mcp

## What it does

Instead of guessing a population number from training data, the assistant calls the IBGE API while you chat. The server ships 23 tools: 21 data tools under the `ibge_` prefix plus `search` and `fetch` for ChatGPT Deep Research. Reference resources and analysis prompt templates come with it.

Every successful response includes a provenance block. It names the API that was queried, gives a canonical URL that reproduces the call, the reference period, the actual extraction time in Brasília time, a citation you can paste, and the legal regime. The same data reaches the client three ways: inside `structuredContent.provenance`, in `_meta`, and as a short footer on the Markdown for text-only clients. Statistical mode and `ibge_comparar` return aggregates the server computed itself, and those are labelled as derived.

Keep revisions in mind. IBGE republishes figures and keeps no earlier snapshot, so a value reflects what SIDRA serves at extraction time. If a series disagrees with an older report, a revision explains it more often than a bug.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://ibge.sidneybissoli.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http ibge-br-mcp https://ibge.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add ibge-brasil-mcp -- npx -y ibge-br-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add ibge-brasil-mcp --url https://ibge.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add ibge-brasil-mcp -- npx -y ibge-br-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ibge-brasil-mcp": {
            "url": "https://ibge.sidneybissoli.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ibge-brasil-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ibge-br-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ibge-brasil-mcp": {
            "type": "http",
            "url": "https://ibge.sidneybissoli.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ibge-brasil-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ibge-br-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http ibge-brasil-mcp https://ibge.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add ibge-brasil-mcp npx -y ibge-br-mcp
```

## When to use it
- look up a city's population from the 2022 census
- list the municipalities of a state
- compare GDP across Southeast state capitals
- pull official IBGE figures into an assistant answer
- keep a source link for every number

## Example prompts
- List the municipalities of Espírito Santo.
- Compare GDP across the Southeast state capitals.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md