@comando.one/mcp-server 0.3.2 → 0.5.0

package/README.md

@@ -39,7 +39,7 @@ Além deste pacote stdio, existe um **endpoint MCP remoto (streaming)** em `http
 }
 ```
 
-Ambos expõem o **mesmo conjunto de ferramentas** (50 curadas + `lookups` + `comando_request` = cobertura total da API).
+Ambos expõem o **mesmo conjunto de ferramentas** (131 curadas + `lookups` + `comando_request` = cobertura total da API).
 
 ## Variáveis de ambiente
 
@@ -51,10 +51,14 @@ Ambos expõem o **mesmo conjunto de ferramentas** (50 curadas + `lookups` + `com
 
 ## Como funciona
 
-- **127 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`/`invoices_delete`, `charges_create`, `nfse_emit`, `payouts_create`, `contracts_pause`/`contracts_resume`, `service_categories_create`, `reports_aging_actions`/`reports_cashflow_forecast`, `audit_timeline`, `documents_analyze` (lê boleto/guia/NF anexada e extrai valor, vencimento e emitente), `cost_centers_create`, etc.
+- **131 tools curadas** (gerados a partir do OpenAPI canônico, zero drift) cobrindo as operações de maior valor — `customers_list`, `invoices_create`/`invoices_delete`, `charges_create`, `nfse_emit`, `payouts_create`, `contracts_pause`/`contracts_resume`, `service_categories_create`, `reports_aging_actions`/`reports_cashflow_forecast`, `audit_timeline`, `documents_analyze` (lê boleto/guia/NF anexada e extrai valor, vencimento e emitente), `cost_centers_create`, etc.
 - **`comando_request`** — escape hatch genérico (`method`, `path`, `query`, `body`) que cobre 100% dos endpoints restantes.
 - **`lookups`** — catálogos read-only (centros de custo, condições/métodos de pagamento, naturezas, contas bancárias).
 - **`whoami`** — identidade, empresas acessíveis e scopes da chave.
+- **Nomes em português** — cada tool viaja com `title` (e `annotations.title`) vindo do
+  `summary` da OpenAPI, então o cliente mostra "Listar clientes" em vez de "Customers list".
+  O servidor também se identifica com `title` ("Comando.One"), `description`, `websiteUrl` e
+  `icons` (SEP-973). Clientes que ainda não leem esses campos caem no nome técnico sem quebrar.
 
 ### Segurança
 

package/dist/index.js

@@ -143,6 +143,8 @@ var MANIFEST = [
   { operationId: "getInvoice", tool: "invoices_get" },
   { operationId: "createInvoice", tool: "invoices_create", write: true },
   { operationId: "cancelInvoice", tool: "invoices_cancel", write: true, destructive: true },
+  { operationId: "sendInvoiceSecondCopy", tool: "invoices_send", write: true },
+  { operationId: "generateContractInvoices", tool: "contracts_generate_invoices", write: true },
   // ----- Cobranças -----
   { operationId: "listCharges", tool: "charges_list" },
   { operationId: "getCharge", tool: "charges_get" },
@@ -172,6 +174,7 @@ var MANIFEST = [
   { operationId: "getPurchaseInvoice", tool: "purchase_invoices_get" },
   { operationId: "createPurchaseInvoice", tool: "purchase_invoices_create", write: true },
   { operationId: "cancelPurchaseInvoice", tool: "purchase_invoices_cancel", write: true, destructive: true },
+  { operationId: "deletePurchaseInvoice", tool: "purchase_invoices_delete", write: true, destructive: true },
   // ----- Despesas & Serviços -----
   { operationId: "listExpenses", tool: "expenses_list" },
   { operationId: "createExpense", tool: "expenses_create", write: true },
@@ -193,6 +196,7 @@ var MANIFEST = [
   { operationId: "releaseSplitItem", tool: "split_release_item", write: true },
   // Auditoria
   { operationId: "analyzeDocument", tool: "documents_analyze", write: true },
+  { operationId: "listDocuments", tool: "documents_search" },
   { operationId: "getAuditTimeline", tool: "audit_timeline" },
   // Categorias de serviço
   { operationId: "listServiceCategories", tool: "service_categories_list" },
@@ -366,7 +370,7 @@ var SCHEMAS = {
       email: { type: ["string", "null"] },
       phone: { type: ["string", "null"] },
       document: { type: ["string", "null"], description: "CPF ou CNPJ" },
-      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"] },
+      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], description: "Natureza JUR\xCDDICA do cadastro, n\xE3o a categoria de atividade: fisica = pessoa f\xEDsica (CPF); juridica = pessoa jur\xEDdica (CNPJ), o que inclui empresas, \xF3rg\xE3os p\xFAblicos, prefeituras e a Receita Federal; estrangeira = sem CNPJ/CPF. Na d\xFAvida, OMITA o campo \u2014 o padr\xE3o j\xE1 cobre o caso comum." },
       company_name: { type: ["string", "null"] },
       trade_name: { type: ["string", "null"] },
       status: { type: "string" },
@@ -382,7 +386,7 @@ var SCHEMAS = {
       email: { type: "string" },
       phone: { type: "string" },
       document: { type: "string" },
-      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], default: "fisica" },
+      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], default: "fisica", description: "Natureza JUR\xCDDICA do cadastro, n\xE3o a categoria de atividade: fisica = pessoa f\xEDsica (CPF); juridica = pessoa jur\xEDdica (CNPJ), o que inclui empresas, \xF3rg\xE3os p\xFAblicos, prefeituras e a Receita Federal; estrangeira = sem CNPJ/CPF. Na d\xFAvida, OMITA o campo \u2014 o padr\xE3o j\xE1 cobre o caso comum." },
       company_name: { type: "string" },
       trade_name: { type: "string" },
       status: { type: "string", default: "ativo" }
