@comando.one/mcp-server 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +60 -3
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -151,6 +151,8 @@ var MANIFEST = [
151
151
  { operationId: "listChargePayments", tool: "invoices_list_charge_payments" },
152
152
  { operationId: "reverseChargePayment", tool: "invoices_reverse_payment", write: true, destructive: true },
153
153
  { operationId: "generateContractInvoices", tool: "contracts_generate_invoices", write: true },
154
+ { operationId: "getContractPixAutomatico", tool: "contracts_pix_automatico_get" },
155
+ { operationId: "createContractPixAutomaticoLink", tool: "contracts_pix_automatico_link", write: true },
154
156
  // ----- Cobranças -----
155
157
  { operationId: "listCharges", tool: "charges_list" },
156
158
  { operationId: "getCharge", tool: "charges_get" },
@@ -529,6 +531,32 @@ var SCHEMAS = {
529
531
  content: { type: "string" }
530
532
  }
531
533
  },
534
+ ContractPixAutomatico: {
535
+ type: "object",
536
+ description: "Autoriza\xE7\xE3o de Pix Autom\xE1tico de um contrato (d\xE9bito recorrente autorizado pelo pagador no app do banco).",
537
+ properties: {
538
+ contract_id: { type: "string", format: "uuid" },
539
+ banco: { type: ["string", "null"], enum: ["inter", "c6bank", null], description: "Banco da forma de cobran\xE7a do contrato. null = a forma n\xE3o \xE9 Pix Autom\xE1tico." },
540
+ apto: { type: "boolean", description: "O contrato cabe nas regras do Banco Central para Pix Autom\xE1tico." },
541
+ problemas: { type: "array", items: { type: "string" }, description: "O que impede o Pix Autom\xE1tico, em portugu\xEAs, quando apto = false." },
542
+ link: { type: ["string", "null"], description: "Link de autoriza\xE7\xE3o (https://comando.one/assinar/\u2026) para enviar ao pagador. null at\xE9 o POST criar." },
543
+ autorizacao: {
544
+ type: ["object", "null"],
545
+ description: "A autoriza\xE7\xE3o (Rec) mais recente. null enquanto o pagador n\xE3o abriu o link e pediu o QR Code.",
546
+ properties: {
547
+ id_rec: { type: "string", description: "Identificador da recorr\xEAncia no Banco Central." },
548
+ status: { type: "string", enum: ["CRIADA", "APROVADA", "REJEITADA", "CANCELADA", "EXPIRADA"] },
549
+ banco: { type: "string", enum: ["inter", "c6bank"] },
550
+ valor: { type: ["number", "null"], description: "Valor fixo autorizado por d\xE9bito, em reais." },
551
+ periodicidade: { type: ["string", "null"], enum: ["SEMANAL", "MENSAL", "TRIMESTRAL", "SEMESTRAL", "ANUAL", null] },
552
+ data_inicial: { type: ["string", "null"], format: "date", description: "1\xBA vencimento." },
553
+ data_final: { type: ["string", "null"], format: "date" },
554
+ criada_em: { type: "string", format: "date-time" },
555
+ atualizada_em: { type: "string", format: "date-time" }
556
+ }
557
+ }
558
+ }
559
+ },
532
560
  Contract: {
533
561
  type: "object",
534
562
  properties: {
@@ -2615,7 +2643,7 @@ var OPENAPI_SPEC = {
2615
2643
  operationId: "createContract",
2616
2644
  security: [{ ApiKeyAuth: ["contracts:write"] }],
2617
2645
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractCreate" } } } },
2618
- responses: { "201": { description: "Contrato criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), ...COMMON_ERRORS }
2646
+ responses: { "201": { description: "Contrato criado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos"), "404": errorResponse("Cliente n\xE3o encontrado"), "422": errorResponse("Forma Pix Autom\xE1tico com periodicidade, parcelas ou prazo de vencimento que o Banco Central n\xE3o aceita"), ...COMMON_ERRORS }
2619
2647
  }
2620
2648
  },
2621
2649
  "/contracts/{id}": {
@@ -2637,7 +2665,7 @@ var OPENAPI_SPEC = {
2637
2665
  operationId: "updateContract",
2638
2666
  security: [{ ApiKeyAuth: ["contracts:write"] }],
2639
2667
  requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ContractUpdate" } } } },
2640
- responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Contrato ou cliente n\xE3o encontrado"), "409": errorResponse("Troca de cliente com autoriza\xE7\xE3o de d\xE9bito recorrente ativa"), ...COMMON_ERRORS }
2668
+ responses: { "200": { description: "Contrato atualizado", content: { "application/json": { schema: { $ref: "#/components/schemas/Contract" } } } }, "400": errorResponse("Dados inv\xE1lidos ou nenhum campo para atualizar"), "404": errorResponse("Contrato ou cliente n\xE3o encontrado"), "409": errorResponse("Troca de cliente com autoriza\xE7\xE3o de d\xE9bito recorrente ativa"), "422": errorResponse("Forma Pix Autom\xE1tico com periodicidade, parcelas ou prazo de vencimento que o Banco Central n\xE3o aceita"), ...COMMON_ERRORS }
2641
2669
  },
2642
2670
  delete: {
2643
2671
  tags: ["Contratos"],
@@ -2828,6 +2856,35 @@ var OPENAPI_SPEC = {
2828
2856
  responses: { "204": { description: "Exclu\xEDda" }, "404": errorResponse("Fatura n\xE3o encontrada"), "409": errorResponse("H\xE1 registros vinculados que impedem a exclus\xE3o"), ...COMMON_ERRORS }
2829
2857
  }
2830
2858
  },
2859
+ "/contracts/{id}/pix-automatico": {
2860
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
2861
+ get: {
2862
+ tags: ["Contratos"],
2863
+ summary: "Consultar a autoriza\xE7\xE3o de Pix Autom\xE1tico do contrato",
2864
+ operationId: "getContractPixAutomatico",
2865
+ description: "Estado do Pix Autom\xE1tico do contrato: banco da forma de cobran\xE7a (inter ou c6bank), se o contrato cabe nas regras do Banco Central (apto/problemas), a autoriza\xE7\xE3o (Rec) mais recente com o status (CRIADA = aguardando o pagador, APROVADA = d\xE9bitos liberados, REJEITADA/CANCELADA/EXPIRADA = encerrada) e o link de autoriza\xE7\xE3o, se j\xE1 existe. N\xE3o cria nada. As cobran\xE7as de cada ciclo saem em GET /v1/charges?channel=pix_automatico e o pagamento chega pelo webhook charge.paid.",
2866
+ security: [{ ApiKeyAuth: ["contracts:read"] }],
2867
+ responses: {
2868
+ "200": { description: "Estado do Pix Autom\xE1tico", content: { "application/json": { schema: { $ref: "#/components/schemas/ContractPixAutomatico" } } } },
2869
+ "404": errorResponse("Contrato n\xE3o encontrado"),
2870
+ ...COMMON_ERRORS
2871
+ }
2872
+ },
2873
+ post: {
2874
+ tags: ["Contratos"],
2875
+ summary: "Gerar o link de autoriza\xE7\xE3o do Pix Autom\xE1tico",
2876
+ operationId: "createContractPixAutomaticoLink",
2877
+ description: "Devolve o link que o pagador abre para autorizar o d\xE9bito recorrente (/assinar): ele l\xEA os termos, recebe o QR Code e aprova no app do banco dele. Idempotente: se o contrato j\xE1 tem link ativo, devolve o mesmo. Recusa (422) se a forma de cobran\xE7a n\xE3o \xE9 Pix Autom\xE1tico ou se o contrato n\xE3o cabe nas regras do Banco Central (periodicidade semanal/mensal/trimestral/semestral/anual, uma parcela por ciclo, vencimento a 2+ dias da gera\xE7\xE3o), e (409) se o contrato n\xE3o est\xE1 ativo. Envie o link ao pagador pelo seu canal; depois acompanhe por GET at\xE9 autorizacao.status = APROVADA.",
2878
+ security: [{ ApiKeyAuth: ["contracts:write"] }],
2879
+ responses: {
2880
+ "200": { description: "Link de autoriza\xE7\xE3o e estado", content: { "application/json": { schema: { $ref: "#/components/schemas/ContractPixAutomatico" } } } },
2881
+ "404": errorResponse("Contrato n\xE3o encontrado"),
2882
+ "409": errorResponse("Contrato n\xE3o est\xE1 ativo"),
2883
+ "422": errorResponse("Forma de cobran\xE7a n\xE3o \xE9 Pix Autom\xE1tico ou contrato fora das regras do Banco Central"),
2884
+ ...COMMON_ERRORS
2885
+ }
2886
+ }
2887
+ },
2831
2888
  "/contracts/{id}/generate-invoices": {
2832
2889
  parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
2833
2890
  post: {
@@ -5663,7 +5720,7 @@ function buildWhoamiTool(api) {
5663
5720
  // src/branding.ts
5664
5721
  var MCP_SERVER_NAME = "comando-one";
5665
5722
  var MCP_SERVER_TITLE = "Comando1";
5666
- var MCP_SERVER_VERSION = "0.15.0";
5723
+ var MCP_SERVER_VERSION = "0.16.0";
5667
5724
  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.";
5668
5725
  var MCP_SERVER_WEBSITE = "https://comando.one";
5669
5726
  var MCP_SERVER_ICONS = [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "author": "Orbital Tecnologia e Desenvolvimento LTDA <contato@comando.one> (https://orbitaldev.com.br)",
6
6
  "homepage": "https://comando.one",