PlugWiki
mcp-brasil logo

mcp-brasil MCP Server: Brazilian Public Data for Claude, Cursor and Other Apps

CommunityLocal
GetPyPImcp-brasilmcp-brasil/mcp-brasil

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.

Install mcp-brasil

Claude Code

  1. 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. 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_features

  • Suggests 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_tools

  • Plans 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_consulta

  • Runs 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_lote

  • Lists 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_disponiveis

  • Shows 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_atuais

  • Lists 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_estados

  • Looks 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_despesas

  • Searches federal government contracts

    Looks up contracts in the Portal da Transparencia.

    Try: “Find the ten largest federal contracts in 2024.”

    Network · transparencia_buscar_contratos

  • Searches 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

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-onlyAll data tools only read public data. The documented tools do not write to any service.
Talks toBrazilian government and public data APIs. Anthropic, only for the two helper tools that need ANTHROPIC_API_KEY
Sign-in and keysNo 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

GitHubChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.