@@ -395,7 +399,7 @@ var SCHEMAS = {
       email: { type: ["string", "null"] },
       phone: { type: ["string", "null"] },
       document: { type: ["string", "null"] },
-      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"] },
+      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], description: "Natureza JUR\xCDDICA do cadastro, n\xE3o a categoria de atividade: fisica = pessoa f\xEDsica (CPF); juridica = pessoa jur\xEDdica (CNPJ), o que inclui empresas, \xF3rg\xE3os p\xFAblicos, prefeituras e a Receita Federal; estrangeira = sem CNPJ/CPF. Na d\xFAvida, OMITA o campo \u2014 o padr\xE3o j\xE1 cobre o caso comum." },
       company_name: { type: ["string", "null"] },
       trade_name: { type: ["string", "null"] },
       status: { type: "string" }
@@ -684,7 +688,7 @@ var SCHEMAS = {
       email: { type: ["string", "null"] },
       phone: { type: ["string", "null"] },
       document: { type: ["string", "null"], description: "CPF ou CNPJ" },
-      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"] },
+      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], description: "Natureza JUR\xCDDICA do cadastro, n\xE3o a categoria de atividade: fisica = pessoa f\xEDsica (CPF); juridica = pessoa jur\xEDdica (CNPJ), o que inclui empresas, \xF3rg\xE3os p\xFAblicos, prefeituras e a Receita Federal; estrangeira = sem CNPJ/CPF. Na d\xFAvida, OMITA o campo \u2014 o padr\xE3o j\xE1 cobre o caso comum." },
       company_name: { type: ["string", "null"] },
       trade_name: { type: ["string", "null"] },
       state_registration: { type: ["string", "null"] },
@@ -709,7 +713,7 @@ var SCHEMAS = {
       email: { type: "string" },
       phone: { type: "string" },
       document: { type: "string" },
-      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], default: "juridica" },
+      type: { type: "string", enum: ["fisica", "juridica", "estrangeira"], default: "juridica", description: "Natureza JUR\xCDDICA do cadastro, n\xE3o a categoria de atividade: fisica = pessoa f\xEDsica (CPF); juridica = pessoa jur\xEDdica (CNPJ), o que inclui empresas, \xF3rg\xE3os p\xFAblicos, prefeituras e a Receita Federal; estrangeira = sem CNPJ/CPF. Na d\xFAvida, OMITA o campo \u2014 o padr\xE3o j\xE1 cobre o caso comum." },
       company_name: { type: "string" },
       trade_name: { type: "string" },
       state_registration: { type: "string" },
