# AdvBox — MCP server on mcp.ai
> Wrapper da API oficial do AdvBox (software jurídico): processos (e histórico, movimentações, publicações), clientes/contatos, tarefas/anotações e financeiro (transações). Leitura + criação e atualização de processos e transações. Autenticação por token de API do escritório.

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

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

## Tools
- advbox_create_customer(name?: string, email?: string, cpf?: string, cnpj?: string, extra?: object) — Cria um novo contato/cliente. Campos conforme a API oficial (ex.: name, type, cpf/cnpj, email, phone) — envie o restante via `extra`.
- advbox_create_lawsuit(number?: string, extra?: object) — Cria um processo. Campos conforme a API oficial (use advbox_settings para descobrir IDs de tipo/responsável); envie via campos nomeados + `extra`.
- advbox_create_movement(description?: string, extra?: object) — Adiciona uma movimentação manual a um processo. Vincule ao processo (campo conforme a API oficial) + descrição; demais campos via `extra`.
- advbox_create_post(text?: string, extra?: object) — Cria um novo post/anotação. Campos conforme a API oficial via campos nomeados + `extra`.
- advbox_create_transaction(type?: string, value?: string, due_date?: string, extra?: object) — Cria um lançamento financeiro (receita ou despesa). Campos conforme a API oficial (ex.: type, value, due_date) via campos nomeados + `extra`.
- advbox_customers_birthdays(page?: integer, page_size?: integer, query?: object) — Lista aniversariantes (para campanhas de relacionamento).
- advbox_get_customer(id: string, query?: object, ids?: string[]) — Busca os dados completos de um contato por ID.
- advbox_get_lawsuit(id: string, query?: object, ids?: string[]) — Busca um processo por ID (dados completos).
- advbox_get_transaction(id: string, query?: object, ids?: string[]) — Detalha uma transação por ID.
- advbox_last_movements(page?: integer, page_size?: integer, query?: object) — Última atualização de cada processo (resumo recente).
- advbox_lawsuit_history(lawsuit_id: string, page?: integer, page_size?: integer, query?: object, lawsuit_ids?: string[]) — Histórico completo de um processo.
- advbox_lawsuit_movements(lawsuit_id: string, page?: integer, page_size?: integer, query?: object, lawsuit_ids?: string[]) — Lista todas as movimentações de um processo.
- advbox_list_customers(page?: integer, page_size?: integer, name?: string, cpf?: string, cnpj?: string, email?: string, query?: object) — Lista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc. via `query`).
- advbox_list_lawsuits(page?: integer, page_size?: integer, number?: string, cpf?: string, cnpj?: string, status?: string, query?: object) — Lista/busca processos (22+ filtros). Filtros comuns via `query`: numero, parte, cpf, cnpj, responsavel, status, comarca, uf, datas.
- advbox_list_posts(page?: integer, page_size?: integer, query?: object) — Lista posts e anotações (tarefas/notas).
- advbox_list_transactions(page?: integer, page_size?: integer, type?: string, status?: string, start_date?: string, end_date?: string, query?: object) — Lista transações financeiras com filtros de data/tipo/status (via `query`).
- advbox_publications(lawsuit_id: string, page?: integer, page_size?: integer, query?: object, lawsuit_ids?: string[]) — Lista as publicações oficiais de um processo.
- advbox_settings(query?: object) — Obtém todos os IDs e configurações da conta (usuários, origens, tipos de tarefa, fases, tipos de processo). Use para descobrir os IDs exigidos por create/update.
- advbox_update_lawsuit(id: string, extra?: object, ids?: string[]) — Atualiza um processo existente por ID. Envie só os campos a alterar (nomeados + `extra`).
- advbox_update_transaction(id: string, value?: string, due_date?: string, status?: string, extra?: object, ids?: string[]) — Atualiza valor, vencimento ou status de pagamento de uma transação por ID. Envie só os campos a alterar (nomeados + `extra`).

## Example prompts
- "Busque o processo número X no AdvBox e mostre as últimas movimentações"
- "Liste as transações financeiras vencidas este mês"
- "Crie uma movimentação manual no processo Y registrando o andamento"

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