AdvBox

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Wrapper for the official AdvBox legal practice management API, letting an assistant manage contacts, lawsuits, movements, posts and financial entries.

What you can do
  • Look up account settings and IDs needed for creating or updating records
  • List, search and create customers, including birthday lists
  • List, create and update lawsuits, and read their history, movements and official publications
  • Add manual movements to a lawsuit and see the latest movement per case
  • List and create posts and notes
  • List, detail, create and update financial transactions
When to use it
Useful for Brazilian law offices already running AdvBox that want an assistant to query case data, register movements, or draft and adjust financial entries without switching systems.
Requirements
A remote streamable HTTP endpoint; no local package or runtime is needed. An AdvBox account with API access is required, and the toolkit's connect and authenticate tools return a connect URL or accept an access token, which can be set as an Authorization Bearer header.
Before you install
The server can create and update customers, lawsuits, movements, posts and financial transactions, so changes reach live practice-management data. It also exposes customer personal data such as CPF/CNPJ, e-mail and phone, and financial records. Authentication uses an access token; treat it as a secret. The report_bug tool asks for recent conversation messages.

Installation

In SourceWeft

  1. Open AdvBox in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fadvbox-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "advbox": {
      "type": "http",
      "url": "https://api.mcp.ai/p_advbox"
    }
  }
}

README

This repository has no README.

Tools

26

advbox_settings

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.

Parametersquery

advbox_list_customers

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

Parameterscpfcnpjnamepageemailquerypage_size

advbox_get_customer

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

Parametersidrequiredidsquery

advbox_customers_birthdays

Lista aniversariantes (para campanhas de relacionamento).

Parameterspagequerypage_size

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`.

Parameterscpfcnpjnameemailextra

advbox_list_lawsuits

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

Parameterscpfcnpjpagequerynumberstatuspage_size

advbox_get_lawsuit

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

Parametersidrequiredidsquery

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`.

Parametersextranumber

advbox_update_lawsuit

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

Parametersidrequiredidsextra

advbox_lawsuit_history

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

Parameterspagequerypage_sizelawsuit_idrequiredlawsuit_ids

advbox_lawsuit_movements

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

Parameterspagequerypage_sizelawsuit_idrequiredlawsuit_ids

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`.

Parametersextradescription

advbox_last_movements

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

Parameterspagequerypage_size

advbox_list_posts

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

Parameterspagequerypage_size

advbox_create_post

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

Parameterstextextra

advbox_publications

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

Parameterspagequerypage_sizelawsuit_idrequiredlawsuit_ids

advbox_list_transactions

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

Parameterspagetypequerystatusend_datepage_sizestart_date

advbox_get_transaction

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

Parametersidrequiredidsquery

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.

Parameterstypeextravalueamountdate_duedue_dateusers_idusers_idsentry_typedescriptionlawsuits_idcustomers_id+8 more

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.

Parametersidrequiredidsextravaluestatusdue_date

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

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

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

Toolkit Info

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

Takes no parameters.

marketplace

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.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

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.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.