
mcp-brasil MCP Server: Brazilian Public Data for Claude, Cursor and Other Apps
Lets Claude and other assistants look up Brazilian public data: economy, laws, government spending, courts, elections, health and more.
mcp-brasil connects your assistant to about 70 Brazilian public data sources, such as the Central Bank, IBGE, the Portal da Transparencia, courts and election data. It runs on your computer, and 66 of the sources need no key. It is an independent project, not a government service. The tool list is large, so the assistant finds tools by searching instead of loading all of them.
Good for
- Journalists and researchers digging into Brazilian public records
- Analysts who need Central Bank, IBGE and budget numbers in one place
- Developers building tools on open government data
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install mcp-brasil
Claude Code
- 1
Copy this prompt.
Add the mcp-brasil server to Claude Code. Run this command: claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv, Python 3.10+.
Read-only mode: All data tools only read public data, so there is nothing to switch off.
The server module is started with python -m mcp_brasil.server; plain uvx mcp-brasil does not work because the package has no command of its own. The README documents Claude Code, Claude Desktop, VS Code, Cursor and Google Antigravity; other apps use the same command in their own config format. Add the optional keys in an env block if you want those sources.
From the project README. Source.
Tools
Lists which Brazilian data sources are active
Shows every active source with whether it needs a key and whether yours is set, so the assistant knows what it can ask.
Try: “Which Brazilian data sources do you have?”
Read ·
listar_featuresSuggests which data tools fit a question
Takes a question in plain language and returns 3 to 5 tools likely to answer it. It asks an Anthropic model to choose, so it needs ANTHROPIC_API_KEY and sends your question and the tool catalog to Anthropic.
Try: “Which tools would answer "federal spending on health in 2024"?”
Network ·
recomendar_toolsPlans a question that needs several data sources
Builds a step-by-step plan across APIs, such as comparing health spending in two states per person. It uses an Anthropic model and needs ANTHROPIC_API_KEY.
Try: “Plan how to compare health spending in SP and MG.”
Network ·
planejar_consultaRuns up to 10 data queries at once
Sends several tool calls in parallel in a single request, to cut round trips.
Try: “Get the Selic rate, the list of states and the exchange rate together.”
Network ·
executar_loteLists the big datasets you can cache locally
Shows downloadable datasets such as TSE election data that can be stored on your machine for fast queries.
Try: “Which large datasets can I load locally?”
Read ·
listar_datasets_disponiveisShows current Central Bank indicators
Returns current values for key indicators such as the Selic rate, from the Banco Central.
Try: “What is the current Selic rate?”
Network ·
bacen_indicadores_atuaisLists Brazilian states from IBGE
Returns the states with their codes from the national statistics institute.
Try: “List the Brazilian states with their IBGE codes.”
Network ·
ibge_listar_estadosLooks up federal government spending
Searches the Portal da Transparencia for spending by function, state and year.
Try: “Show federal health spending in 2024.”
Network ·
transparencia_consultar_despesasSearches federal government contracts
Looks up contracts in the Portal da Transparencia.
Try: “Find the ten largest federal contracts in 2024.”
Network ·
transparencia_buscar_contratosSearches decisions of the federal audit court (TCU)
Finds TCU rulings, for example on irregular spending.
Try: “Find TCU rulings about irregular bidding.”
Network ·
tcu_consultar_acordaos
From the official docs
Permissions
low risk · 4 things to watch
Low risk
The assistant only reads public data, and two helper tools send your question to Anthropic if you give them a key.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Questions can go to Anthropic
Two helper tools send your question and a tool catalog to an Anthropic model, and only work with ANTHROPIC_API_KEY set. Skip them if the question is sensitive. github.com
Some tools look up named people
Election datasets list named candidates, and the Portal da Transparencia tools search public servants, their pay, sanctions and politically exposed persons, and include a CPF lookup. Use them only for lawful purposes and read the README acceptable-use note. github.com
Big datasets are cached on your disk
If you turn on local datasets, large files are downloaded into a cache folder and queried from there. github.com
Not a government service
The README says this is independent and not official. Each data source has its own terms, and the MIT license covers only the code. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | All data tools only read public data. The documented tools do not write to any service. |
|---|---|
| Talks to | Brazilian government and public data APIs. Anthropic, only for the two helper tools that need ANTHROPIC_API_KEY |
| Sign-in and keys | No account. Optional free keys for a few sources. |
Questions
Is mcp-brasil official?
No. The README says it is an independent project and not an official service of the Brazilian government or the institutions whose data it uses.
Do I need API keys?
No. The README says 66 of the sources work with no key. Free keys for the Portal da Transparencia, DataJud, Meta ads and brapi.dev unlock a few more.
How many tools does it have?
The README counts 533 tools across 70 sources. The list on this page is partial, and the assistant finds the rest through search.
Is it free?
Yes. The code is MIT licensed, and the README says most sources need no key while a few use free keys. Each data source has its own terms.
Does it change anything?
No. The documented tools read public data. Large datasets are cached on your disk if you turn them on.
Does it work in English?
The README and sources are in Portuguese. You can ask in English, but tool descriptions and many results are in Portuguese.
Does it run locally?
Yes. It runs on your computer. A web mode with fastmcp is also described for other clients.
How do I add it to Claude Code?
Use the Claude Code tab in the install box above.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
mcp-brasil- Registry
- PyPI
- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 0.14.0
- License
- MIT
- Last commit
- Sep 19, 2026
- Open issues
- 19
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com