Passar para o conteúdo principal

JUIT MCP Server — Documentation

Overview

JUIT is a Brazilian legal technology company that provides structured access to judicial data from all levels of the Brazilian court system. The JUIT MCP Server connects AI assistants to this verified legal database.

With this integration you can search court rulings (jurisprudence) and court proceedings across all major Brazilian courts — STF, STJ, TST, TRFs, and all 27 state courts (TJs).

All data comes from official court sources. Never rely on AI-generated legal citations — JUIT returns real rulings with case numbers, dates, and full text verified against official records.

Important: JUIT provides legal data for research purposes only. It does not constitute legal advice. All results should be reviewed and validated by a qualified legal professional before use in any legal proceeding.

Getting Started

Prerequisites

  • A JUIT account with an active subscription (paid or trial)

  • Access to Claude (claude.ai), Cursor, or any MCP-compatible client

Connecting via Claude

  1. Open Claude and go to Settings → MCP Servers

  2. Add a new remote MCP server with the URL:

     https://mcp.juit.io/mcp
  3. When prompted, sign in with your JUIT credentials (via Auth0)

  4. Claude will confirm the connection — you're ready to search

Connecting via Cursor

Add the following to your MCP settings (.cursor/mcp.json):

{
"mcpServers": {
"juit": {
"url": "https://mcp.juit.io/mcp"
}
}
}

Multi-Account Users

If your email is associated with multiple JUIT accounts, Claude will ask you to select which account to use. You can switch accounts at any time by asking Claude to change your active account.

Available Tools

JUIT provides 14 tools organized in three categories:

Account & Server

Tool

Description

whoami

Returns your identity and active account information

select_account

Selects which JUIT account to use (multi-account users)

ping

Checks if the server is active and responding

get_server_info

Returns server name and version

Jurisprudence (Case Law)

Tool

Description

search_jurisprudence

Search verified court rulings across Brazilian courts

get_jurisprudence_artifact

Download the full text or PDF of a ruling

Court Proceedings (Processos)

Tool

Description

search_cases

Search lawsuits by CNJ number, party, lawyer, court, dates, and more

check_case_exists

Check if a case exists by its number

get_case_summary

Get a quick summary of a case's current status

get_case

Get all available data for a case in a single call

list_case_parties

List all parties and their legal representatives

list_case_movements

List procedural movements (rulings, decisions, publications)

list_case_artifacts

List available documents attached to the case

get_case_artifact

Download the content of a specific document

Usage Examples

Searching Jurisprudence

Ask Claude:

"Search for recent STJ rulings about tenant eviction for non-payment"

Claude will call search_jurisprudence with appropriate filters and return verified rulings with case numbers, dates, court, judge, and headnotes (ementas).

You can refine your search:

"Filter only rulings from 2024 onwards, sorted by date"

"Search for STF precedents on freedom of speech in social media"

"Find rulings by judge Alexandre de Moraes about electoral law"

Downloading Full Rulings

After a search, you can ask:

"Show me the full text of the first ruling"

Claude will call get_jurisprudence_artifact to download the complete document (inteiro teor). Text documents are returned directly; PDFs and binary files are delivered as downloadable attachments.

Searching Court Proceedings

Ask Claude:

"Look up all lawsuits involving Banco do Brasil in TJSP"

"Find the case with CNJ number 0001234-56.2024.8.26.0100"

"Search for proceedings where lawyer OAB SP172172 is representing"

"List all federal cases filed against CNPJ 00.000.000/0001-00 in the last year"

Inspecting a Case

Once you have a case number, you can dive deeper:

"Show me all the details of this case"

"Who are the parties and lawyers in this lawsuit?"

"List the recent movements and decisions"

"Download the latest court decision document"

Search Parameters Reference

Jurisprudence Search

Parameter

Description

Example

query

Search terms (required)

"dano moral consumidor"

search_on

Fields to search: headnote, full_text, title

["headnote", "full_text"]

court_code

Court codes