@@ -779,7 +783,12 @@ var SCHEMAS = {
       status: { type: "string", enum: ["pendente", "pago", "cancelado"], default: "pendente" },
       bank_account_id: { type: "string", format: "uuid" },
       payment_method_id: { type: "string", format: "uuid" },
-      notes: { type: "string" }
+      notes: { type: "string" },
+      attachment_ids: {
+        type: "array",
+        items: { type: "string", format: "uuid" },
+        description: "Ids de anexos j\xE1 enviados que devem ser vinculados \xE0 despesa criada. \xC9 o fluxo 'lance esse imposto e anexe o PDF' numa chamada s\xF3."
+      }
     }
   },
   PurchaseInvoice: {
@@ -834,11 +843,38 @@ var SCHEMAS = {
             description: { type: "string" },
             amount: { type: "number" },
             due_date: { type: "string", format: "date" },
-            payment_status: { type: "string", enum: ["pendente", "parcial", "pago", "vencido"], default: "pendente" }
+            payment_status: { type: "string", enum: ["pendente", "parcial", "pago", "vencido"], default: "pendente" },
+            boleto_barcode: { type: "string", description: "Linha digit\xE1vel / c\xF3digo de barras do boleto (s\xF3 d\xEDgitos)." },
+            pix_key: { type: "string" },
+            pix_copia_e_cola: { type: "string" }
           }
         }
       },
-      notes: { type: "string" }
+      items: {
+        type: "array",
+        description: "Itens da fatura. Se omitido, o valor de 'amount' vira um item \xFAnico \u2014 a fatura n\xE3o pode ficar sem item (o formul\xE1rio do app n\xE3o salva assim).",
+        items: {
+          type: "object",
+          required: ["name"],
+          properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            unit: { type: "string", default: "un" },
+            quantity: { type: "number", default: 1 },
+            unit_price: { type: "number" },
+            subtotal: { type: "number", description: "Calculado de quantity \xD7 unit_price quando omitido." }
+          }
+        }
+      },
+      title: { type: "string", description: "Descri\xE7\xE3o da fatura; vira o nome do item quando 'items' n\xE3o \xE9 informado." },
+      digitable_line: { type: "string", description: "Atalho: grava o boleto na parcela \xFAnica criada por 'due_date'." },
+      pix_key: { type: "string", description: "Atalho: grava a chave Pix na parcela \xFAnica." },
+      notes: { type: "string" },
+      attachment_ids: {
+        type: "array",
+        items: { type: "string", format: "uuid" },
+        description: "Ids de anexos j\xE1 enviados que devem ser vinculados \xE0 fatura criada. \xC9 o fluxo 'lance esse imposto e anexe o PDF' numa chamada s\xF3."
+      }
     }
   },
   Charge: {
@@ -849,7 +885,7 @@ var SCHEMAS = {
       status: { type: "string", enum: ["pending", "paid", "cancelled", "expired", "failed"] },
       status_raw: { type: "string", description: "Status bruto do provider" },
       method: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] },
-      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme"], description: "Provedor resolvido. 'pix_offline' = Pix est\xE1tico (BR Code local). 'pagarme' = Pix server-side ou cart\xE3o (method=credit_card retorna 'checkout.url' = link da p\xE1gina de pagamento)." },
+      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme", "cora"], description: "Provedor resolvido. 'pix_offline' = Pix est\xE1tico (BR Code local). 'pagarme' = Pix server-side ou cart\xE3o (method=credit_card retorna 'checkout.url' = link da p\xE1gina de pagamento). 'cora' = boleto ou Pix emitidos de forma s\xEDncrona (o boleto j\xE1 volta com 'pdf_url')." },
       invoice_id: { type: ["string", "null"], format: "uuid" },
       customer_id: { type: ["string", "null"], format: "uuid" },
       amount: { type: ["number", "null"] },
