AdvBox

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Wrapper for the official AdvBox API (legal practice management): cases (with history, movements, pub

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "AdvBox": {
      "url": "https://api.mcp.ai/p_advbox",
      "transport": "streamable-http"
    }
  }
}

Measured tools (26)

• advbox_settings read-only

  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.

  Parameters:

  • query — object

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_list_customers read-only

  Lista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc. via `query`).

  Parameters:

  • cpf — string
  • cnpj — string
  • name — string
  • page — number
  • email — string
  • query — object
  • page_size — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_get_customer read-only

  Busca os dados completos de um contato por ID. Bulk support: accepts ids for batched execution.

  Parameters:

  • id (required)
  • ids — array
  • query — object

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_customers_birthdays read-only

  Lista aniversariantes (para campanhas de relacionamento).

  Parameters:

  • page — number
  • query — object
  • page_size — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_create_customer

  Cria um novo contato/cliente. Campos conforme a API oficial (ex.: name, type, cpf/cnpj, email, phone) — envie o restante via `extra`.

  Parameters:

  • cpf — string
  • cnpj — string
  • name — string
  • email — string
  • extra — object

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_list_lawsuits read-only

  Lista/busca processos (22+ filtros). Filtros comuns via `query`: numero, parte, cpf, cnpj, responsavel, status, comarca, uf, datas.

  Parameters:

  • cpf — string
  • cnpj — string
  • page — number
  • query — object
  • number — string
  • status — string
  • page_size — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_get_lawsuit read-only

  Busca um processo por ID (dados completos). Bulk support: accepts ids for batched execution.

  Parameters:

  • id (required)
  • ids — array
  • query — object

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_create_lawsuit

  Cria um processo. Campos conforme a API oficial (use advbox_settings para descobrir IDs de tipo/responsável); envie via campos nomeados + `extra`.

  Parameters:

  • extra — object
  • number — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_update_lawsuit

  Atualiza um processo existente por ID. Envie só os campos a alterar (nomeados + `extra`). Bulk support: accepts ids for batched execution.

  Parameters:

  • id (required)
  • ids — array
  • extra — object

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_lawsuit_history read-only

  Histórico completo de um processo. Bulk support: accepts lawsuit_ids for batched execution.

  Parameters:

  • lawsuit_id (required)
  • page — number
  • query — object
  • page_size — number
  • lawsuit_ids — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_lawsuit_movements read-only

  Lista todas as movimentações de um processo. Bulk support: accepts lawsuit_ids for batched execution.

  Parameters:

  • lawsuit_id (required)
  • page — number
  • query — object
  • page_size — number
  • lawsuit_ids — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_create_movement

  Adiciona uma movimentação manual a um processo. Vincule ao processo (campo conforme a API oficial) + descrição; demais campos via `extra`.

  Parameters:

  • extra — object
  • description — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_last_movements read-only

  Última atualização de cada processo (resumo recente).

  Parameters:

  • page — number
  • query — object
  • page_size — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_list_posts read-only

  Lista posts e anotações (tarefas/notas).

  Parameters:

  • page — number
  • query — object
  • page_size — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_create_post

  Cria um novo post/anotação. Campos conforme a API oficial via campos nomeados + `extra`.

  Parameters:

  • text — string
  • extra — object

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_publications read-only

  Lista as publicações oficiais de um processo. Bulk support: accepts lawsuit_ids for batched execution.

  Parameters:

  • lawsuit_id (required)
  • page — number
  • query — object
  • page_size — number
  • lawsuit_ids — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_list_transactions read-only

  Lista transações financeiras com filtros de data/tipo/status (via `query`).

  Parameters:

  • page — number
  • type — string
  • query — object
  • status — string
  • end_date — string
  • page_size — number
  • start_date — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_get_transaction read-only

  Detalha uma transação por ID. Bulk support: accepts ids for batched execution.

  Parameters:

  • id (required)
  • ids — array
  • query — object

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• advbox_create_transaction

  Cria um lançamento financeiro (receita ou despesa). Obrigatórios: entry_type, amount, date_due, categories_id, debit_account, cost_centers_id e users_id (IDs em advbox_settings). Bulk support: accepts categories_ids, cost_centers_ids, users_ids, customers_ids, lawsuits_ids for batched execution.

  Parameters:

  • type — string
  • extra — object
  • value
  • amount
  • date_due — string
  • due_date — string
  • users_id
  • users_ids — array
  • entry_type — string
  • description — string
  • lawsuits_id
  • customers_id
  • date_payment — string
  • lawsuits_ids — array
  • categories_id
  • customers_ids — array
  • debit_account
  • categories_ids — array
  • cost_centers_id
  • cost_centers_ids — array

  Hints: read-only no · destructive no · idempotent no · open-world no

• advbox_update_transaction

  Atualiza uma transação por ID. Envie só os campos a alterar: amount, date_due e date_payment (AAAA-MM-DD), description; entry_type é obrigatório junto com categories_id. Bulk support: accepts ids for batched execution.

  Parameters:

  • id (required)
  • ids — array
  • extra — object
  • value
  • status — string
  • due_date — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• show_version read-only

  Show the current MCP platform and adapter versions.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• report_bug

  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

  Parameters:

  • message (required) — string
  • context — string
  • conversation — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• connect read-only

  Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• toolkit_info read-only

  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• marketplace

  The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

  Parameters:

  • limit — number
  • query — string
  • action — string
  • mcp_id — string
  • message — string
  • tool_id — string
  • arguments — string
  • immediate — boolean
  • tier_slug — string
  • prompt_body — string
  • prompt_slug — string
  • prompt_tool — string
  • prompt_vars — string
  • conversation — string
  • prompt_title — string
  • request_name — string
  • cancel_reason — string
  • cancel_comment — string
  • prompt_targets — array
  • report_context — string
  • prompt_category — string
  • request_details — string
  • prompt_description — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• authenticate

  MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

  Parameters:

  • token — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.