AdvBox
Wrapper for the official AdvBox API (legal practice management): cases (with history, movements, pub
Should I use this
Quality & Safety
Findings (6)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'advbox_settings' description contains placeholder textin advbox_settings
- LOWTool 'advbox_create_customer' description lacks action verbin advbox_create_customer
- LOWTool 'advbox_create_post' description lacks action verbin advbox_create_post
- LOWTool 'connect' description lacks action verbin connect
- INFOTool description contains placeholder or incomplete textin advbox_settings
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"advbox-mcp": {
"url": "https://api.mcp.ai/p_advbox"
}
}
}Remote endpoints
https://api.mcp.ai/p_advboxstreamable-httpWhat it can do
Tool inventory
Tools (26)
🟢advbox_settings(query)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_list_customers(page, page_size, name, cpf, cnpj, ...)
Lista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc. via `query`).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"name": {
"type": "string"
},
"cpf": {
"type": "string"
},
"cnpj": {
"type": "string"
},
"email": {
"type": "string"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_get_customer(id, query, ids)
Busca os dados completos de um contato por ID. Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_customers_birthdays(page, page_size, query)
Lista aniversariantes (para campanhas de relacionamento).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_create_customer(name, email, cpf, cnpj, extra)
Cria um novo contato/cliente. Campos conforme a API oficial (ex.: name, type, cpf/cnpj, email, phone) — envie o restante via `extra`.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"cpf": {
"type": "string"
},
"cnpj": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_list_lawsuits(page, page_size, number, cpf, cnpj, ...)
Lista/busca processos (22+ filtros). Filtros comuns via `query`: numero, parte, cpf, cnpj, responsavel, status, comarca, uf, datas.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"number": {
"type": "string"
},
"cpf": {
"type": "string"
},
"cnpj": {
"type": "string"
},
"status": {
"type": "string"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_get_lawsuit(id, query, ids)
Busca um processo por ID (dados completos). Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_create_lawsuit(number, extra)
Cria um processo. Campos conforme a API oficial (use advbox_settings para descobrir IDs de tipo/responsável); envie via campos nomeados + `extra`.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_update_lawsuit(id, extra, ids)
Atualiza um processo existente por ID. Envie só os campos a alterar (nomeados + `extra`). Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_lawsuit_history(lawsuit_id, page, page_size, query, lawsuit_ids)
Histórico completo de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"lawsuit_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lawsuit_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"lawsuit_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_lawsuit_movements(lawsuit_id, page, page_size, query, lawsuit_ids)
Lista todas as movimentações de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"lawsuit_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lawsuit_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"lawsuit_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_create_movement(description, extra)
Adiciona uma movimentação manual a um processo. Vincule ao processo (campo conforme a API oficial) + descrição; demais campos via `extra`.
Input Schema
{
"type": "object",
"properties": {
"description": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_last_movements(page, page_size, query)
Última atualização de cada processo (resumo recente).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_list_posts(page, page_size, query)
Lista posts e anotações (tarefas/notas).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_create_post(text, extra)
Cria um novo post/anotação. Campos conforme a API oficial via campos nomeados + `extra`.
Input Schema
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_publications(lawsuit_id, page, page_size, query, lawsuit_ids)
Lista as publicações oficiais de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"lawsuit_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lawsuit_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"lawsuit_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_list_transactions(page, page_size, type, status, start_date, ...)
Lista transações financeiras com filtros de data/tipo/status (via `query`).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"type": {
"type": "string"
},
"status": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢advbox_get_transaction(id, query, ids)
Detalha uma transação por ID. Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_create_transaction(entry_type, amount, date_due, categories_id, debit_account, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"entry_type": {
"type": "string"
},
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"date_due": {
"type": "string"
},
"categories_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"debit_account": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"cost_centers_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"users_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"date_payment": {
"type": "string"
},
"description": {
"type": "string"
},
"customers_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"lawsuits_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"type": {
"type": "string"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"due_date": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"categories_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"cost_centers_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"users_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"customers_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"lawsuits_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡advbox_update_transaction(id, value, due_date, status, extra, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"due_date": {
"type": "string"
},
"status": {
"type": "string"
},
"extra": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢connect
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
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.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence