mcp-brasil-server — Claude Code skill: what it does, how to install
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.
no license 225 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a claude-codeWhat mcp-brasil-server 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-brasil-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-brasil-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-brasil-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a codex2Manually: put the files in place
.agents/skills/mcp-brasil-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a cursor2Manually: put the files in place
.cursor/skills/mcp-brasil-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/mcp-brasil-server2Manually: put the files in place
.github/skills/mcp-brasil-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcp-brasil-serverManually: put the files in place
.devin/skills/mcp-brasil-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcp-brasil-server
How do I install mcp-brasil-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill mcp-brasil-server -a claude-code, then open ~/.claude/skills/mcp-brasil-server/SKILL.md.
What does mcp-brasil-server do?
It runs the mcp-brasil MCP server, which gives an agent 533 tools across 70+ Brazilian public APIs: economy, legislation, transparency, courts, elections, environment, health, education. Tool discovery by context and batch execution are built in.
Do I need API keys?
Only for four features. Everything else works without authentication; TRANSPARENCIA_API_KEY, DATAJUD_API_KEY and META_ACCESS_TOKEN go into the environment variables.