# Projuris ADV — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/projuris

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_projuris?ms=1781045760000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/projuris/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/projuris/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/projuris/skill.md
Postman collection (v2.1): https://mcp.ai/projuris/postman.json

## Tools
- projuris_consulta(recurso: string, filtro?: object, pagina?: integer, quantidade_registros?: integer) — 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.
- projuris_consulta_apontamento_horas(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Apontamento de horas (timesheet) por filtro (POST /apontamento-horas/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_assunto(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Assuntos/matérias por filtro (POST /assunto/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_atendimento(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Atendimentos (CRM/relacionamento) por filtro (POST /atendimento/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_contrato(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Contratos (honorários) por filtro (POST /contrato/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_intimacao(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Intimações/publicações por filtro (POST /intimacao/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_pessoa(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Pessoas (clientes, partes, advogados, contatos) por filtro (POST /pessoa/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_processo(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Processos/casos (judicial e extrajudicial) por filtro (POST /processo/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_receita_despesa(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Financeiro: receitas e despesas por filtro (POST /receita-despesa/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_consulta_usuario(filtro?: object, pagina?: integer, quantidade_registros?: integer) — Busca Usuários do escritório por filtro (POST /usuario/consulta). `filtro` = critérios conforme a API; pagine com pagina/quantidade_registros.
- projuris_create_andamento(data: object) — Cria um(a) Andamentos/movimentações do processo (POST /andamento). `data` = corpo conforme a API oficial.
- projuris_create_apontamento_horas(data: object) — Cria um(a) Apontamento de horas (timesheet) (POST /apontamento-horas). `data` = corpo conforme a API oficial.
- projuris_create_atendimento(data: object) — Cria um(a) Atendimentos (CRM/relacionamento) (POST /atendimento). `data` = corpo conforme a API oficial.
- projuris_create_pessoa(data: object) — Cria um(a) Pessoas (clientes, partes, advogados, contatos) (POST /pessoa). `data` = corpo conforme a API oficial.
- projuris_create_processo(data: object) — Cria um(a) Processos/casos (judicial e extrajudicial) (POST /processo). `data` = corpo conforme a API oficial.
- projuris_create_tarefa(data: object) — Cria um(a) Tarefas (compromissos, prazos, providências) (POST /tarefa). `data` = corpo conforme a API oficial.
- projuris_create_webhook(data: object) — Cria um(a) Webhooks de integração (POST /webhook). `data` = corpo conforme a API oficial.
- projuris_get(path: string, query?: object) — GET genérico em qualquer recurso REST do Projuris ADV. `path` (ex.: "/processo/123") + `query` opcional. Use para recursos sem tool nomeada.
- projuris_get_apontamento_horas(codigo: string, query?: object) — Busca um(a) Apontamento de horas (timesheet) por código (GET /apontamento-horas/{codigo}).
- projuris_get_arquivo(codigo: string, query?: object) — Busca um(a) Arquivos/documentos (GED). Download em /arquivo/download/{codigo} por código (GET /arquivo/{codigo}).
- projuris_get_assunto(codigo: string, query?: object) — Busca um(a) Assuntos/matérias por código (GET /assunto/{codigo}).
- projuris_get_atendimento(codigo: string, query?: object) — Busca um(a) Atendimentos (CRM/relacionamento) por código (GET /atendimento/{codigo}).
- projuris_get_intimacao(codigo: string, query?: object) — Busca um(a) Intimações/publicações por código (GET /intimacao/{codigo}).
- projuris_get_modelo_documento(codigo: string, query?: object) — Busca um(a) Modelos de documento por código (GET /modelo-documento/{codigo}).
- projuris_get_pessoa(codigo: string, query?: object) — Busca um(a) Pessoas (clientes, partes, advogados, contatos) por código (GET /pessoa/{codigo}).
- projuris_get_processo(codigo: string, query?: object) — Busca um(a) Processos/casos (judicial e extrajudicial) por código (GET /processo/{codigo}).
- projuris_get_receita_despesa(codigo: string, query?: object) — Busca um(a) Financeiro: receitas e despesas por código (GET /receita-despesa/{codigo}).
- projuris_get_usuario(codigo: string, query?: object) — Busca um(a) Usuários do escritório por código (GET /usuario/{codigo}).
- projuris_list_andamento(pagina?: integer, quantidade_registros?: integer, query?: object) — Lista Andamentos/movimentações do processo (GET /andamento). Pagine com pagina/quantidade_registros.
- projuris_list_arquivo(pagina?: integer, quantidade_registros?: integer, query?: object) — Lista Arquivos/documentos (GED). Download em /arquivo/download/{codigo} (GET /arquivo). Pagine com pagina/quantidade_registros.
- projuris_list_tarefa(pagina?: integer, quantidade_registros?: integer, query?: object) — Lista Tarefas (compromissos, prazos, providências) (GET /tarefa). Pagine com pagina/quantidade_registros.
- projuris_list_webhook(pagina?: integer, quantidade_registros?: integer, query?: object) — Lista Webhooks de integração (GET /webhook). Pagine com pagina/quantidade_registros.
- projuris_request(method: string, path: string, query?: object, body?: object) — 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
- projuris_update_apontamento_horas(codigo: string, data: object) — Atualiza um(a) Apontamento de horas (timesheet) (PUT /apontamento-horas/{codigo}). `data` = campos a alterar.
- projuris_update_pessoa(codigo: string, data: object) — Atualiza um(a) Pessoas (clientes, partes, advogados, contatos) (PUT /pessoa/{codigo}). `data` = campos a alterar.
- projuris_update_processo(codigo: string, data: object) — Atualiza um(a) Processos/casos (judicial e extrajudicial) (PUT /processo/{codigo}). `data` = campos a alterar.

## 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"

## Links
Docs: https://mcp.ai/docs/mcps/projuris
Website: https://mcp.ai/mcps/projuris