# EasyJur — how to use (mcp.ai)

Wrapper da API oficial do EasyJur (gestão jurídica): processos (e partes, pedidos, financeiros, documentos, mensagens), pessoas, agenda, oportunidades, timesheet, financeiro (receitas/despesas), grupos e usuários. Leitura + criação de processos, pessoas, agenda e oportunidades. Autenticação por token de API do escritório.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/easyjur/agenda/comentarios` — Comentários de um item de agenda.
  - body: { id_agenda: string, query?: object }
- `POST https://api.mcp.ai/api/easyjur/agenda/envolvidos` — Envolvidos em um item de agenda.
  - body: { agenda_id: string, query?: object, agenda_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/agenda/etapas` — Etapas de workflow de um item de agenda.
  - body: { agenda_id: string, query?: object, agenda_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/api/status` — Status da API EasyJur do escritório autenticado (identidade + limites).
  - body: { query?: object }
- `POST https://api.mcp.ai/api/easyjur/create/agenda` — Cria item de agenda. Obrigatórios: tipo, id_advogado. Vincule a um processo (campo `processo`) para registrar uma movimentação/atualização.
  - body: { tipo: string, id_advogado: string, descricao?: string, data?: string, data_fim?: string, hora_inicio?: string, hora_fim?: string, status?: string, processo?: string, cliente?: string, local?: string, extra?: object }
- `POST https://api.mcp.ai/api/easyjur/create/oportunidade` — Cria oportunidade. Obrigatórios: nome, status, responsavel, cliente.
  - body: { nome: string, status: string, responsavel: string, cliente: string, valor_total?: string, data_atendimento?: string, extra?: object }
- `POST https://api.mcp.ai/api/easyjur/create/pessoa` — Cria uma pessoa. Obrigatórios: nome, fisica_juridica.
  - body: { nome: string, fisica_juridica: string, apelido?: string, cpf?: string, cnpj?: string, email?: string, celular?: string, extra?: object }
- `POST https://api.mcp.ai/api/easyjur/create/processo` — Cria um processo. Obrigatórios: numero, id_advogado. (A API oficial não tem update — para registrar movimentação use easyjur_create_agenda vinculada ao processo.)
  - body: { numero: string, id_advogado: string, outro_numero?: string, titulo_acao?: string, id_cliente?: string, id_contrario?: string, tipo_processo?: string, extra?: object }
- `POST https://api.mcp.ai/api/easyjur/get/agenda` — Busca um item de agenda por ID.
  - body: { agenda_id: string, query?: object, agenda_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/despesa` — Busca uma despesa por ID.
  - body: { despesa_id: string, query?: object, despesa_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/grupo` — Busca um grupo por ID.
  - body: { grupo_id: string, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/oportunidade` — Busca uma oportunidade por ID.
  - body: { oportunidade_id: string, query?: object, oportunidade_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/pessoa` — Busca uma pessoa por ID.
  - body: { pessoa_id: string, query?: object, pessoa_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/processo` — Busca um processo por ID (dados completos).
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/receita` — Busca uma receita por ID.
  - body: { receita_id: string, query?: object, receita_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/timesheet` — Detalha um lançamento de timesheet.
  - body: { id: string, query?: object, ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/token` — Consulta um token de API por ID.
  - body: { token_id: string, query?: object, token_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/get/user` — Busca um usuário por ID.
  - body: { user_id: string, query?: object, user_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/agenda` — Lista itens de agenda (prazos, compromissos, tarefas).
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/agenda/grupo` — Lista agenda de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/despesas` — Lista despesas.
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/despesas/grupo` — Lista despesas de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/grupos` — Lista grupos (pastas/áreas).
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/oportunidades` — Lista oportunidades (CRM/pré-venda).
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/oportunidades/grupo` — Lista oportunidades de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/pessoas` — Lista pessoas (clientes, contrários, terceiros).
  - body: { page?: integer, page_size?: integer, nome?: string, cpf?: string, cnpj?: string, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/pessoas/grupo` — Lista pessoas de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/processos` — Lista/busca processos. Filtros úteis: numero, nome_parte, cpf, cnpj, advogado_nome, status, comarca, uf, data_inicio, data_fim, movimentacao, dias_movimentacao. Demais filtros via `query`.
  - body: { page?: integer, page_size?: integer, numero?: string, nome_parte?: string, cpf?: string, cnpj?: string, advogado_nome?: string, status?: string, comarca?: string, uf?: string, data_inicio?: string, data_fim?: string, movimentacao?: string, dias_movimentacao?: string, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/processos/grupo` — Lista processos de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/receitas` — Lista receitas.
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/receitas/grupo` — Lista receitas de um grupo.
  - body: { grupo_id: string, page?: integer, page_size?: integer, query?: object, grupo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/list/timesheet` — Lista lançamentos de timesheet.
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/tokens` — Lista os tokens de API da empresa.
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/tribunais` — Lista tribunais/órgãos disponíveis.
  - body: { query?: object }
- `POST https://api.mcp.ai/api/easyjur/list/users` — Lista usuários do escritório.
  - body: { page?: integer, page_size?: integer, query?: object }
- `POST https://api.mcp.ai/api/easyjur/processo/documentos` — Documentos de um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/processo/financeiros` — Lançamentos financeiros de um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/processo/mensagens` — Mensagens/andamentos de um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/processo/partes` — Partes de um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/processo/pedidos` — Pedidos de um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }
- `POST https://api.mcp.ai/api/easyjur/processo/vinculados` — Processos vinculados a um processo.
  - body: { processo_id: string, query?: object, processo_ids?: string[] }

## Example prompts
- "Busque o processo número X no EasyJur e mostre as últimas mensagens"
- "Liste processos com movimentação nos últimos 7 dias"
- "Crie um item de agenda vinculado ao processo Y para registrar a movimentação"

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