# DJEN (Diário de Justiça) — how to use (mcp.ai)

Diário de Justiça Eletrônico Nacional (CNJ) — publicações e intimações judiciais. Busca por OAB, nome de advogado, número de processo, tribunal e data; cada resultado traz o texto completo e o link da certidão. Sem credencial; hospedado pela plataforma. (Diário de Justiça — não é base de jurisprudência/ementas.)

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_djen?ms=1781045220000`
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. `djen_get_certidao`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/djen`
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/djen/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/djen/get/certidao` — Retorna a URL da certidão (PDF) de uma comunicação do DJEN pelo seu hash (campo `hash` retornado na busca).
  - body: { hash: string }
- `POST https://api.mcp.ai/api/djen/processos/por/parte` — DESCOBERTA por NOME de parte (grátis, sem captcha): busca o DJEN por quem figura no processo e agrupa por número — devolve a lista de processos da pessoa/empresa, com partes e tribunal. Cobre processo
  - body: { nome_parte: string, sigla_tribunal?: string, data_inicio?: string, data_fim?: string, itens_por_pagina?: integer, pagina?: integer }
- `POST https://api.mcp.ai/api/djen/search/comunicacoes` — Busca publicações/intimações no Diário de Justiça Eletrônico Nacional (DJEN) por OAB, nome de advogado, número de processo, tribunal e data. Cada item traz o texto completo da comunicação. (É o Diário
  - body: { numero_oab?: string, uf_oab?: string, nome_advogado?: string, nome_parte?: string, numero_processo?: string, sigla_tribunal?: string, data_inicio?: string, data_fim?: string, meio?: string, texto?: string, pagina?: integer, itens_por_pagina?: integer }

## Example prompts
- "Busque publicações da OAB 21076/SP nos últimos 7 dias"
- "Tem intimação para o processo 0208428-37.2007.8.26.0100?"
- "Publicações do TST de hoje sobre determinado advogado"

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