@@ -866,7 +902,7 @@ var SCHEMAS = {
     required: ["method"],
     properties: {
       method: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"], description: "Canal de pagamento" },
-      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme"], description: "Opcional. Desambigua quando a empresa tem mais de um provedor no mesmo canal (ex.: Pix Inter x Pix Pagar.me). Se omitido, usa o provedor ativo do canal." },
+      provider: { type: "string", enum: ["inter", "c6bank", "pix_offline", "pagarme", "cora"], description: "Opcional. Desambigua quando a empresa tem mais de um provedor no mesmo canal (ex.: Pix Inter x Pix Pagar.me x Pix Cora). Se omitido, usa o provedor ativo do canal." },
       invoice_id: { type: "string", format: "uuid", description: "Fatura existente (opcional)" },
       customer_id: { type: "string", format: "uuid", description: "Obrigat\xF3rio se invoice_id omitido" },
       amount: { type: "number", description: "Obrigat\xF3rio se invoice_id omitido" },
@@ -1954,6 +1990,9 @@ var OPENAPI_SPEC = {
           { name: "payment_status", in: "query", schema: { type: "string", enum: ["pendente", "parcial", "pago", "vencido"] } },
           { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "due_date_from", in: "query", schema: { type: "string", format: "date" }, description: "Vencimento a partir de (YYYY-MM-DD)" },
+          { name: "overdue", in: "query", schema: { type: "string", enum: ["true", "false"] }, description: "true = vencidas de VERDADE (vencimento passado e n\xE3o pagas). N\xE3o confunda com payment_status=vencido: esse campo \xE9 agregado e 'parcial' ganha de 'vencido', ent\xE3o uma fatura com parcela paga e parcela vencida N\xC3O aparece l\xE1. Para cobran\xE7a, use este filtro." },
+          { name: "sort_by", in: "query", description: "Coluna de ordena\xE7\xE3o. Use com sort_order para responder 'as maiores' ou 'as mais recentes'.", schema: { type: "string", enum: ["amount", "due_date", "created_at", "updated_at", "invoice_number"] } },
+          { name: "sort_order", in: "query", description: "Dire\xE7\xE3o da ordena\xE7\xE3o. Padr\xE3o: desc quando sort_by \xE9 informado.", schema: { type: "string", enum: ["asc", "desc"] } },
           { name: "due_date_to", in: "query", schema: { type: "string", format: "date" }, description: "Vencimento at\xE9 (YYYY-MM-DD)" }
         ],
         responses: {
@@ -1993,6 +2032,83 @@ var OPENAPI_SPEC = {
         responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("H\xE1 registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
       }
     },
+    "/contracts/{id}/generate-invoices": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Contratos"],
+        summary: "Gerar as faturas devidas do contrato",
+        operationId: "generateContractInvoices",
+        description: "Gera as faturas em aberto do contrato conforme a periodicidade dele. A regra de compet\xEAncia (e a prote\xE7\xE3o contra duplicar fatura do mesmo per\xEDodo) \xE9 da rotina de gera\xE7\xE3o, n\xE3o deste endpoint.",
+        security: [{ ApiKeyAuth: ["invoices:create"] }],
+        responses: {
+          "200": {
+            description: "Gera\xE7\xE3o executada",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    contract_id: { type: "string", format: "uuid" },
+                    created: { type: "integer", description: "Quantas faturas nasceram nesta chamada." }
+                  }
+                }
+              }
+            }
+          },
+          ...COMMON_ERRORS
+        }
+      }
+    },
+    "/invoices/{id}/send": {
+      parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
+      post: {
+        tags: ["Faturas"],
+        summary: "Enviar segunda via da fatura ao cliente",
+        operationId: "sendInvoiceSecondCopy",
+        description: "Envia a segunda via por e-mail. Sem 'to', usa o e-mail cadastrado do cliente. Os anexos da fatura v\xE3o junto por padr\xE3o. Registra a tentativa na fila de e-mails antes de enviar, ent\xE3o um envio que falha deixa rastro.",
+        security: [{ ApiKeyAuth: ["invoices:send"] }],
+        requestBody: {
+          required: false,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  to: {
+                    description: "Destinat\xE1rio(s). Aceita string separada por v\xEDrgula ou lista. Omitido, usa o e-mail do cliente.",
+                    oneOf: [{ type: "string" }, { type: "array", items: { type: "string", format: "email" } }]
+                  },
+                  subject: { type: "string", description: "Assunto. Padr\xE3o: 'Segunda via da fatura <numero>'." },
+                  body_html: { type: "string", description: "Corpo em HTML. Padr\xE3o: mensagem curta com valor e vencimento." },
+                  include_attachments: { type: "boolean", default: true, description: "Anexa os arquivos da fatura." }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Segunda via enviada",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    invoice_id: { type: "string", format: "uuid" },
+                    schedule_id: { type: "string", format: "uuid" },
+                    recipients: { type: "array", items: { type: "string" } },
+                    subject: { type: "string" },
+                    attachments: { type: "integer" },
+                    sent_at: { type: "string", format: "date-time" }
+                  }
+                }
+              }
+            }
+          },
+          ...COMMON_ERRORS
+        }
+      }
+    },
     "/invoices/{id}/cancel": {
       parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
       patch: {
@@ -2218,6 +2334,52 @@ var OPENAPI_SPEC = {
         responses: { "200": paginatedResponse("#/components/schemas/ServiceUnit"), ...COMMON_ERRORS }
       }
     },
+    "/documents": {
+      get: {
+        tags: ["Documentos"],
+        summary: "Procurar anexos j\xE1 enviados",
+        operationId: "listDocuments",
+        description: "Busca anexos da empresa por nome do arquivo e/ou entidade a que est\xE3o ligados. Ordenado do mais recente para o mais antigo \u2014 \xE9 o que 'aquele boleto que mandei' quer dizer na pr\xE1tica.",
+        security: [{ ApiKeyAuth: ["documents:read"] }],
+        parameters: [
+          ...PAGINATION_PARAMS,
+          { name: "search", in: "query", schema: { type: "string" }, description: "Trecho do nome do arquivo." },
+          { name: "entity_type", in: "query", schema: { type: "string", enum: ["invoice", "purchase_invoice", "expense", "proposal", "contract", "customer", "supplier", "payment", "supplier_payment", "agent_message"] } },
+          { name: "entity_id", in: "query", schema: { type: "string", format: "uuid" }, description: "Anexos de um registro espec\xEDfico." }
+        ],
+        responses: {
+          "200": {
+            description: "Anexos encontrados",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          id: { type: "string", format: "uuid" },
+                          entity_type: { type: "string" },
+                          entity_id: { type: "string", format: "uuid", nullable: true },
+                          file_name: { type: "string" },
+                          file_path: { type: "string" },
+                          file_size: { type: "integer" },
+                          mime_type: { type: "string", nullable: true },
+                          created_at: { type: "string", format: "date-time" }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          ...COMMON_ERRORS
+        }
+      }
+    },
     "/documents/analyze": {
       post: {
         tags: ["Documentos"],
@@ -2302,7 +2464,7 @@ var OPENAPI_SPEC = {
         summary: "Listar categorias de servi\xE7o",
         operationId: "listServiceCategories",
         security: [{ ApiKeyAuth: ["services:read"] }],
-        parameters: [...PAGINATION_PARAMS, { name: "search", in: "query", schema: { type: "string" }, description: "Filtro por nome (ilike)" }],
+        parameters: [...PAGINATION_PARAMS, { name: "search", in: "query", schema: { type: "string" }, description: "Filtro por nome (ilike)" }, { name: "query", in: "query", schema: { type: "string" }, description: "Apelido de 'search' \u2014 o c\xF3digo j\xE1 aceitava os dois nomes; agora est\xE1 documentado." }],
         responses: { "200": paginatedResponse("#/components/schemas/ServiceCategory"), ...COMMON_ERRORS }
       },
       post: {
@@ -2347,14 +2509,30 @@ var OPENAPI_SPEC = {
           { name: "min_overdue_days", in: "query", schema: { type: "integer", minimum: 1, maximum: 365, default: 1 } },
           { name: "include_shared", in: "query", schema: { type: "boolean", default: true }, description: "Incluir clientes compartilhados" },
           { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
-          { name: "search", in: "query", schema: { type: "string" } }
+          { name: "search", in: "query", schema: { type: "string" } },
+          { name: "query", in: "query", schema: { type: "string" }, description: "Apelido de 'search' \u2014 o c\xF3digo j\xE1 aceitava os dois nomes; agora est\xE1 documentado." }
         ],
         responses: { "200": { description: "Faturas em atraso + a\xE7\xF5es recomendadas", content: { "application/json": { schema: { type: "object", properties: {
           count: { type: "integer" },
           limit: { type: "integer" },
           min_overdue_days: { type: "integer" },
-          total_overdue_amount: { type: "number" },
-          actions: { type: "array", items: { type: "object" } }
+          total_overdue_amount: { type: "number", description: "Soma do SALDO em aberto (valor da fatura menos o que j\xE1 foi pago) \u2014 o que ainda d\xE1 para cobrar." },
+          total_invoiced_amount: { type: "number", description: "Soma do valor cheio das mesmas faturas, ignorando pagamentos parciais." },
+          actions: { type: "array", items: { type: "object", properties: {
+            invoice_id: { type: "string", format: "uuid" },
+            invoice_number: { type: "string", nullable: true },
+            title: { type: "string", nullable: true },
+            customer_id: { type: "string", format: "uuid" },
+            customer_name: { type: "string", nullable: true },
+            amount: { type: "number", description: "Valor cheio da fatura." },
+            paid_amount: { type: "number", description: "Quanto j\xE1 foi pago nesta fatura." },
+            outstanding_amount: { type: "number", description: "Saldo devedor \u2014 \xE9 este o valor a cobrar." },
+            due_date: { type: "string", format: "date", nullable: true },
+            payment_status: { type: "string" },
+            status: { type: "string" },
+            days_overdue: { type: "integer" },
+            recommended_action: { type: "string" }
+          } } }
         } } } } }, ...COMMON_ERRORS }
       }
     },
@@ -2568,7 +2746,9 @@ var OPENAPI_SPEC = {
           { name: "supplier_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "category_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "expense_date_from", in: "query", schema: { type: "string", format: "date" } },
-          { name: "expense_date_to", in: "query", schema: { type: "string", format: "date" } }
+          { name: "expense_date_to", in: "query", schema: { type: "string", format: "date" } },
+          { name: "sort_by", in: "query", description: "Coluna de ordena\xE7\xE3o. Use com sort_order para responder 'as maiores' ou 'as mais recentes'.", schema: { type: "string", enum: ["amount", "expense_date", "due_date", "created_at", "updated_at"] } },
+          { name: "sort_order", in: "query", description: "Dire\xE7\xE3o da ordena\xE7\xE3o. Padr\xE3o: desc quando sort_by \xE9 informado.", schema: { type: "string", enum: ["asc", "desc"] } }
         ],
         responses: { "200": paginatedResponse("#/components/schemas/Expense"), ...COMMON_ERRORS }
       },
@@ -2622,7 +2802,10 @@ var OPENAPI_SPEC = {
           { name: "supplier_id", in: "query", schema: { type: "string", format: "uuid" } },
           { name: "invoice_number", in: "query", schema: { type: "string" } },
           { name: "due_date_from", in: "query", schema: { type: "string", format: "date" } },
-          { name: "due_date_to", in: "query", schema: { type: "string", format: "date" } }
+          { name: "due_date_to", in: "query", schema: { type: "string", format: "date" } },
+          { name: "overdue", in: "query", schema: { type: "string", enum: ["true", "false"] }, description: "true = contas a pagar com parcela vencida e n\xE3o paga. O vencimento mora nas parcelas, ent\xE3o o status agregado da fatura n\xE3o responde isso." },
+          { name: "sort_by", in: "query", description: "Coluna de ordena\xE7\xE3o. Use com sort_order para responder 'as maiores' ou 'as mais recentes'.", schema: { type: "string", enum: ["amount", "issue_date", "created_at", "updated_at", "invoice_number"] } },
+          { name: "sort_order", in: "query", description: "Dire\xE7\xE3o da ordena\xE7\xE3o. Padr\xE3o: desc quando sort_by \xE9 informado.", schema: { type: "string", enum: ["asc", "desc"] } }
         ],
         responses: { "200": paginatedResponse("#/components/schemas/PurchaseInvoice"), ...COMMON_ERRORS }
       },
@@ -2643,6 +2826,14 @@ var OPENAPI_SPEC = {
         operationId: "getPurchaseInvoice",
         security: [{ ApiKeyAuth: ["purchase_invoices:read"] }],
         responses: { "200": { description: "Conta a pagar", content: { "application/json": { schema: { $ref: "#/components/schemas/PurchaseInvoice" } } } }, "404": errorResponse("Conta a pagar n\xE3o encontrada"), ...COMMON_ERRORS }
+      },
+      delete: {
+        tags: ["Contas a Pagar"],
+        summary: "Excluir conta a pagar",
+        operationId: "deletePurchaseInvoice",
+        description: "Exclus\xE3o definitiva. Recusa (409) contas com pagamento registrado ou parcela paga \u2014 nesses casos use o cancelamento, que preserva o hist\xF3rico.",
+        security: [{ ApiKeyAuth: ["purchase_invoices:delete"] }],
+        responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Conta a pagar n\xE3o encontrada"), "409": errorResponse("H\xE1 pagamento registrado ou registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
       }
     },
     "/purchase-invoices/{id}/cancel": {
@@ -2669,7 +2860,9 @@ var OPENAPI_SPEC = {
           { name: "status", in: "query", schema: { type: "string", enum: ["pending", "paid", "cancelled", "expired", "failed"] } },
           { name: "method", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] } },
           { name: "customer_id", in: "query", schema: { type: "string", format: "uuid" } },
-          { name: "invoice_id", in: "query", schema: { type: "string", format: "uuid" } }
+          { name: "invoice_id", in: "query", schema: { type: "string", format: "uuid" } },
+          { name: "sort_by", in: "query", description: "Coluna de ordena\xE7\xE3o. Use com sort_order para responder 'as maiores' ou 'as mais recentes'.", schema: { type: "string", enum: ["amount", "due_date", "created_at", "paid_at"] } },
+          { name: "sort_order", in: "query", description: "Dire\xE7\xE3o da ordena\xE7\xE3o. Padr\xE3o: desc quando sort_by \xE9 informado.", schema: { type: "string", enum: ["asc", "desc"] } }
         ],
         responses: { "200": paginatedResponse("#/components/schemas/Charge"), ...COMMON_ERRORS }
       },
