# DataJud (CNJ) — how to use (mcp.ai)

Consulta pública de processos judiciais do Brasil (metadados + movimentações) via API Pública do CNJ/DataJud, STJ, TST, TSE, STM, TJs, TRFs, TRTs, TREs e Justiça Militar. Sem credencial; hospedado pela plataforma.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_datajud?ms=1781044260000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `datajud_get_processo`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/datajud`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/datajud/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/datajud/get/processo` — Busca um processo pelo número único do CNJ (com ou sem máscara) em um tribunal. Retorna metadados + movimentações de cada instância encontrada.
  - body: { tribunal: string, numero_processo: string }
- `POST https://api.mcp.ai/api/datajud/movimentos` — Retorna apenas a timeline de movimentações (+ metadados) de um processo — ideal pra detectar se houve movimentação nova.
  - body: { tribunal: string, numero_processo: string }
- `POST https://api.mcp.ai/api/datajud/raw/query` — Avançado: envia um corpo de query Elasticsearch cru pro índice do tribunal (escape hatch). Use search_after pra paginar além de 10k. Resposta inclui raw_data.
  - body: { tribunal: string, query: string, size?: integer, from?: integer, sort?: string, search_after?: string }
- `POST https://api.mcp.ai/api/datajud/search` — Busca processos em um tribunal por classe, órgão julgador e/ou assunto (códigos das tabelas do CNJ), paginada e ordenada por data de ajuizamento. DataJud NÃO indexa nome de parte nem OAB — pra isso us
  - body: { tribunal: string, classe_codigo?: integer, orgao_julgador_codigo?: integer, assunto_codigo?: integer, numero_processo?: string, size?: integer, from?: integer, sort_desc?: boolean }

## Example prompts
- "Busque o processo 1000887-07.2025.8.26.0352 no TJSP"
- "Liste as movimentações desse processo e diga se houve algo novo"
- "Quais processos da classe 7 (Procedimento Comum Cível) mais recentes no TRF1?"

## More
- Page: https://mcp.ai/datajud
- Agent spec (llms.txt): https://mcp.ai/datajud/llms.txt
- Postman collection: https://mcp.ai/datajud/postman.json