# LegalOne — MCP server on mcp.ai
> Wrapper da API oficial OData do LegalOne (Thomson Reuters / Novajus, pacote Premium): processos/litígios, contatos, agenda/compromissos, prazos, tarefas, andamentos, documentos, timesheet, financeiro (honorários/receitas/despesas) e campos personalizados. Leitura + criação/edição via OData. Autenticação OAuth2 (client_credentials) provisionada pela Thomson Reuters por escritório. Os nomes de coleção se finalizam contra o $metadata do tenant; tools genéricas cobrem qualquer endpoint.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_legalone?ms=1781045040000
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/legalone/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/legalone/<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/legalone/skill.md
Postman collection (v2.1): https://mcp.ai/legalone/postman.json

## Tools
- legalone_create_appointments(data: object) — Cria um(a) Compromissos/agenda (OData POST /Appointments). `data` = corpo da entidade conforme a API oficial.
- legalone_create_contacts(data: object) — Cria um(a) Contatos (pessoas físicas/jurídicas: clientes, partes, advogados) (OData POST /Contacts). `data` = corpo da entidade conforme a API oficial.
- legalone_create_deadlines(data: object) — Cria um(a) Prazos (OData POST /Deadlines). `data` = corpo da entidade conforme a API oficial.
- legalone_create_litigations(data: object) — Cria um(a) Processos/litígios (contencioso) (OData POST /Litigations). `data` = corpo da entidade conforme a API oficial.
- legalone_create_tasks(data: object) — Cria um(a) Tarefas/providências (OData POST /Tasks). `data` = corpo da entidade conforme a API oficial.
- legalone_create_timeentries(data: object) — Cria um(a) Timesheet (apontamento de horas) (OData POST /TimeEntries). `data` = corpo da entidade conforme a API oficial.
- legalone_create_updates(data: object) — Cria um(a) Andamentos/publicações/atualizações do processo (OData POST /Updates). `data` = corpo da entidade conforme a API oficial.
- legalone_customfield_options(id: string, ids?: string[]) — Opções de um campo personalizado (OData /CustomFieldDefinitions/{id}/options) — resolve o texto de valores listItemId em customFields.
- legalone_get_appointments(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Compromissos/agenda por id (OData /Appointments/{id}). Use $expand para sub-recursos.
- legalone_get_areas(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Áreas de atuação por id (OData /Areas/{id}). Use $expand para sub-recursos.
- legalone_get_contacts(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Contatos (pessoas físicas/jurídicas: clientes, partes, advogados) por id (OData /Contacts/{id}). Use $expand para sub-recursos.
- legalone_get_courts(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Tribunais/órgãos/varas por id (OData /Courts/{id}). Use $expand para sub-recursos.
- legalone_get_customfielddefinitions(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Definições de campos personalizados por id (OData /CustomFieldDefinitions/{id}). Use $expand para sub-recursos.
- legalone_get_deadlines(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Prazos por id (OData /Deadlines/{id}). Use $expand para sub-recursos.
- legalone_get_documents(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Documentos (GED) por id (OData /Documents/{id}). Use $expand para sub-recursos.
- legalone_get_expenses(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Financeiro: despesas/contas a pagar por id (OData /Expenses/{id}). Use $expand para sub-recursos.
- legalone_get_feeagreements(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Contratos de honorários por id (OData /FeeAgreements/{id}). Use $expand para sub-recursos.
- legalone_get_litigations(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Processos/litígios (contencioso) por id (OData /Litigations/{id}). Use $expand para sub-recursos.
- legalone_get_positions(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Instâncias/posições processuais por id (OData /Positions/{id}). Use $expand para sub-recursos.
- legalone_get_receivables(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Financeiro: contas a receber/receitas por id (OData /Receivables/{id}). Use $expand para sub-recursos.
- legalone_get_servicetypes(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Tipos de serviço/processo por id (OData /ServiceTypes/{id}). Use $expand para sub-recursos.
- legalone_get_tasks(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Tarefas/providências por id (OData /Tasks/{id}). Use $expand para sub-recursos.
- legalone_get_timeentries(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Timesheet (apontamento de horas) por id (OData /TimeEntries/{id}). Use $expand para sub-recursos.
- legalone_get_updates(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Andamentos/publicações/atualizações do processo por id (OData /Updates/{id}). Use $expand para sub-recursos.
- legalone_get_users(id: string, $expand?: string, $select?: string, query?: object, ids?: string[]) — Busca um(a) Usuários/responsáveis do escritório por id (OData /Users/{id}). Use $expand para sub-recursos.
- legalone_list_appointments($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Compromissos/agenda (OData /Appointments). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_areas($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Áreas de atuação (OData /Areas). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_contacts($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Contatos (pessoas físicas/jurídicas: clientes, partes, advogados) (OData /Contacts). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_courts($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Tribunais/órgãos/varas (OData /Courts). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_customfielddefinitions($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Definições de campos personalizados (OData /CustomFieldDefinitions). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_deadlines($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Prazos (OData /Deadlines). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_documents($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Documentos (GED) (OData /Documents). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_expenses($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Financeiro: despesas/contas a pagar (OData /Expenses). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_feeagreements($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Contratos de honorários (OData /FeeAgreements). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_litigations($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Processos/litígios (contencioso) (OData /Litigations). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_positions($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Instâncias/posições processuais (OData /Positions). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_receivables($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Financeiro: contas a receber/receitas (OData /Receivables). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_servicetypes($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Tipos de serviço/processo (OData /ServiceTypes). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_tasks($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Tarefas/providências (OData /Tasks). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_timeentries($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Timesheet (apontamento de horas) (OData /TimeEntries). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_updates($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Andamentos/publicações/atualizações do processo (OData /Updates). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_list_users($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object) — Lista Usuários/responsáveis do escritório (OData /Users). Filtre com $filter/$top/$skip/$orderby/$expand.
- legalone_metadata() — Documento OData $metadata (XML) — lista autoritativa de entidades e campos da API do escritório. Útil para descobrir o casing/coleções reais do tenant.
- legalone_odata_get($filter?: string, $expand?: string, $select?: string, $orderby?: string, $top?: integer, $skip?: integer, $count?: boolean, query?: object, entity: string, id?: string, ids?: string[]) — GET genérico em qualquer coleção/recurso OData do LegalOne. Informe `entity` (ex.: "Litigations") e opcionalmente `id`; suporta $filter/$expand/$select/$top/$skip/$orderby. Use isto para entidades não
- legalone_request(method: string, path: string, query?: object, body?: object) — Escape hatch: chamada OData crua. `method` (GET/POST/PATCH/PUT/DELETE) + `path` (ex.: "/Litigations/2479") + `query`/`body` opcionais. Cobre endpoints/ações fora das tools nomeadas.
- legalone_update_appointments(id: string, data: object, ids?: string[]) — Atualiza um(a) Compromissos/agenda (OData PATCH /Appointments/{id}). `data` = campos a alterar.
- legalone_update_contacts(id: string, data: object, ids?: string[]) — Atualiza um(a) Contatos (pessoas físicas/jurídicas: clientes, partes, advogados) (OData PATCH /Contacts/{id}). `data` = campos a alterar.
- legalone_update_litigations(id: string, data: object, ids?: string[]) — Atualiza um(a) Processos/litígios (contencioso) (OData PATCH /Litigations/{id}). `data` = campos a alterar.

## Example prompts
- "Liste os processos do LegalOne com movimentação nos últimos 7 dias"
- "Busque o contato (cliente) X no LegalOne e mostre os processos vinculados"
- "Crie um compromisso na agenda do LegalOne vinculado ao processo Y"

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