@@ -3112,7 +3305,8 @@ var OPENAPI_SPEC = {
           ...PAGINATION_PARAMS,
           { name: "active", in: "query", schema: { type: "string", enum: ["true", "false"] } },
           { name: "provider", in: "query", schema: { type: "string", enum: ["inter", "c6bank"] } },
-          { name: "channel", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] } }
+          { name: "channel", in: "query", schema: { type: "string", enum: ["pix", "boleto", "checkout", "credit_card"] } },
+          { name: "all", in: "query", description: "true lista TODAS as formas cadastradas; por padr\xE3o s\xF3 as utiliz\xE1veis (manuais ou de provider com integra\xE7\xE3o ativa).", schema: { type: "string", enum: ["true", "false"] } }
         ],
         responses: { "200": paginatedResponse("#/components/schemas/PaymentMethod"), ...COMMON_ERRORS }
       }
@@ -3170,6 +3364,7 @@ var API_MODULES = [
       { key: "read", label: "Listar e visualizar", description: "Consultar faturas e cobran\xE7as" },
       { key: "create", label: "Criar cobran\xE7a", description: "Gerar boletos, Pix e cobran\xE7as" },
       { key: "cancel", label: "Cancelar cobran\xE7a", description: "Cancelar cobran\xE7as em aberto" },
+      { key: "send", label: "Enviar ao cliente", description: "Enviar segunda via da fatura por e-mail ao cliente" },
       { key: "delete", label: "Excluir fatura", description: "Excluir faturas permanentemente (itens e cobran\xE7as vinculadas)" }
     ]
   },
