mcp-brasil
An MCP server for Brazil's open data: economy, laws, public procurement, courts, elections, environment and more
- 1,861 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server calls external government APIs over the network
- Some keys are secrets and must be kept in environment variables
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-brasilDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server calls external government APIs over the network
- Some keys are secrets and must be kept in environment variables
This is third-party code. Review the repository files before installing.
What it does
The server connects an agent to dozens of Brazilian government data sources over the MCP protocol built on FastMCP. From natural language the agent queries central bank time series, IBGE data, bills and votes from the chamber and senate, contracts and spending from the transparency portal, court cases, election data and other topics. It has a query planner that combines several APIs into one plan, batch execution and a tool search that surfaces only relevant tools from a large set. Large datasets are available locally via embedded DuckDB and are enabled separately through environment variables. Many sources need no keys; a few need free ones.
Who it is for. For analysts, journalists and developers who need Brazilian government data inside agent workflows.
Good fit when
- You need Brazilian government data: economy, laws, procurement, courts or elections
- You want to combine several government APIs into one query
- You need local access to large datasets via embedded DuckDB
Not a fit when
- You need data outside Brazil
- You need an official government service; this is an independent project
Example request
Show the Selic rate trend over the last twelve months and compare it with IPCA inflation over the same periodMCP
- Transport
- stdio, http
- Authentication
- key is optional
Environment variables
TRANSPARENCIA_API_KEYsecret- Free transparency portal key that raises request limits
DATAJUD_API_KEYsecret- Free DataJud CNJ key for judicial data
DADOS_GOV_BR_API_KEYsecret- Key for the dados.gov.br portal feature
META_ACCESS_TOKENsecret- Meta token for the election ad library feature
MCP_BRASIL_API_TOKENsecret- Static token to protect the server in HTTP mode
Limitations
The project is independent and not an official Brazilian government service. The MIT license covers only the code; each data source has its own license and usage rules that must be read before commercial or decision-making use. Some APIs work without keys, while a few need free keys after registration. Large datasets are enabled separately through environment variables.
How to disable. Remove the mcp-brasil entry from your client's MCP config; if installed via pip, remove the package with pip uninstall mcp-brasil.
FAQ
Are API keys required?
For most sources, no. A few APIs, such as the transparency portal and DataJud, use free keys after registration; without them the other sources still work.
Is this an official government service?
No. It is independent; the MIT license covers only the code, and data from each agency has its own license.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for Brazilian public procurement with PNCP and company registry data, no key or signup.
MCP server and CLI that find Brazilian companies by CNAE code and region in a local copy of Receita Federal open data.
An MCP server for more than 40 open US government APIs: economy, health, Congress and lobbying, with over 300 tools.
data.gouv.fr MCP
data.gouv.fr MCP Server
Official MCP server for France's open data portal: search, explore and query datasets straight from a chat with the agent
An MCP server with a toolbox for global briefs: markets, SEC filings, conflict, climate and news from open sources
An MCP server for Canadian government data: exchange rates, parliament, product recalls and drugs, reached through BM25 search.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| mcp-brasil (this card) | no | key is optional | 1,861 | |
| MCP Fiscal Brasil | no | not required | 429 | an MCP server for Brazilian tax work |
| MCP Dev LATAM | no | API key | 279 | more than 120 MCP servers for Latin American commerce |
README in short
The README describes an MCP server that connects agents to Brazilian government data sources across topics from economy and legislation to courts, elections and environment. Installation is via pip or uv, and connection is shown for Claude Desktop, VS Code, Cursor, Claude Code and an HTTP mode via fastmcp. It highlights a query planner, batch execution, a tool search and large datasets with a local DuckDB cache enabled by environment variables. The project is explicitly called independent and unofficial; the MIT license covers only the code, and each source has its own license. A few APIs need free keys.