lakebrasil-mcp

153 tools, one MCP server, live Brazilian government data — federal AND state. Every tool reads straight from the original source, one period or entity at a time (never a bulk historical dump) — not from a mirrored copy. Point an agent (Claude, Cursor, any MCP client) at this server and it can look up the Selic rate, a CNPJ, a deputy's expenses, a court case, an active wildfire hotspot, a município's 2024 election results, a state budget line item, or a postal code, live.

Sibling project to lakebrasil, the open-source engine that aggregates 35 pipelines of historical data into an Iceberg lakehouse. This package is the live counterpart — most tools need no lake at all, hitting the government's own API/file for just the slice asked for; a handful (município reference data, CEPs, flags) query a bundled local dataset instead of the network on every call.

Install

uvx lakebrasil-mcp
# or
pip install lakebrasil-mcp

Add to an MCP client config (e.g. Claude Desktop, claude_desktop_config.json):

{
  "mcpServers": {
    "lakebrasil": {
      "command": "uvx",
      "args": ["lakebrasil-mcp"]
    }
  }
}

That's it — no account, no API key, for almost every tool. One exception: transparencia_* tools need PORTAL_TRANSPARENCIA_API_KEY (free, register at https://api.portaldatransparencia.gov.br/swagger-ui.html). (b3_* tools work unauthenticated too, but only for PETR4/VALE3/MGLU3/ITUB4 unless you also set BRAPI_TOKEN — brapi.dev's free-tier limit.)

Related MCP server: mcp-brasil

What's in it (153 tools, 57 modules)

Every tool's description documents its own caveats (rate limits, LGPD/ CC-BY-ND notes where relevant, which fields are unreliable) — read the tool description your MCP client surfaces before assuming a field means what it looks like it means.

Why public

The plan here is straightforward: build the widest possible community of people actually using this against real government data, learn from that usage, and let that shape whatever comes after — rather than guessing at a product behind a paywall from day one. If you hit a broken source, a wrong field, or a rate limit that shouldn't be there, open an issue.

Development

Ported from an original Rust implementation (rmcp + reqwest) to Python (mcp SDK's FastMCP + httpx). Every module follows the same shape: <source>/client.py (pure fetch/parse logic) and <source>/tools.py (@mcp.tool()-decorated functions).

pip install -e ".[dev]"
ruff check src/

License

MIT — see LICENSE.