Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill mcp-brasil-public-apis -a claude-code
Open on GitHub

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

2Manually: put the files in place

~/.claude/skills/mcp-brasil-public-apis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcp-brasil-public-apis/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set139

creationix-rx-data-store This skill guides RX data encoding and direct reads from JSON-shaped documents. Use it when an agent needs path-based access without parsing the whole value. CX Codex +1 904installs agent-flow-visualization Installs the Agent Flow VS Code extension, which draws Claude agent orchestration as a live node graph: tool calls, branches, subagents, timings. CX Codex +1 887installs wewrite-wechat-ai-publishing Runs a WeChat Official Account article from trending topics to a saved draft: topic pick, copy, SEO, cover art, formatting. CX Codex +1 882installs tg-ws-proxy-telegram-socks5 Guides the setup of a local SOCKS5 proxy routing Telegram Desktop traffic to data centers over WebSockets. Useful for bypassing connection blocks without remote servers. CX Codex +1 882installs holyclaude-ai-workstation Sets up a container with Claude, the CloudCLI web UI, a headless browser and five AI CLIs. Useful when you would rather not build the environment by hand. CX Codex +1 865installs obliteratus-abliteration This skill runs OBLITERATUS workflows that analyze and alter refusal behavior in LLMs. Use it when testing models from HuggingFace. CX Codex +1 864installs legalize-es-spanish-legislation Search and inspect Spanish legislation in Markdown files, then trace changes through Git. Useful for finding articles, checking revisions, and reviewing past versions. CX Codex +1 858installs markit-markdown-converter This skill turns files, URLs, and media into Markdown through the markit-ai CLI or SDK. Use it when an agent needs readable content from source material. CX Codex +1 855installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor