Brazil Case Law & Legal Research MCP: STJ, STF Jurisprudência avatar

Brazil Case Law & Legal Research MCP: STJ, STF Jurisprudência

Pricing

from $20.00 / 1,000 searches

Go to Apify Store
Brazil Case Law & Legal Research MCP: STJ, STF Jurisprudência

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

SiteAcs

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

5 days ago

Last modified

Features

Limited permissionsSingle-tenantServer interface

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)
. Give at least one of 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:

ArgumentWhat it does
queryLegal 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)
partyOnly 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
cnpjA 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
courtboth (default), STJ or STF
decision_typeacordao (default, collegiate judgments with an ementa), monocratica or both
date_from, date_toPublication date range, YYYY-MM-DD
relatorReporting minister, e.g. Nancy Andrighi
case_classe.g. REsp, AREsp, HC (STJ) or RE, ARE, ADI (STF)
max_results1 to 20, default 10 (with full text: 1 to 5, default 3)
include_full_textAdd 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"
}
FieldWhat it holds
citationCourt, case, reporting minister, division, judgment (j.) and publication (publ.) dates
partiesParties 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
summaryThe ementa of an acórdão, or the opening of a monocratic decision, cut at 1,500 characters
tese, temaThesis and theme of repetitive appeals and repercussão geral, when there is one
url, fullTextUrlOfficial record and full text on the court's site
fullText, fullTextIsTruncatedOnly with include_full_text

Pricing

EventPriceWhen
search$0.02A call that returns 1 to 20 decisions
search-with-full-text$0.06A 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 query searches: 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. What party searches: 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 Brasil also 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 in warnings.
  • 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:

  1. 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.
  2. Both courts' party lists are searched for the registered name with its company form, in each spelling the courts index: BANCO DO BRASIL SA is sent as BANCO DO BRASIL S.A., S/A, SA and S A, so the bank is found and CAIXA DE ASSISTENCIA DOS FUNCIONARIOS DO BANCO DO BRASIL is not. A status after the name (
    EM RECUPERACAO JUDICIAL
    , EM 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.
  3. Every row with a party list is checked before it is saved: every STF row, and STJ acórdãos when include_full_text is 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 RECUPERACAO
    (PETRÓLEO BRASILEIRO S/A - PETROBRAS passes; 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 check parties or turn on include_full_text when precision matters.
  4. The trade name is searched too when it names the company: it is cut at - (PETROBRAS - EDISE searches PETROBRAS), 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).
  5. Each row carries searchCnpj, searchCompanyName (the razão social) and matchedBy: party when its party list names the company by the rule above, cnpj-text when 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).
  • cnpj together with party. It works alone or with query.

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 as Ind.Com.Ltda. or Ag.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.