mcp-brasil-public-apis — Claude Code skill: 28 Brazilian APIs
Wires an agent into 28 Brazilian public APIs — economy, legislation, courts, elections, environment, health. 26 of them need no key.
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a claude-codeWhat mcp-brasil-public-apis does
The skill stands up the mcp-brasil MCP server, which hands your agent 213 tools, 55 resources and 45 prompts. Questions about Brazilian government data go in plain language: deputies and bills, the Selic rate and IPCA, court cases, campaign finance, wildfire hotspots, hospital beds. Under the hood sits the mcp_brasil package with one folder per API — an httpx client, Pydantic v2 schemas, constants holding base URLs. The root server.py discovers features by scanning for FEATURE_META, so nothing gets registered by hand.
Two setup routes. For the Claude CLI: claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server. For Cursor and VS Code, drop .vscode/mcp.json into the project root. There is also an HTTP transport — fastmcp run mcp_brasil.server:mcp --transport http --port 8000 serves at http://localhost:8000/mcp.
Keys are required for exactly two APIs: TRANSPARENCIA_API_KEY for Portal da Transparência and DATAJUD_API_KEY for DataJud/CNJ, both free to register. The other 26 answer without one. Tool discovery is tuned with MCP_BRASIL_TOOL_SEARCH, which takes bm25, code_mode or none and defaults to bm25. Timeouts and retry counts live in MCP_BRASIL_HTTP_TIMEOUT and MCP_BRASIL_HTTP_MAX_RETRIES. Skip the two registrations and those tools stay silent.
What it helps with
- pull the Selic rate and IPCA from a Banco Central series
- trace bills and floor votes for a given deputy
- check contracts and sanctions in Portal da Transparência
- look up court cases through DataJud
- gather candidate and campaign finance records from TSE
Example prompts for the agent
- Connect mcp-brasil and list the available features
- Find education bills in Câmara dos Deputados
- Plan a query: Transparência contracts plus TCU rulings for one supplier
How to install mcp-brasil-public-apis
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-brasil-public-apis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-brasil-public-apis/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a codex2Manually: put the files in place
.agents/skills/mcp-brasil-public-apis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a cursor2Manually: put the files in place
.cursor/skills/mcp-brasil-public-apis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills mcp-brasil-public-apis2Manually: put the files in place
.github/skills/mcp-brasil-public-apis/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/mcp-brasil-public-apisManually: put the files in place
.devin/skills/mcp-brasil-public-apis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -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-public-apis
How do I install mcp-brasil-public-apis in Claude Code?
Run npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a claude-code; the skill lands at ~/.claude/skills/mcp-brasil-public-apis/SKILL.md.
What does mcp-brasil-public-apis do?
It runs the mcp-brasil MCP server, exposing 213 tools across 28 Brazilian public APIs so your agent can answer questions about government data without hitting each portal by hand.
Do I need API keys?
Only two: TRANSPARENCIA_API_KEY and DATAJUD_API_KEY. The remaining 26 APIs respond with no registration.