Br Eli MCP

Official

by matematicsolutions · Python

MCP server for Brazilian federal law: legislation, DataJud, STJ, CARF, TST, TCU citations.

Topics

ai-agentbrazillegallegaltechlegislationmcpmcp-servermodel-context-protocol

README.md7 KBView on GitHub

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

bash

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.

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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