# Projuris ADV — how to use (mcp.ai)

Wrapper da API REST oficial do Projuris ADV (gestão jurídica): processos, pessoas (clientes/partes), tarefas (prazos/compromissos), andamentos, apontamento de horas (timesheet), arquivos (GED), contratos de honorários, assuntos, intimações, atendimentos, financeiro (receitas/despesas) e usuários. Leitura, busca e criação/edição via REST. Autenticação OAuth2 (client_credentials) com client_id/secret fornecidos pelo suporte ao contratar a API (planos Premium). Tools genéricas cobrem os 757 recursos da API.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/projuris/consulta` — Busca genérica: POST /<recurso>/consulta com `filtro` (corpo). `recurso` = nome kebab-case (ex.: "processo", "pessoa", "intimacao"). Use para entidades sem tool de consulta nomeada.
  - body: { recurso: string, filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/apontamento/horas` — Busca Apontamento de horas (timesheet) por filtro (POST /apontamento-horas/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/assunto` — Busca Assuntos/matérias por filtro (POST /assunto/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/atendimento` — Busca Atendimentos (CRM/relacionamento) por filtro (POST /atendimento/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/contrato` — Busca Contratos (honorários) por filtro (POST /contrato/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/intimacao` — Busca Intimações/publicações por filtro (POST /intimacao/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/pessoa` — Busca Pessoas (clientes, partes, advogados, contatos) por filtro (POST /pessoa/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/processo` — Busca Processos/casos (judicial e extrajudicial) por filtro (POST /processo/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/receita/despesa` — Busca Financeiro: receitas e despesas por filtro (POST /receita-despesa/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/consulta/usuario` — Busca Usuários do escritório por filtro (POST /usuario/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
  - body: { filtro?: object, pagina?: integer, quantidade_registros?: integer }
- `POST https://api.mcp.ai/api/projuris/create/andamento` — Cria um(a) Andamentos/movimentações do processo (POST /andamento). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/apontamento/horas` — Cria um(a) Apontamento de horas (timesheet) (POST /apontamento-horas). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/atendimento` — Cria um(a) Atendimentos (CRM/relacionamento) (POST /atendimento). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/pessoa` — Cria um(a) Pessoas (clientes, partes, advogados, contatos) (POST /pessoa). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/processo` — Cria um(a) Processos/casos (judicial e extrajudicial) (POST /processo). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/tarefa` — Cria um(a) Tarefas (compromissos, prazos, providências) (POST /tarefa). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/create/webhook` — Cria um(a) Webhooks de integração (POST /webhook). `data` = corpo conforme a API oficial.
  - body: { data: object }
- `POST https://api.mcp.ai/api/projuris/get` — GET genérico em qualquer recurso REST do Projuris ADV. `path` (ex.: "/processo/123") + `query` opcional. Use para recursos sem tool nomeada.
  - body: { path: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/apontamento/horas` — Busca um(a) Apontamento de horas (timesheet) por código (GET /apontamento-horas/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/arquivo` — Busca um(a) Arquivos/documentos (GED). Download em /arquivo/download/{codigo} por código (GET /arquivo/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/assunto` — Busca um(a) Assuntos/matérias por código (GET /assunto/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/atendimento` — Busca um(a) Atendimentos (CRM/relacionamento) por código (GET /atendimento/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/intimacao` — Busca um(a) Intimações/publicações por código (GET /intimacao/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/modelo/documento` — Busca um(a) Modelos de documento por código (GET /modelo-documento/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/pessoa` — Busca um(a) Pessoas (clientes, partes, advogados, contatos) por código (GET /pessoa/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/processo` — Busca um(a) Processos/casos (judicial e extrajudicial) por código (GET /processo/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/receita/despesa` — Busca um(a) Financeiro: receitas e despesas por código (GET /receita-despesa/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/get/usuario` — Busca um(a) Usuários do escritório por código (GET /usuario/{codigo}).
  - body: { codigo: string, query?: object }
- `POST https://api.mcp.ai/api/projuris/list/andamento` — Lista Andamentos/movimentações do processo (GET /andamento). Pagine com pagina/quantidade_registros.
  - body: { pagina?: integer, quantidade_registros?: integer, query?: object }
- `POST https://api.mcp.ai/api/projuris/list/arquivo` — Lista Arquivos/documentos (GED). Download em /arquivo/download/{codigo} (GET /arquivo). Pagine com pagina/quantidade_registros.
  - body: { pagina?: integer, quantidade_registros?: integer, query?: object }
- `POST https://api.mcp.ai/api/projuris/list/tarefa` — Lista Tarefas (compromissos, prazos, providências) (GET /tarefa). Pagine com pagina/quantidade_registros.
  - body: { pagina?: integer, quantidade_registros?: integer, query?: object }
- `POST https://api.mcp.ai/api/projuris/list/webhook` — Lista Webhooks de integração (GET /webhook). Pagine com pagina/quantidade_registros.
  - body: { pagina?: integer, quantidade_registros?: integer, query?: object }
- `POST https://api.mcp.ai/api/projuris/request` — Escape hatch: chamada REST crua à API Projuris ADV. `method` (GET/POST/PUT/DELETE/PATCH) + `path` (ex.: "/processo/123" ou "/v2/processo/consulta") + `query`/`body` opcionais. Cobre os 757 recursos, i
  - body: { method: string, path: string, query?: object, body?: object }
- `POST https://api.mcp.ai/api/projuris/update/apontamento/horas` — Atualiza um(a) Apontamento de horas (timesheet) (PUT /apontamento-horas/{codigo}). `data` = campos a alterar.
  - body: { codigo: string, data: object }
- `POST https://api.mcp.ai/api/projuris/update/pessoa` — Atualiza um(a) Pessoas (clientes, partes, advogados, contatos) (PUT /pessoa/{codigo}). `data` = campos a alterar.
  - body: { codigo: string, data: object }
- `POST https://api.mcp.ai/api/projuris/update/processo` — Atualiza um(a) Processos/casos (judicial e extrajudicial) (PUT /processo/{codigo}). `data` = campos a alterar.
  - body: { codigo: string, data: object }

## Example prompts
- "Busque no Projuris os processos com andamento nos últimos 7 dias"
- "Encontre a pessoa (cliente) X no Projuris e mostre os processos vinculados"
- "Crie um apontamento de horas no Projuris vinculado ao processo Y"

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