Back to Browse
Free
Server data from the Official MCP Registry
MCP server for Brazilian federal law: legislation, DataJud, STJ, CARF, TST, TCU citations.
About
MCP server for Brazilian federal law: legislation, DataJud, STJ, CARF, TST, TCU citations.
Security Report
5.2
Moderate5.2Moderate RiskWell-structured MCP server for Brazilian legal data APIs with proper authentication handling, input validation, and error management. The server makes keyless API calls to public Brazilian government data sources and includes audit logging. Minor code quality observations noted but no security vulnerabilities found. Supply chain analysis found 6 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.
3 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
~/.matematic/cache/br-eli
Environment variable: BR_ELI_CACHE_DIR
~/.matematic/audit
Environment variable: BR_ELI_AUDIT_DIR
https://dadosabertos.camara.leg.br/api/v2
Environment variable: BR_ELI_BASE_URL
https://legis.senado.leg.br/dadosabertos
Environment variable: BR_ELI_NORMA_BASE_URL
https://normas.leg.br/api/public
Environment variable: BR_ELI_TEXT_BASE_URL
https://api-publica.datajud.cnj.jus.br
Environment variable: BR_ELI_DATAJUD_BASE_URL
https://dadosabertos.web.stj.jus.br
Environment variable: BR_ELI_STJ_BASE_URL
https://acordaos.economia.gov.br/solr/acordaos2/select
Environment variable: BR_ELI_CARF_BASE_URL
https://jurisprudencia-backend2.tst.jus.br
Environment variable: BR_ELI_TST_BASE_URL
https://pesquisa.apps.tcu.gov.br/rest/publico/base/acordao-completo
Environment variable: BR_ELI_TCU_BASE_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-matematicsolutions-br-eli-mcp": {
"env": {
"BR_ELI_BASE_URL": "your-br-eli-base-url-here",
"BR_ELI_AUDIT_DIR": "your-br-eli-audit-dir-here",
"BR_ELI_CACHE_DIR": "your-br-eli-cache-dir-here",
"BR_ELI_STJ_BASE_URL": "your-br-eli-stj-base-url-here",
"BR_ELI_TCU_BASE_URL": "your-br-eli-tcu-base-url-here",
"BR_ELI_TST_BASE_URL": "your-br-eli-tst-base-url-here",
"BR_ELI_CARF_BASE_URL": "your-br-eli-carf-base-url-here",
"BR_ELI_TEXT_BASE_URL": "your-br-eli-text-base-url-here",
"BR_ELI_NORMA_BASE_URL": "your-br-eli-norma-base-url-here",
"BR_ELI_DATAJUD_BASE_URL": "your-br-eli-datajud-base-url-here"
},
"args": [
"br-eli-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
br-eli-mcp
MCP server for eight keyless, no-registration Brazilian open-data APIs:
- Camara dos Deputados (
dadosabertos.camara.leg.br) - the federal legislative process: bills (proposicoes) as they move through committees and floor votes. - Congresso Nacional Dados Abertos Legislativos (
legis.senado.leg.br/dadosabertos) - the real LexML URN Lex resolver for enacted Normas Juridicas (laws, decrees, constitutional amendments): identification, Diario Oficial da Uniao publication provenance, amendment history, STF unconstitutionality notes. - normas.leg.br - the full-text companion to (2): real article-by-article text of enacted legislation, addressed by the same URN Lex.
- DataJud CNJ (
api-publica.datajud.cnj.jus.br) - court DOCKET metadata (not ruling text) across STJ/TST/TSE/TRFs/TJs/TRTs/TREs and military courts. - STJ Open Data Portal (
dadosabertos.web.stj.jus.br) - real acordao (ruling) full text + ementa (headnote) from the Superior Tribunal de Justica, Brazil's second-highest court. Coverage starts May 2022. - CARF (
acordaos.economia.gov.br) - real acordao (tax ruling) full text from Brazil's federal tax appeals board, by exact docket/decision number. - TST (
jurisprudencia-backend2.tst.jus.br) - real ruling full text (inteiro teor) + ementa from the Tribunal Superior do Trabalho, Brazil's labor supreme court: free-text search and exact CNJ-process-number lookup (3,751,594 acordaos, 8,483,448 documents across all types - verified live 2026-07-07). - TCU (
pesquisa.apps.tcu.gov.br) - real acordao full text (deliberation, rapporteur's report, vote) from the Tribunal de Contas da Uniao, the Federal Court of Accounts - public-procurement jurisprudence (525,620 acordaos - verified live 2026-07-07).
What this is (and isn't)
br_get_norma resolves a urn:lex:br:... against the Senado's own API gateway
(public, no key or registration) and returns identification, publication provenance,
and amendment history. br_get_norma_index + br_get_norma_texto resolve the same
URN against normas.leg.br's structured Legislation tree for the real text of one
article - not a summary. See DISCOVERY.md for how both endpoints were
found: v0.1.0 tested the wrong host for identification and wrongly reported it as
unconfirmed; v0.2.0 fixed that but still lacked full text; v0.3.0 found the
full-text API on the same domain as the human-readable citation page.
This connector does not scrape Planalto (planalto.gov.br) HTML - no confirmed
mechanical rule maps a URN Lex to a Planalto URL for every act type, and fabricating
one would risk the citation-hallucination failure mode this fleet exists to prevent.
Re-verified live 2026-07-07: legislacao.presidencia.gov.br (the REFLEGIS portal
the manifest names) does not return a plain HTTP response to a keyless client at
all - the connection is accepted but the request times out with zero bytes
received, consistent with a bot-challenge/WAF in front of it, not a structured API.
A minority of act types (mostly decrees) have no inline text in normas.leg.br
either; for those, see DISCOVERY.md.
For case law, DataJud (docket metadata only, redistribution restricted by CNJ
Resolution 446/2022), the STJ Open Data Portal (real acordao text, May 2022+),
CARF (real tax-ruling text, exact lookup only), TST (real ruling text - free-text
search and exact CNJ-process-number lookup, both confirmed live 2026-07-07 after
a browser network trace of the real frontend revealed the request fields the
earlier reverse-engineering missed) and TCU (real acordao/relatorio/voto text)
are wired in below. TRF4/TRF5 were probed and rejected - their hosts never accept
a connection from outside Brazil (geo_restricted) - and RFB's sijut2consulta is
a scrape-class HTML app with no JSON backend. See DISCOVERY.md
for the exact probes run and each confirmed request/response contract.
Tools
| Tool | Purpose |
|---|---|
br_search_proposicoes | List bills by type (PL, PLP, PEC, ...) and year |
br_get_proposicao | Full detail + current status for one bill by id |
br_get_norma | Resolve an enacted Norma Juridica by URN Lex - identification, DOU provenance, amendment history, STF notes |
br_get_norma_index | List the addressable structure of a Norma (parts, books, titles, chapters, sections, articles) |
br_get_norma_texto | Fetch the real text of one article (dispositivo) of a Norma |
br_search_processos | Search court dockets (metadata only) in one tribunal's DataJud CNJ index |
br_get_processo | Fetch one court docket by exact CNJ unified process number |
br_search_case_stj | Search STJ acordaos (real ruling text) by process number or free text |
br_get_case_stj | Fetch one STJ acordao by exact process number - ementa + ruling body text |
br_get_case_carf | Fetch one CARF tax acordao by exact docket or decision number - ementa + ruling body text |
br_search_case_tst | Search TST labor-court rulings by free text (real ruling text; 3.75M acordaos) |
br_get_case_tst | Fetch one TST ruling by exact CNJ unified process number - ementa + inteiro teor |
br_search_case_tcu | Search TCU (Federal Court of Accounts) acordaos by free text (525K acordaos) |
br_get_case_tcu | Fetch one TCU acordao by (numero, ano, colegiado) - deliberation + report + vote text |
Bill type codes (sigla_tipo), for reference:
| Code | Portuguese | English |
|---|---|---|
PL | Projeto de Lei | ordinary bill |
PLP | Projeto de Lei Complementar | complementary-law bill (implements a constitutional provision) |
PEC | Proposta de Emenda a Constituicao | constitutional amendment proposal |
Every response carries lex_uri, human_readable_citation and source_url.
For br_search_proposicoes/br_get_proposicao, lex_uri is Camara's own stable
API URI (not a URN Lex - a bill isn't enacted law yet). For br_get_norma,
lex_uri is the real urn:lex:br:... you queried with, e.g.
"urn:lex:br:federal:lei:2002-01-10;10406" (Codigo Civil). For br_get_norma_texto,
lex_uri is that URN plus the article suffix, e.g. "...;10406!art5".
Install
pip install br-eli-mcp
Configuration
| Env var | Default |
|---|---|
BR_ELI_CACHE_DIR | ~/.matematic/cache/br-eli |
BR_ELI_AUDIT_DIR | ~/.matematic/audit |
BR_ELI_BASE_URL | https://dadosabertos.camara.leg.br/api/v2 |
BR_ELI_NORMA_BASE_URL | https://legis.senado.leg.br/dadosabertos |
BR_ELI_TEXT_BASE_URL | https://normas.leg.br/api/public |
BR_ELI_DATAJUD_BASE_URL | https://api-publica.datajud.cnj.jus.br |
BR_ELI_STJ_BASE_URL | https://dadosabertos.web.stj.jus.br |
BR_ELI_CARF_BASE_URL | https://acordaos.economia.gov.br/solr/acordaos2/select |
BR_ELI_TST_BASE_URL | https://jurisprudencia-backend2.tst.jus.br |
BR_ELI_TCU_BASE_URL | https://pesquisa.apps.tcu.gov.br/rest/publico/base/acordao-completo |
License
Apache-2.0 (code). The Camara dos Deputados open-data API is open data requiring attribution - see SOURCES.md.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
7
Installs
5.3
Security
No ratings yet
Local
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
6
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
536
Installs
8.0
Security
4.8
Local