Brazil Case Law & Legal Research MCP: STJ, STF Jurisprudência
Pricing
from $20.00 / 1,000 searches
Brazil Case Law & Legal Research MCP: STJ, STF Jurisprudência
Legal research MCP server and LLM tool for official Brazilian case law (jurisprudência) from the STJ and STF. Search by legal terms, party, lawyer or company CNPJ; one search returns the newest matching decisions as compact JSON: citation, parties, ementa summary, tese, links. Priced per search.
Pricing
from $20.00 / 1,000 searches
Rating
0.0
(0)
Developer
SiteAcs
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
5 days ago
Last modified
Categories
Features
Share
Brazil Case Law MCP: STJ & STF Jurisprudência for AI Agents
In short. Input: one tool call to search_brazil_case_law with legal terms (query), a party or lawyer, or a
company cnpj, plus optional filters. Output: up to 20 of the newest matching STJ and STF decisions as compact JSON.
Price: $0.02 per search (up to 20 decisions), or $0.06 with full text for up to 5 decisions; a search with no results
is free.
MCP endpoint (Streamable HTTP, send your Apify API token as a Bearer token). Config for Claude Desktop, Cursor or any client that takes a JSON config:
{"mcpServers": {"brazil-case-law": {"url": "https://siteacs--brazil-case-law-mcp.apify.actor/mcp","headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }}}}
Tool:
search_brazil_case_law(query, party, cnpj, court, decision_type, date_from, date_to, relator, case_class, max_results, include_full_text)query, party or cnpj; every argument is described under
"The tool" below.
Example arguments (the same fields work as a normal Actor run input in camelCase):
{ "query": "\"dano moral\" bagagem extraviada", "court": "both", "max_results": 5 }
Three fields of one returned decision:
{"citation": "STJ, AgInt no AREsp 2999881/SP, Rel. Min. Maria Isabel Gallotti, Quarta Turma, j. 09/03/2026, publ. 13/03/2026","relator": "MARIA ISABEL GALLOTTI","fullTextUrl": "https://processo.stj.jus.br/SCON/GetInteiroTeorDoAcordao?num_registro=...&dt_publicacao=13/03/2026"}
For bulk exports (hundreds or thousands of decisions, CSV or Excel), use Brazil Court Decisions & Case Law, priced per decision.
A search tool for AI agents and LLM apps that need Brazilian case law (jurisprudência). One call searches the official case-law services of the Superior Tribunal de Justiça (STJ) and the Supremo Tribunal Federal (STF) and returns the newest matching decisions as compact JSON: a ready-to-cite reference, the ementa, the parties and their lawyers, the thesis (tese) and theme (tema) of binding precedents, and links to the official record and full text. Search by legal terms, by a party or lawyer, or both.
It works three ways:
- As an MCP server for Claude, ChatGPT, Cursor or any MCP client: one tool,
search_brazil_case_law. - Through Apify's MCP server (mcp.apify.com), next to other Apify tools.
- As a normal Actor run through the API, n8n, Make or Zapier: one search per run.
You pay per search, not per decision: up to 20 decisions for one search event. A search that finds nothing is free.
Em português
Ferramenta de pesquisa de jurisprudência do STJ e do STF para agentes de IA (servidor MCP) e LLMs. Cada chamada devolve os acórdãos e as decisões monocráticas mais recentes em JSON compacto: citação pronta (tribunal, processo, relator, órgão julgador, datas), partes e advogados, ementa, tese e tema, e links para o registro oficial e o inteiro teor. Os dados vêm das bases oficiais de pesquisa dos tribunais. Pesquisa por termos jurídicos, por parte ou advogado (pesquisa por parte/advogado), por CNPJ de empresa (pesquisa por CNPJ, com a razão social consultada em base pública), ou por termos e parte juntos. Preço por pesquisa: US$ 0,02 por chamada com até 20 decisões, ou US$ 0,06 com o inteiro teor de até 5 decisões. Pesquisa sem resultado não é cobrada.
Connect it as an MCP server
The MCP endpoint is this Actor's Standby URL with the path /mcp (Streamable HTTP):
https://siteacs--brazil-case-law-mcp.apify.actor/mcp
Send your Apify API token as a Bearer token. In Claude Desktop, Cursor or another client that takes a JSON config:
{"mcpServers": {"brazil-case-law": {"url": "https://siteacs--brazil-case-law-mcp.apify.actor/mcp","headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }}}}
Or load it into Apify's own MCP server with https://mcp.apify.com/?tools=siteacs/brazil-case-law-mcp, where the tool
shows up as siteacs--brazil-case-law-mcp--search_brazil_case_law.
An autonomous agent with no Apify account can buy a prepaid, spend-capped Apify token at agi.apify.com (x402 or MPP) and send it as the Bearer token here. Store search marks this server as not taking direct agent payments because it runs in Standby, but the prepaid token works. The batch Actor siteacs/brazil-case-law takes direct agent payments.
The tool
search_brazil_case_law takes:
| Argument | What it does |
|---|---|
query | Legal terms in Portuguese, at most 500 characters. Words are combined with AND; quotes for a phrase; OR / NOT; parentheses to group. Example: "dano moral" bagagem (extravio OR atraso) |
party | Only decisions where this name is listed as a party or a lawyer, e.g. Banco do Brasil, INSS, or a lawyer's name (3 to 200 characters). Matched as a phrase; accents and case ignored |
cnpj | A company CNPJ (00.000.000/0001-91 or 14 digits): decisions that list the company, by its registered name, as a party, or print the CNPJ (pesquisa por CNPJ). Sole traders (MEI) are refused. Not with party |
court | both (default), STJ or STF |
decision_type | acordao (default, collegiate judgments with an ementa), monocratica or both |
date_from, date_to | Publication date range, YYYY-MM-DD |
relator | Reporting minister, e.g. Nancy Andrighi |
case_class | e.g. REsp, AREsp, HC (STJ) or RE, ARE, ADI (STF) |
max_results | 1 to 20, default 10 (with full text: 1 to 5, default 3) |
include_full_text | Add each decision's full text, up to 60,000 characters each (the call takes 30-60 s) |
Give query, party or cnpj, alone or with query (not party and cnpj together). Results come newest first. For a query alone, when more decisions match than were
returned, the answer says how many (totalMatches per court) and suggests how to narrow it (hint). A search with
party returns decisions, not counts: its answer has totalMatches and hint set to null, and the run's status
message gives no number of matches.
Operators can also be typed in lower case or in Portuguese (ou, e, não/nao); outside quotes they are read as
operators at both courts. A query the courts would reject (an unclosed parenthesis or quote, an operator with no
term on one side, an empty group, a lone -) is refused with an error and not charged.
party is cleaned before the search: a trailing company form (S.A., S/A, SA, S A, Ltda, ME, EPP,
EIRELI) is dropped and - is read as a space, so Banco do Brasil S/A searches Banco do Brasil and Coca-Cola
also finds COCA-COLA. A company form mid-name ends it: Petróleo Brasileiro S.A. - Petrobras searches
Petróleo Brasileiro (a bare SA or ME counts mid-name only in an all-capitals name). Dotted numbers (Tema 1.199, HC 598.051) are sent to the STJ as phrases, which its search
needs.
Run it as a normal Actor
The input fields are the same, in camelCase (query, party, court, decisionType, dateFrom, dateTo, relator,
caseClass, maxResults, includeFullText). Example:
{"query": "\"dano moral\" bagagem extraviada","court": "both","maxResults": 5}
Each decision is saved as a dataset item, and the whole answer (decisions, total matches per court and hint for
searches without party, warnings, charged event) under the key-value store key OUTPUT.
Output
One decision, as the tool returns it (summary shortened here):
{"id": "STJ-ACOR-2799402","citation": "STJ, AgInt no AREsp 2999881/SP, Rel. Min. Maria Isabel Gallotti, Quarta Turma, j. 09/03/2026, publ. 13/03/2026","court": "STJ","decisionType": "acordao","processNumber": "AgInt no AREsp 2999881/SP","relator": "MARIA ISABEL GALLOTTI","orgaoJulgador": "Quarta Turma","judgmentDate": "2026-03-09","publicationDate": "2026-03-13","parties": null,"summary": "AGRAVO INTERNO. AGRAVO EM RECURSO ESPECIAL. PROCESSUAL CIVIL. TRANSPORTE AÉREO DE PASSAGEIROS. ATRASO EM VOO INTERNACIONAL. ...","summaryIsTruncated": true,"tese": null,"tema": null,"url": "https://processo.stj.jus.br/SCON/SearchBRS?b=ACOR&livre=2799402...","fullTextUrl": "https://processo.stj.jus.br/SCON/GetInteiroTeorDoAcordao?num_registro=...&dt_publicacao=13/03/2026"}
| Field | What it holds |
|---|---|
citation | Court, case, reporting minister, division, judgment (j.) and publication (publ.) dates |
parties | Parties and their lawyers as the court lists them, one ROLE: NAME entry each (AGDO.(A/S): BANCO DO BRASIL SA). STJ entries keep the lawyer's OAB registration as the PDF prints it (ADVOGADO: NAME - SP123456); STF's lists of a lawyer's registrations in several states ((3600/AC, 9395A/AL, ...)) are left out to save tokens. STF: always. STJ acórdãos: only with include_full_text (read from the PDF). STJ monocratic decisions: null |
summary | The ementa of an acórdão, or the opening of a monocratic decision, cut at 1,500 characters |
tese, tema | Thesis and theme of repetitive appeals and repercussão geral, when there is one |
url, fullTextUrl | Official record and full text on the court's site |
fullText, fullTextIsTruncated | Only with include_full_text |
Pricing
| Event | Price | When |
|---|---|---|
search | $0.02 | A call that returns 1 to 20 decisions |
search-with-full-text | $0.06 | A call with include_full_text that returns 1 to 5 decisions and at least one full text (if no full text comes back in time, it is charged as a plain search) |
A call that finds nothing, has invalid arguments, or cannot reach either court is not charged, and neither is an MCP call whose client disconnected before the answer was ready. If your maximum cost per run does not cover one more event, the call stops and charges nothing. Every run, whether a normal run or an MCP server start, also pays Apify's fixed Actor-start fee ($0.00005). Through the MCP server URL your Apify account also pays the platform usage of the server run until the platform shuts it down after its idle time.
For bulk exports (hundreds or thousands of decisions, every field, CSV or Excel), use Brazil Court Decisions & Case Law instead, priced per decision.
Sources and limits
- Data comes from the courts' public search services, the ones behind scon.stj.jus.br and jurisprudencia.stf.jus.br. Only published decisions are returned. New decisions show up when the courts publish them.
- What
querysearches: at STF, the ementa, indexing, thesis and theme, observation notes, legislation and precedents cited, case number and, for monocratic decisions, the decision text; at STJ, every field SCON searches by default, which includes its party index. Whatpartysearches: only each court's own party list (STF's "Partes" field, STJ's party index, both holding parties and their lawyers), never the decision text. A longer name that contains the phrase also matches (Banco do Brasilalso finds).CASSI - Caixa de Assistência dos Funcionários do Banco do Brasil - Plain searches take 2-10 s. Full-text calls take 30-60 s: STJ full text comes from the official PDF of each
acórdão. A call stops waiting for the courts after 30 s and for PDFs after 40 s; decisions whose full text was
skipped keep their
fullTextUrl, and the answer says so inwarnings. - Broad STJ searches, mostly of monocratic decisions, can be cancelled by the court (Oracle error ORA-01013); the warning names the base. Add terms, a phrase or a date range.
- This is a research tool, not legal advice. Check every decision on the court's site before relying on it.
Company search by CNPJ (pesquisa por CNPJ)
The cnpj argument (the same name in the tool and in a run's input) takes a company's CNPJ, formatted (00.000.000/0001-91) or as 14 digits, and returns decisions about that
company:
- The number is checked (14 digits, valid check digits) and looked up in a free public CNPJ registry built on the
Receita Federal's open data: BrasilAPI first, then Minha Receita
if it does not answer. Only the number is sent, directly, with no proxy. Only the registered name (razão social),
the trade name (nome fantasia), the legal nature and the MEI flag (
opcao_pelo_mei) are read from the answer. - Both courts' party lists are searched for the registered name with its company form, in each spelling the
courts index:
BANCO DO BRASIL SAis sent asBANCO DO BRASIL S.A.,S/A,SAandS A, so the bank is found andCAIXA DE ASSISTENCIA DOS FUNCIONARIOS DO BANCO DO BRASILis not. A status after the name (,EM RECUPERACAO JUDICIALEM LIQUIDACAO EXTRAJUDICIAL) is dropped first. Decisions that print the CNPJ in their text (full text included at STF) are found too; the number alone finds only a handful of decisions per company. - Every row with a party list is checked before it is saved: every STF row, and STJ acórdãos when
include_full_textis on (their party list comes from the PDF). A row is kept only when a party entry, after its role label, starts with the company's name followed by the end, a company form,-,E OUTRO(A/S)or(EM RECUPERACAOPETRÓLEO BRASILEIRO S/A - PETROBRASpasses;PETROBRAS TRANSPORTE S.A. - TRANSPETRO,,FUNDAÇÃO PETROBRAS ...RIO CLARO ...and people named Vale do not), or when the court reports the CNPJ match. Rows that fail are left out of the answer (the answer warns when that happens). STJ rows without a party list (monocratic decisions, and acórdãos without full text) are not verified: SCON matches the phrase anywhere in its party index, so checkpartiesor turn oninclude_full_textwhen precision matters. - The trade name is searched too when it names the company: it is cut at
-(PETROBRAS - EDISEsearchesPETROBRAS), office words at its end are dropped (MATRIZ,SEDE,EST UNIF, ...), and none is searched when it names an office or department (DIRECAO GERAL,DEPARTAMENTO ...), has digits, or repeats the registered name. At the STJ the trade name is sent only where the row can be checked (acórdãos with full text). - Each row carries
searchCnpj,searchCompanyName(the razão social) andmatchedBy:partywhen its party list names the company by the rule above,cnpj-textwhen the CNPJ matched in its text, or null when the row cannot show it (unverified STJ rows).
Refused before any court request, and not charged:
- Natural persons: legal nature 213-5 (empresário individual, which every MEI is), the whole group 4 "pessoas
físicas" (produtor rural, leiloeiro, contribuinte individual, ...), a record without a 4-digit legal nature, the MEI
flag, and a registered name with a run of 8 or more digits (MEI names often hold the owner's CPF). Such a name is
never shown in the log, the error or the answer. Shorter numbers in a company's name are fine (
3M DO BRASIL,B3 S.A.,99 TECNOLOGIA); a trade name with digits is simply not searched. - A CNPJ with wrong check digits, one the registries do not know, or any CNPJ while the registries do not answer (the search is never run without the name).
cnpjtogether withparty. It works alone or withquery.
Like a party search, a CNPJ search returns decisions, not counts (totalMatches and hint are null); the answer names the cnpj and companyName searched. The registry lookup counts against the call's time limit (at most 5 s per registry). CPF numbers stay refused in every field.
Perguntas frequentes
Meu agente de IA consegue fazer pesquisa de jurisprudência nos tribunais superiores?
Sim, no STJ e no STF. Conecte o servidor MCP e peça a search_brazil_case_law os acórdãos sobre um tema: cada chamada
devolve as decisões mais recentes com a citação pronta, a ementa, o relator, o órgão julgador, a tese e o tema, e um
link para o inteiro teor no site do tribunal (ou o próprio inteiro teor, com include_full_text). Nenhum outro tribunal
é pesquisado, e o resultado não substitui a conferência da decisão no site do tribunal. Para exportar muitas decisões
de uma vez, use o Actor Brazil Court Decisions & Case Law.
Official published decisions only
The tool returns decisions the courts publish in their official case-law search, with the fields they publish, including the parties and lawyers they list. It searches one name at a time and returns decisions; it does not build profiles of people or totals per person.
- No CPF search: an argument with 9 or more digits outside the number forms the tool recognises is refused with an
error and not charged, however the digits are punctuated or split; so is a court wildcard (
?,$,*,%,_) next to a digit. Recognised forms, each in its exact printed format: CNJ case numbers, CNPJs, STJ registration numbers,R$amounts below R$ 100 million, dates, years, OAB numbers, and numbers right after a case class or statute word (REsp 1.810.170/RS,Tema 1.199,lei 8.112/90). Numbers side by side count together: put a word between them (arts. 165, 458 e 535). Write amounts of R$ 100 million or more in millions (R$ 150 milhões). - CPF numbers printed in court texts are masked (
***.***.***-**) in every field of the answer, however they are punctuated (nº.123.456.789-09,123.456.789- 09,123456789-09), with or without the word "CPF" before them. - SCON field syntax typed into an argument (
.TXT.,.PART.or[PART], also with spaces before them,inpath(...),@references) is refused and not charged. Abbreviations such asInd.Com.Ltda.orAg.Rg.are fine. - Court decisions name private people. Under the LGPD (Lei 13.709/2018) the buyer needs a lawful purpose for processing them: legal research, litigation and compliance work are typical; screening job applicants or tenants, or building profiles of people, are not uses this tool is meant for.