@@ -3233,7 +3428,8 @@ var API_MODULES = [
     permissions: [
       { key: "read", label: "Listar e visualizar", description: "Consultar contas a pagar" },
       { key: "create", label: "Criar", description: "Lan\xE7ar contas a pagar" },
-      { key: "cancel", label: "Cancelar", description: "Cancelar contas a pagar" }
+      { key: "cancel", label: "Cancelar", description: "Cancelar contas a pagar" },
+      { key: "delete", label: "Excluir", description: "Excluir contas a pagar definitivamente" }
     ]
   },
   {
@@ -3358,7 +3554,9 @@ function describeOperation(operationId) {
     const d = declaredByName.get(name);
     properties[name] = {
       ...d?.schema ?? { type: "string" },
-      description: d?.description ?? `Identificador (${name}).`
+      description: d?.description ?? // Sem dizer que é UUID, o planner manda o identificador humano que tem em mãos
+      // (o número da nota) e a chamada morre. Observado em 2026-08-24.
+      `UUID do registro (${name}). Obtenha em uma listagem ou consulta \u2014 N\xC3O \xE9 n\xFAmero, c\xF3digo ou nome.`
     };
     required.push(name);
   }
@@ -3523,6 +3721,9 @@ function buildCuratedTools(api, heldScopes) {
     const description = `${prefix}${desc.summary ?? entry.operationId}.${scopeNote}`;
     tools.push({
       name: entry.tool,
+      // O `summary` da OpenAPI já é escrito em português — é ele que vira o rótulo no
+      // cliente. Sem isso o Claude Desktop humaniza o nome técnico ("Customers list").
+      title: desc.summary?.trim() || void 0,
       description,
       inputSchema: asInputSchema(inputSchema),
       handler: async (args) => {
@@ -3561,6 +3762,7 @@ var METHODS = ["GET", "POST", "PATCH", "PUT", "DELETE"];
 function buildRequestTool(api) {
   return {
     name: "comando_request",
+    title: "Chamada livre \xE0 API",
     description: "Chamada gen\xE9rica \xE0 API do Comando.One (cobre qualquer endpoint /v1/*). Use quando n\xE3o houver uma tool espec\xEDfica. Ex.: method=GET, path=/webhooks/deliveries. Os scopes da chave s\xE3o validados pelo servidor.",
     inputSchema: {
       type: "object",
@@ -3635,6 +3837,7 @@ var KINDS = {
 function buildLookupsTool(api) {
   return {
     name: "lookups",
+    title: "Consultar cat\xE1logos",
     description: "Consulta cat\xE1logos read-only do ERP: centros de custo, condi\xE7\xF5es/m\xE9todos de pagamento, unidades de servi\xE7o, naturezas financeiras e contas banc\xE1rias.",
     inputSchema: {
       type: "object",
@@ -3675,6 +3878,7 @@ function buildLookupsTool(api) {
 function buildWhoamiTool(api) {
   return {
     name: "whoami",
+    title: "Identidade da chave",
     description: "Retorna a identidade da chave de API: empresa atual, empresas acess\xEDveis, scopes concedidos e se \xE9 multi-empresa.",
     inputSchema: { type: "object", properties: {} },
     handler: async () => {
@@ -3687,6 +3891,20 @@ function buildWhoamiTool(api) {
   };
 }
 
+// src/branding.ts
+var MCP_SERVER_NAME = "comando-one";
+var MCP_SERVER_TITLE = "Comando.One";
+var MCP_SERVER_VERSION = "0.5.0";
+var MCP_SERVER_DESCRIPTION = "ERP das empresas de servi\xE7o brasileiras: clientes, propostas, contratos, faturas, cobran\xE7as Pix e boleto, NFS-e, contas a pagar e financeiro.";
+var MCP_SERVER_WEBSITE = "https://comando.one";
+var MCP_SERVER_ICONS = [
+  {
+    src: "data:image/png;base64,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",
+    mimeType: "image/png",
+    sizes: ["96x96"]
+  }
+];
+
 // src/index.ts
 function loadDotEnv() {
   try {
@@ -3739,11 +3957,27 @@ async function main() {
 `
   );
   const server = new Server(
-    { name: "comando-one", version: "0.1.0" },
+    {
+      name: MCP_SERVER_NAME,
+      // `title` é o nome que o app mostra; `icons` é a marca no lugar da inicial genérica.
+      title: MCP_SERVER_TITLE,
+      version: MCP_SERVER_VERSION,
+      description: MCP_SERVER_DESCRIPTION,
+      websiteUrl: MCP_SERVER_WEBSITE,
+      icons: MCP_SERVER_ICONS
+    },
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: tools.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema }))
+    // `title` e `annotations.title` juntos: revisões mais novas do protocolo leem o
+    // primeiro, as anteriores leem o segundo. Sem nenhum dos dois o cliente cai no nome
+    // técnico em inglês.
+    tools: tools.map((t) => ({
+      name: t.name,
+      ...t.title ? { title: t.title, annotations: { title: t.title } } : {},
+      description: t.description,
+      inputSchema: t.inputSchema
+    }))
   }));
   server.setRequestHandler(CallToolRequestSchema, async (req) => {
     const tool = byName.get(req.params.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comando.one/mcp-server",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando.One — opere seu ERP por linguagem natural.",
   "type": "module",
   "license": "MIT",