# Autos Processuais — how to use (mcp.ai)

Case file documents by CNJ number using the lawyer's own court credential: lists the initial petition, defense, rulings and filings as seen in the court system and downloads them as PDF and text, ready for AI analysis. Covers e-SAJ, eproc, PJe and Projudi with the lawyer's login and password (or A1 certificate). Asynchronous, charged per case.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/autos/get/resultado` — Polling de um job de autos_listar_pecas/autos_obter_pecas. Grátis. status: running|done|error. Em 'done': `processo` (capa), `pecas[]` ({ peca_id, nome, data_juntada, extensao, sigilosa, capturada }) 
  - body: { job_id: string, job_ids?: string[] }
- `POST https://api.mcp.ai/api/autos/list/accounts` — Lista as credenciais de advogado conectadas neste MCP (sistema/tribunal, usuário mascarado, método). Grátis. Use para saber quais tribunais estão cobertos antes de consultar; a conexão usada em cada c
- `POST https://api.mcp.ai/api/autos/listar/pecas` — ÍNDICE DOS AUTOS: lista as peças do processo (petição inicial, contestação, decisões, juntadas) como o advogado conectado as vê no sistema do tribunal, sem baixar o conteúdo. Traz também a capa (parte
  - body: { numero_cnj: string, instancia?: integer }
- `POST https://api.mcp.ai/api/autos/obter/pecas` — DOWNLOAD DAS PEÇAS: captura as peças dos autos no tribunal (lote de até 1.000 por chamada) e, no resultado, entrega até 20 delas como PDF (link temporário) + texto extraído (markdown), prontos para an
  - body: { numero_cnj: string, peca_ids?: string[], formato?: string, instancia?: integer }

## Example prompts
- "List the documents of case 1000887-07.2025.8.26.0352"
- "Download the initial petition and the defense of this case and summarize the claims"
- "Read the latest ruling in the case file and assess whether an appeal makes sense"

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