AdvBox
by mcp-dir · remote · no sign-in to list tools · v0.1.0 · published by GitHub user mcp-dir
Wrapper for the official AdvBox API (legal practice management): cases (with history, movements, pub
26 tools: 16 change things and 10 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things16Claude Code: ask: see these tools
- Only reads10Claude Code: allow: see these tools
2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http advbox https://api.mcp.ai/p_advboxFindings
Matches of fixed checks, with the text they matched.
- Infoconnect
The description mentions "credentials".
What this check looks forMatched text
description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."
- Infomarketplace
The description mentions "credential".
What this check looks forMatched text
description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
26 tools
Changes things 16Claude Code: ask
advbox_create_customerCria um novo contato/cliente.No findings
Why it is in this group
- The name "advbox_create_customer" says "create": a word for a change.
Description, as the server wrote it Cria um novo contato/cliente. Campos conforme a API oficial (ex.: name, type, cpf/cnpj, email, phone) — envie o restante via `extra`.
Annotations the server declares
- title: advbox_create_customer
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_create_lawsuitCria um processo.No findings
Why it is in this group
- The name "advbox_create_lawsuit" says "create": a word for a change.
Description, as the server wrote it Cria um processo. Campos conforme a API oficial (use advbox_settings para descobrir IDs de tipo/responsável); envie via campos nomeados + `extra`.
Annotations the server declares
- title: advbox_create_lawsuit
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_create_movementAdiciona uma movimentação manual a um processo.No findings
Why it is in this group
- The name "advbox_create_movement" says "create": a word for a change.
Description, as the server wrote it Adiciona uma movimentação manual a um processo. Vincule ao processo (campo conforme a API oficial) + descrição; demais campos via `extra`.
Annotations the server declares
- title: advbox_create_movement
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_create_postCria um novo post/anotação.Can send data outNo findings
Why it is in this group
- The name "advbox_create_post" says "create": a word for a change.
What it can reach
- outboundThe name "advbox_create_post" says "create" and "post": it writes something other people read.
Description, as the server wrote it Cria um novo post/anotação. Campos conforme a API oficial via campos nomeados + `extra`.
Annotations the server declares
- title: advbox_create_post
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_create_transactionCria um lançamento financeiro (receita ou despesa).No findings
Why it is in this group
- The name "advbox_create_transaction" says "create": a word for a change.
Description, as the server wrote it Cria um lançamento financeiro (receita ou despesa). Campos conforme a API oficial (ex.: type, value, due_date) via campos nomeados + `extra`.
Annotations the server declares
- title: advbox_create_transaction
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_customers_birthdaysLista aniversariantes (para campanhas de relacionamento).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Lista aniversariantes (para campanhas de relacionamento).
Annotations the server declares
- title: advbox_customers_birthdays
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_last_movementsÚltima atualização de cada processo (resumo recente).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Última atualização de cada processo (resumo recente).
Annotations the server declares
- title: advbox_last_movements
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_lawsuit_historyHistórico completo de um processo.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Histórico completo de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Annotations the server declares
- title: advbox_lawsuit_history
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_lawsuit_movementsLista todas as movimentações de um processo.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Lista todas as movimentações de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Annotations the server declares
- title: advbox_lawsuit_movements
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_publicationsLista as publicações oficiais de um processo.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Lista as publicações oficiais de um processo. Bulk support: accepts lawsuit_ids for batched execution.
Annotations the server declares
- title: advbox_publications
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_settingsObtém todos os IDs e configurações da conta (usuários, origens, tipos de tarefa, fases, tipos de processo).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: advbox_settings
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_update_lawsuitAtualiza um processo existente por ID.No findings
Why it is in this group
- The name "advbox_update_lawsuit" says "update": a word for a change.
Description, as the server wrote it Atualiza um processo existente por ID. Envie só os campos a alterar (nomeados + `extra`). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: advbox_update_lawsuit
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
advbox_update_transactionAtualiza valor, vencimento ou status de pagamento de uma transação por ID.No findings
Why it is in this group
- The name "advbox_update_transaction" says "update": a word for a change.
Description, as the server wrote it Atualiza valor, vencimento ou status de pagamento de uma transação por ID. Envie só os campos a alterar (nomeados + `extra`). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: advbox_update_transaction
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
authenticateMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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.
Annotations the server declares
- title: Authenticate
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them.Reads text others write1 finding
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Findings
- Info
The description mentions "credential".
What this check looks forMatched text
description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."
Description, as the server wrote it 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.
Annotations the server declares
- title: Marketplace
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
report_bugReport a bug, missing feature, or send feedback.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Annotations the server declares
- title: Report Bug
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 10Claude Code: allow
advbox_get_customerBusca os dados completos de um contato por ID.No findings
Why it is in this group
- The name "advbox_get_customer" says "get": a word for reading.
Description, as the server wrote it Busca os dados completos de um contato por ID. Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: advbox_get_customer
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_get_lawsuitBusca um processo por ID (dados completos).No findings
Why it is in this group
- The name "advbox_get_lawsuit" says "get": a word for reading.
Description, as the server wrote it Busca um processo por ID (dados completos). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: advbox_get_lawsuit
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_get_transactionDetalha uma transação por ID.No findings
Why it is in this group
- The name "advbox_get_transaction" says "get": a word for reading.
Description, as the server wrote it Detalha uma transação por ID. Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: advbox_get_transaction
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_list_customersLista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "advbox_list_customers" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "mail": it reads mail.
- untrusted-inputThe description's first sentence says "mail": it reads inbound email, which other people can write.
Description, as the server wrote it Lista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc. via `query`).
Annotations the server declares
- title: advbox_list_customers
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_list_lawsuitsLista/busca processos (22+ filtros).No findings
Why it is in this group
- The name "advbox_list_lawsuits" says "list": a word for reading.
Description, as the server wrote it Lista/busca processos (22+ filtros). Filtros comuns via `query`: numero, parte, cpf, cnpj, responsavel, status, comarca, uf, datas.
Annotations the server declares
- title: advbox_list_lawsuits
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_list_postsLista posts e anotações (tarefas/notas).Reads text others writeNo findings
Why it is in this group
- The name "advbox_list_posts" says "list": a word for reading.
What it can reach
- untrusted-inputThe name "advbox_list_posts" says "list" and "post": it reads posts, which other people can write.
- untrusted-inputThe description's first sentence says "post": it reads posts, which other people can write.
Description, as the server wrote it Lista posts e anotações (tarefas/notas).
Annotations the server declares
- title: advbox_list_posts
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
advbox_list_transactionsLista transações financeiras com filtros de data/tipo/status (via `query`).No findings
Why it is in this group
- The name "advbox_list_transactions" says "list": a word for reading.
Description, as the server wrote it Lista transações financeiras com filtros de data/tipo/status (via `query`).
Annotations the server declares
- title: advbox_list_transactions
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
connectReturns connection status and URLs.1 finding
Why it is in this group
- The description's first verb is "return": a word for reading.
Findings
- Info
The description mentions "credentials".
What this check looks forMatched text
description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."
Description, as the server wrote it 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.
Annotations the server declares
- title: Connection Status
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
show_versionShow the current MCP platform and adapter versions.No findings
Why it is in this group
- The name "show_version" says "show": a word for reading.
Description, as the server wrote it Show the current MCP platform and adapter versions.
Annotations the server declares
- title: Show Version
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.No findings
Why it is in this group
- The description's first verb is "return": a word for reading.
Description, as the server wrote it Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Annotations the server declares
- title: Toolkit Info
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
3 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 1 outbound tool breaks every one.
- Reads private data1
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write3
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out1
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
{
"permissions": {
"deny": [
"mcp__advbox__advbox_create_post"
]
}
}Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Oct 22, 2026, 15:19 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 16
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- none
- RFC 9728 protected resource metadata
- none
- Authorization servers
- none
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
- WarnThe whole server
The endpoint served tools/list without credentials, and the list has 16 tools that change things (16 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://api.mcp.ai/p_advbox: tools/list returned 26 tools to an anonymous client, including advbox_settings (write), advbox_customers_birthdays (write), advbox_create_customer (write), advbox_create_lawsuit (write), advbox_update_lawsuit (write) and 11 more
Install
Pinned to version 0.1.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http advbox https://api.mcp.ai/p_advboxRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__advbox__advbox_list_customers",
"mcp__advbox__advbox_get_customer",
"mcp__advbox__advbox_list_lawsuits",
"mcp__advbox__advbox_get_lawsuit",
"mcp__advbox__advbox_list_posts",
"mcp__advbox__advbox_list_transactions",
"mcp__advbox__advbox_get_transaction",
"mcp__advbox__show_version",
"mcp__advbox__connect",
"mcp__advbox__toolkit_info"
],
"ask": [
"mcp__advbox__advbox_settings",
"mcp__advbox__advbox_customers_birthdays",
"mcp__advbox__advbox_create_customer",
"mcp__advbox__advbox_create_lawsuit",
"mcp__advbox__advbox_update_lawsuit",
"mcp__advbox__advbox_lawsuit_history",
"mcp__advbox__advbox_lawsuit_movements",
"mcp__advbox__advbox_create_movement",
"mcp__advbox__advbox_last_movements",
"mcp__advbox__advbox_create_post",
"mcp__advbox__advbox_publications",
"mcp__advbox__advbox_create_transaction",
"mcp__advbox__advbox_update_transaction",
"mcp__advbox__report_bug",
"mcp__advbox__marketplace",
"mcp__advbox__authenticate"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as advbox. Review it before you use it.
Capability tags behind 4 rules
- mcp__advbox__advbox_list_customers private-data, untrusted-input
- mcp__advbox__advbox_list_posts untrusted-input
- mcp__advbox__advbox_create_post outbound
- mcp__advbox__marketplace untrusted-input
