# mcp-brasil-server

mcp-brasil-server is a Claude Code skill that connects an agent to 70+ Brazilian public APIs through 533 tools for querying economic, legal, transparency, court, and election data.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 225 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcp-brasil-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-brasil-server

## What it does

The skill installs `mcp-brasil`, an MCP server that publishes 533 tools over 70+ Brazilian public data sources. The economy side covers Banco Central, IBGE and BNDES. Congress is there through Câmara and Senado, alongside the transparency portal, TCU, DataJud, the electoral court TSE, INPE, IBAMA, DataSUS, ANVISA and INEP. Most of those APIs answer without any authentication.

Features sit in a `features/` directory and are discovered when the server starts. A BM25 filter trims the catalogue to the question at hand: ask about inflation and roughly twenty tools show up rather than all 533. Two helpers handle bigger jobs. `planejar_consulta` drafts an execution plan that spans several APIs, `executar_lote` runs a batch of queries in parallel.

Heavy datasets (TSE election results, SPU federal properties, ANP fuel prices, INEP school census) get cached locally in DuckDB once you list them in `MCP_BRASIL_DATASETS`. The first load pulls and ingests the files, which runs into minutes; later queries come back in milliseconds. `TRANSPARENCIA_API_KEY`, `DATAJUD_API_KEY` and `META_ACCESS_TOKEN` are marked optional, yet the four features behind them stay dark until the keys are set.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-brasil-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-brasil-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-brasil-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-brasil-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/mcp-brasil-server
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-brasil-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcp-brasil-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-brasil-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcp-brasil-server/SKILL.md

## When to use it
- pull a Selic or IPCA series from the central bank for a date range
- search Câmara bills by keyword and year
- total a deputy's monthly expenses
- match TSE candidates against their asset declarations
- draft a multi-API plan with `planejar_consulta`

## Example prompts
- Set up mcp-brasil and pull the Selic series for 2024.
- Using mcp-brasil, find Câmara bills about artificial intelligence from 2024.
- Plan a query that compares deputy `204554`'s expenses with his votes on health bills.

## Similar
- [mcp-brasil-api](https://affpapa.org/en/nevibecode/mcp/mcp-brasil-api.md) — MCP server · ★ 279 repo stars
- [Dados Abertos Senado BR MCP](https://affpapa.org/en/nevibecode/mcp/dados-abertos-senado-br-mcp.md) — MCP server · ★ 7 repo stars
- [mcp-brasil-public-apis](https://affpapa.org/en/nevibecode/skills/mcp-brasil-public-apis.md) — skill · 880 installs
- [MCP Juridico Brasil](https://affpapa.org/en/nevibecode/mcp/mcp-juridico-brasil.md) — MCP server · ★ 143 repo stars
- [IBGE Brasil MCP](https://affpapa.org/en/nevibecode/mcp/ibge-brasil-mcp.md) — MCP server · ★ 14 repo stars
- [cloo.be: ofertas do Brasil](https://affpapa.org/en/nevibecode/mcp/cloobe-ofertas-do-brasil.md) — MCP server

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

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