MCP Juridico Brasil — Claude Code MCP server: how to install
Connects AI coding assistants to Brazil's DataJud CNJ platform to inspect lawsuits, track proceedings, and calculate procedural deadlines under the CPC.
claude mcp add mcp-juridico-brasil -- uvx mcp-juridico-brasilWhat MCP Juridico Brasil does
This server registers 9 tools to interface with the unified DataJud CNJ database across Brazilian courts. It includes reference codes for 92 courts covering federal and state jurisdictions. Models can retrieve case details via standard CNJ identifiers and prepare summaries of recent docket updates.
Deadline math follows CPC articles 219, 220, and 224, factoring in national holidays and judicial recess periods. Local state holidays apply only when you supply the uf field. Interacting with the electronic judicial domicile requires separate API credentials, and confirming subpoena delivery carries enforceable legal effects.
Running the service demands Python 3.10+ and uvx. The server functions out of the box using CNJ's active public key, so setting DATAJUD_API_KEY is only necessary when authorities rotate that credential.
What it helps with
- retrieve court records by CNJ case number
- compute procedural deadlines in business days under Brazilian CPC rules
- track new case dockets since a specific date
- inspect electronic summons notifications from DJe
Example prompts for the agent
- Look up case number
0000001-00.2024.5.02.0000in DataJud - Calculate a 15-day procedural deadline starting on
2024-03-01for stateSP - Summarize recent docket updates for case
1234567-89.2023.8.26.0100
How to install MCP Juridico Brasil
Platform CLI
claude mcp add mcp-juridico-brasil -- uvx mcp-juridico-brasiluvx runs the command named after the package; if the README names another one, use uvx --from mcp-juridico-brasil <command>
Platform CLI
codex mcp add mcp-juridico-brasil -- uvx mcp-juridico-brasiluvx runs the command named after the package; if the README names another one, use uvx --from mcp-juridico-brasil <command>
Config file
{
"mcpServers": {
"mcp-juridico-brasil": {
"command": "uvx",
"args": [
"mcp-juridico-brasil"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-juridico-brasil <command>
Config file
{
"servers": {
"mcp-juridico-brasil": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-juridico-brasil"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-juridico-brasil <command>
Platform CLI
gemini mcp add mcp-juridico-brasil uvx mcp-juridico-brasiluvx runs the command named after the package; if the README names another one, use uvx --from mcp-juridico-brasil <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MCP Juridico Brasil
How to install MCP Juridico Brasil in Claude Code?
Run claude mcp add mcp-juridico-brasil -- uvx mcp-juridico-brasil in your terminal. You must have uvx available on your system.
What does MCP Juridico Brasil do?
It gives your AI agent direct access to Brazil's DataJud CNJ legal system to inspect lawsuit proceedings, list dockets, and calculate statutory deadlines.
Is a DATAJUD_API_KEY required to run queries?
No, the server ships with CNJ's current public access key. You only need to pass DATAJUD_API_KEY if the CNJ rotates their public key.