["STF", "STJ"]

trier

Judge/rapporteur name

"Alexandre de Moraes"

order_date_from

Minimum date (format: $gteYYYYMMDD)

$gte20240101

order_date_until

Maximum date (format: $ltYYYYMMDD)

$lt20250101

disable_synonym_on

Disable synonyms on specific fields

["headnote"]

sort_by_field

Sort field: score, order_date, juit_id

order_date

sort_by_direction

Sort direction: asc or desc

desc

next_page_token

Pagination token from previous response

(returned by API)

search_id

Search ID (required after first page)

(returned by API)

Case Search

Parameter

Description

Example

cnj_unique_number

Full CNJ number

0001234-56.2024.8.26.0100

party_name

Party name in the case

"Banco do Brasil"

party_tax_id

CPF or CNPJ (with leading zeros)

00000000000100

representative_oab

Lawyer's OAB number

SP172172

court

Court code

TJSP

justice_segment

Justice segment

JUSTICA_FEDERAL

instance

Court instance

PRIMEIRO_GRAU

updated_from / updated_until

Update period (ISO 8601)

2024-01-01T00:00:00Z

first_filing_from / first_filing_until

Filing period (ISO 8601)

2024-01-01T00:00:00Z

sort_field

Sort field for results

(varies)

next_page_token

Pagination token from previous response

(returned by API)

Supported Courts

Superior Courts

  • STF — Supremo Tribunal Federal (Supreme Court)

  • STJ — Superior Tribunal de Justiça (Superior Court of Justice)

  • TST — Tribunal Superior do Trabalho (Superior Labor Court)

  • TSE — Tribunal Superior Eleitoral (Superior Electoral Court)

  • STM — Superior Tribunal Militar (Superior Military Court)

Federal Regional Courts

  • TRF1 through TRF6 — Tribunais Regionais Federais

State Courts

  • TJAC, TJAL, TJAM, TJAP, TJBA, TJCE, TJDF, TJES, TJGO, TJMA, TJMG, TJMS, TJMT, TJPA, TJPB, TJPE, TJPI, TJPR, TJRJ, TJRN, TJRO, TJRR, TJRS, TJSC, TJSE, TJSP, TJTO — All 27 state courts

Authentication

JUIT uses OAuth 2.0 with Auth0 for secure authentication:

  1. When you first connect, Claude redirects you to the JUIT login page (powered by Auth0)

  2. Sign in with your JUIT email and password

  3. After authentication, Claude receives a secure token to access JUIT on your behalf

  4. The token is automatically refreshed — you won't need to sign in again unless the session expires

Your credentials are never shared with Claude or Anthropic. Authentication is handled entirely through the OAuth 2.0 standard protocol.

Document Downloads

When downloading ruling documents or case artifacts:

  • Text documents (HTML, TXT) are returned directly in the conversation

  • Binary documents (PDF, DOCX, RTF) are delivered as base64-encoded attachments

  • Large files (over 5 MB) return metadata only — download them directly from the court's website

Troubleshooting

Issue

Solution

"Account selection required"

You have multiple JUIT accounts. Ask Claude to list your accounts and select one.

"No account selected"

Call whoami first to verify your identity, then select an account if needed.

Authentication errors

Try disconnecting and reconnecting the MCP server to refresh your session.

Empty search results

Try broader search terms, different courts, or wider date ranges.

API error (HTTP 4xx/5xx)

The JUIT API may be temporarily unavailable. Wait a moment and retry. If the error persists, contact support.

Artifact download fails

Verify the juit_id or artifact_id is correct. Some documents may not be available digitally.

Privacy & Data Handling

  • JUIT only accesses your email address for authentication and account identification

  • Search queries are sent to the JUIT API to retrieve results — they are not stored for profiling

  • No conversation data is collected or retained beyond what is necessary to process your request

  • All communication is encrypted via HTTPS (TLS 1.2+)

  • See our full Privacy Policy for details

Support

Respondeu à sua pergunta?