@comando.one/mcp-server 0.8.0 → 0.9.1

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 +591 -2
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -218,6 +218,7 @@ var MANIFEST = [
218
218
  { operationId: "listDueReadjustments", tool: "contracts_readjustments_due" },
219
219
  { operationId: "listContractReadjustments", tool: "contracts_readjustments_list" },
220
220
  { operationId: "applyContractReadjustment", tool: "contracts_readjustments_apply", write: true, destructive: true },
221
+ { operationId: "revertContractReadjustment", tool: "contracts_readjustments_revert", write: true, destructive: true },
221
222
  { operationId: "getMarketIndices", tool: "market_indices_get" },
222
223
  // Faturas — exclusão física
223
224
  { operationId: "deleteInvoice", tool: "invoices_delete", write: true, destructive: true },
@@ -275,6 +276,28 @@ var MANIFEST = [
275
276
  // Financeiro e contas bancárias
276
277
  { operationId: "listFinancialNatures", tool: "finance_list_natures" },
277
278
  { operationId: "deleteFinancialMovement", tool: "finance_delete_movement", write: true, destructive: true },
279
+ // Módulos operacionais que tinham tela e nenhuma exposição (COBERTURA.md item 1).
280
+ // Somente leitura — escrever em conciliação/cartão/DDA mexe em dinheiro e entra depois.
281
+ { operationId: "listInboxMessages", tool: "inbox_messages_list" },
282
+ { operationId: "getInboxMessage", tool: "inbox_messages_get" },
283
+ { operationId: "listInboxDocuments", tool: "inbox_documents_list" },
284
+ { operationId: "getInboxDocument", tool: "inbox_documents_get" },
285
+ { operationId: "listStatementEntries", tool: "reconciliation_entries_list" },
286
+ { operationId: "getStatementEntry", tool: "reconciliation_entries_get" },
287
+ { operationId: "listReconciliationPeriods", tool: "reconciliation_periods_list" },
288
+ { operationId: "getReconciliationPeriod", tool: "reconciliation_periods_get" },
289
+ { operationId: "listCardStatements", tool: "card_statements_list" },
290
+ { operationId: "getCardStatement", tool: "card_statements_get" },
291
+ { operationId: "listDdaBoletos", tool: "dda_boletos_list" },
292
+ { operationId: "getDdaBoleto", tool: "dda_boletos_get" },
293
+ { operationId: "listRecurringExpenses", tool: "recurring_expenses_list" },
294
+ { operationId: "getRecurringExpense", tool: "recurring_expenses_get" },
295
+ { operationId: "listRecurringPurchaseInvoices", tool: "recurring_purchase_invoices_list" },
296
+ { operationId: "getRecurringPurchaseInvoice", tool: "recurring_purchase_invoices_get" },
297
+ { operationId: "listInsumos", tool: "insumos_list" },
298
+ { operationId: "getInsumo", tool: "insumos_get" },
299
+ { operationId: "listNotifications", tool: "notifications_list" },
300
+ { operationId: "getNotification", tool: "notifications_get" },
278
301
  { operationId: "listBankAccounts", tool: "bank_accounts_list" },
279
302
  { operationId: "getBankAccount", tool: "bank_accounts_get" },
280
303
  // Dados de referência de pagamento
@@ -286,6 +309,7 @@ var MANIFEST = [
286
309
  // Webhooks — edição, teste e entregas
287
310
  { operationId: "updateWebhook", tool: "webhooks_update", write: true },
288
311
  { operationId: "deleteWebhook", tool: "webhooks_delete", write: true, destructive: true },
312
+ { operationId: "deletePaymentsWebhookConfig", tool: "webhooks_delete_config", write: true, destructive: true },
289
313
  { operationId: "getWebhook", tool: "webhooks_get_config" },
290
314
  { operationId: "upsertWebhook", tool: "webhooks_upsert_config", write: true },
291
315
  { operationId: "testWebhook", tool: "webhooks_test", write: true },
@@ -521,6 +545,7 @@ var SCHEMAS = {
521
545
  due_days: { type: "integer", default: 10 },
522
546
  amount: { type: "number" },
523
547
  payment_method_id: { type: "string", format: "uuid" },
548
+ next_generation_date: { type: "string", format: "date", description: "Data da pr\xF3xima gera\xE7\xE3o de fatura. Omitido, usa 'start_date'." },
524
549
  notes: { type: "string" }
525
550
  }
526
551
  },
@@ -872,8 +897,13 @@ var SCHEMAS = {
872
897
  }
873
898
  },
874
899
  title: { type: "string", description: "Descri\xE7\xE3o da fatura; vira o nome do item quando 'items' n\xE3o \xE9 informado." },
900
+ description: { type: "string", description: "Apelido de 'title' na hora de nomear o item \xFAnico. Preced\xEAncia: title > description > notes > invoice_number." },
875
901
  digitable_line: { type: "string", description: "Atalho: grava o boleto na parcela \xFAnica criada por 'due_date'." },
902
+ boleto_barcode: { type: "string", description: "Apelido de 'digitable_line' no n\xEDvel raiz. Vale para as parcelas que n\xE3o trouxerem o seu pr\xF3prio." },
903
+ barcode: { type: "string", description: "Apelido de 'digitable_line'. Preced\xEAncia: o da parcela > boleto_barcode > digitable_line > barcode." },
876
904
  pix_key: { type: "string", description: "Atalho: grava a chave Pix na parcela \xFAnica." },
905
+ pix_copia_e_cola: { type: "string", description: "Pix copia-e-cola no n\xEDvel raiz. Vale para as parcelas que n\xE3o trouxerem o seu pr\xF3prio." },
906
+ pix_payload: { type: "string", description: "Apelido de 'pix_copia_e_cola'. Preced\xEAncia: o da parcela > pix_copia_e_cola > pix_payload." },
877
907
  notes: { type: "string" },
878
908
  attachment_ids: {
879
909
  type: "array",
@@ -937,6 +967,219 @@ var SCHEMAS = {
937
967
  active: { type: "boolean", default: true }
938
968
  }
939
969
  },
970
+ InboxMessage: {
971
+ type: "object",
972
+ properties: {
973
+ id: { type: "string", format: "uuid" },
974
+ from_email: { type: "string" },
975
+ from_name: { type: "string" },
976
+ subject: { type: "string" },
977
+ status: { type: "string" },
978
+ error_reason: { type: "string" },
979
+ attempts: { type: "number" },
980
+ received_at: { type: "string", format: "date-time" },
981
+ processed_at: { type: "string", format: "date-time" },
982
+ replied_at: { type: "string", format: "date-time" },
983
+ created_at: { type: "string", format: "date-time" },
984
+ body_text: { type: "string" },
985
+ spf_verdict: { type: "string" },
986
+ dkim_verdict: { type: "string" },
987
+ dmarc_verdict: { type: "string" },
988
+ spam_verdict: { type: "string" },
989
+ virus_verdict: { type: "string" },
990
+ raw_size_bytes: { type: "number" },
991
+ thread_root_id: { type: "string", format: "uuid" }
992
+ }
993
+ },
994
+ InboxDocument: {
995
+ type: "object",
996
+ properties: {
997
+ id: { type: "string", format: "uuid" },
998
+ message_id: { type: "string", format: "uuid" },
999
+ filename: { type: "string" },
1000
+ content_type: { type: "string" },
1001
+ size_bytes: { type: "number" },
1002
+ kind: { type: "string" },
1003
+ direction: { type: "string" },
1004
+ amount: { type: "number" },
1005
+ due_date: { type: "string", format: "date" },
1006
+ issue_date: { type: "string", format: "date" },
1007
+ document_number: { type: "string" },
1008
+ counterparty_name: { type: "string" },
1009
+ counterparty_document: { type: "string" },
1010
+ barcode: { type: "string" },
1011
+ pix_key: { type: "string" },
1012
+ outcome: { type: "string" },
1013
+ outcome_reason: { type: "string" },
1014
+ match_method: { type: "string" },
1015
+ match_confidence: { type: "number" },
1016
+ supplier_id: { type: "string", format: "uuid" },
1017
+ customer_id: { type: "string", format: "uuid" },
1018
+ purchase_invoice_id: { type: "string", format: "uuid" },
1019
+ invoice_id: { type: "string", format: "uuid" },
1020
+ duplicate_of_document_id: { type: "string", format: "uuid" },
1021
+ dda_boleto_id: { type: "string", format: "uuid" },
1022
+ card_statement_id: { type: "string", format: "uuid" },
1023
+ created_at: { type: "string", format: "date-time" },
1024
+ updated_at: { type: "string", format: "date-time" }
1025
+ }
1026
+ },
1027
+ StatementEntry: {
1028
+ type: "object",
1029
+ properties: {
1030
+ id: { type: "string", format: "uuid" },
1031
+ bank_account_id: { type: "string", format: "uuid" },
1032
+ entry_date: { type: "string", format: "date" },
1033
+ amount: { type: "number" },
1034
+ entry_type: { type: "string" },
1035
+ operation_type: { type: "string" },
1036
+ transaction_type: { type: "string" },
1037
+ description: { type: "string" },
1038
+ balance: { type: "number" },
1039
+ external_id: { type: "string", format: "uuid" },
1040
+ is_ignored: { type: "boolean" },
1041
+ reconciliation_period_id: { type: "string", format: "uuid" },
1042
+ card_statement_id: { type: "string", format: "uuid" },
1043
+ end_to_end_id: { type: "string", format: "uuid" },
1044
+ counterparty_name: { type: "string" },
1045
+ counterparty_document: { type: "string" },
1046
+ created_at: { type: "string", format: "date-time" }
1047
+ }
1048
+ },
1049
+ ReconciliationPeriod: {
1050
+ type: "object",
1051
+ properties: {
1052
+ id: { type: "string", format: "uuid" },
1053
+ bank_account_id: { type: "string", format: "uuid" },
1054
+ start_date: { type: "string", format: "date" },
1055
+ end_date: { type: "string", format: "date" },
1056
+ status: { type: "string" },
1057
+ opening_balance: { type: "number" },
1058
+ closing_balance: { type: "number" },
1059
+ notes: { type: "string" },
1060
+ closed_at: { type: "string", format: "date-time" },
1061
+ created_at: { type: "string", format: "date-time" },
1062
+ updated_at: { type: "string", format: "date-time" }
1063
+ }
1064
+ },
1065
+ CardStatement: {
1066
+ type: "object",
1067
+ properties: {
1068
+ id: { type: "string", format: "uuid" },
1069
+ bank_account_id: { type: "string", format: "uuid" },
1070
+ reference_month: { type: "string", format: "date" },
1071
+ closing_date: { type: "string", format: "date" },
1072
+ due_date: { type: "string", format: "date" },
1073
+ status: { type: "string" },
1074
+ total_expenses: { type: "number" },
1075
+ total_entries: { type: "number" },
1076
+ paid_amount: { type: "number" },
1077
+ paid_at: { type: "string", format: "date-time" },
1078
+ paid_bank_account_id: { type: "string", format: "uuid" },
1079
+ boleto_barcode: { type: "string" },
1080
+ boleto_amount: { type: "number" },
1081
+ boleto_due_date: { type: "string", format: "date" },
1082
+ purchase_invoice_id: { type: "string", format: "uuid" },
1083
+ reconciliation_period_id: { type: "string", format: "uuid" },
1084
+ notes: { type: "string" },
1085
+ created_at: { type: "string", format: "date-time" },
1086
+ updated_at: { type: "string", format: "date-time" }
1087
+ }
1088
+ },
1089
+ DdaBoleto: {
1090
+ type: "object",
1091
+ properties: {
1092
+ id: { type: "string", format: "uuid" },
1093
+ supplier_id: { type: "string", format: "uuid" },
1094
+ purchase_invoice_id: { type: "string", format: "uuid" },
1095
+ barcode: { type: "string" },
1096
+ beneficiary_name: { type: "string" },
1097
+ beneficiary_document: { type: "string" },
1098
+ payer_name: { type: "string" },
1099
+ payer_document: { type: "string" },
1100
+ bank_code: { type: "string" },
1101
+ bank_name: { type: "string" },
1102
+ amount: { type: "number" },
1103
+ due_date: { type: "string", format: "date" },
1104
+ overdue: { type: "boolean" },
1105
+ match_status: { type: "string" },
1106
+ match_method: { type: "string" },
1107
+ match_confidence: { type: "number" },
1108
+ error_message: { type: "string" },
1109
+ triaged_at: { type: "string", format: "date-time" },
1110
+ triage_note: { type: "string" },
1111
+ card_statement_id: { type: "string", format: "uuid" },
1112
+ first_seen_at: { type: "string", format: "date-time" },
1113
+ last_seen_at: { type: "string", format: "date-time" },
1114
+ created_at: { type: "string", format: "date-time" }
1115
+ }
1116
+ },
1117
+ RecurringExpense: {
1118
+ type: "object",
1119
+ properties: {
1120
+ id: { type: "string", format: "uuid" },
1121
+ supplier_id: { type: "string", format: "uuid" },
1122
+ description: { type: "string" },
1123
+ amount: { type: "number" },
1124
+ category_id: { type: "string", format: "uuid" },
1125
+ bank_account_id: { type: "string", format: "uuid" },
1126
+ payment_method_id: { type: "string", format: "uuid" },
1127
+ frequency: { type: "string" },
1128
+ start_date: { type: "string", format: "date" },
1129
+ end_date: { type: "string", format: "date" },
1130
+ next_generation_date: { type: "string", format: "date" },
1131
+ status: { type: "string" },
1132
+ notes: { type: "string" },
1133
+ created_at: { type: "string", format: "date-time" },
1134
+ updated_at: { type: "string", format: "date-time" }
1135
+ }
1136
+ },
1137
+ RecurringPurchaseInvoice: {
1138
+ type: "object",
1139
+ properties: {
1140
+ id: { type: "string", format: "uuid" },
1141
+ supplier_id: { type: "string", format: "uuid" },
1142
+ payment_condition_id: { type: "string", format: "uuid" },
1143
+ payment_method_id: { type: "string", format: "uuid" },
1144
+ supplier_payment_method_id: { type: "string", format: "uuid" },
1145
+ frequency: { type: "string" },
1146
+ start_date: { type: "string", format: "date" },
1147
+ end_date: { type: "string", format: "date" },
1148
+ next_generation_date: { type: "string", format: "date" },
1149
+ status: { type: "string" },
1150
+ notes: { type: "string" },
1151
+ adjust_due_to_business_day: { type: "boolean" },
1152
+ created_at: { type: "string", format: "date-time" },
1153
+ updated_at: { type: "string", format: "date-time" }
1154
+ }
1155
+ },
1156
+ Insumo: {
1157
+ type: "object",
1158
+ properties: {
1159
+ id: { type: "string", format: "uuid" },
1160
+ name: { type: "string" },
1161
+ description: { type: "string" },
1162
+ unit: { type: "string" },
1163
+ unit_price: { type: "number" },
1164
+ active: { type: "boolean" },
1165
+ created_at: { type: "string", format: "date-time" },
1166
+ updated_at: { type: "string", format: "date-time" }
1167
+ }
1168
+ },
1169
+ Notification: {
1170
+ type: "object",
1171
+ properties: {
1172
+ id: { type: "string", format: "uuid" },
1173
+ user_id: { type: "string", format: "uuid" },
1174
+ type: { type: "string" },
1175
+ title: { type: "string" },
1176
+ body: { type: "string" },
1177
+ entity_type: { type: "string" },
1178
+ entity_id: { type: "string", format: "uuid" },
1179
+ read_at: { type: "string", format: "date-time" },
1180
+ created_at: { type: "string", format: "date-time" }
1181
+ }
1182
+ },
940
1183
  BankAccount: {
941
1184
  type: "object",
942
1185
  description: "Conta banc\xE1ria (campos sens\xEDveis como ag\xEAncia, conta, chave Pix e documento do titular s\xE3o omitidos da API p\xFAblica).",
@@ -1961,6 +2204,25 @@ var OPENAPI_SPEC = {
1961
2204
  }
1962
2205
  }
1963
2206
  },
2207
+ "/contracts/{id}/readjustments/{readjustmentId}": {
2208
+ parameters: [
2209
+ { name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } },
2210
+ { name: "readjustmentId", in: "path", required: true, schema: { type: "string", format: "uuid" } }
2211
+ ],
2212
+ delete: {
2213
+ tags: ["Contratos"],
2214
+ summary: "Desfazer um reajuste aplicado",
2215
+ description: "Devolve o contrato ao valor anterior, restaura os itens ao estado gravado no momento da aplica\xE7\xE3o e recalcula a data do pr\xF3ximo reajuste. S\xF3 o reajuste mais recente ainda vigente pode ser desfeito, e apenas se o valor do contrato n\xE3o tiver sido alterado depois. A linha permanece no hist\xF3rico marcada como desfeita; faturas j\xE1 geradas n\xE3o s\xE3o alteradas.",
2216
+ operationId: "revertContractReadjustment",
2217
+ security: [{ ApiKeyAuth: ["contracts:write"] }],
2218
+ responses: {
2219
+ "200": { description: "Reajuste desfeito", content: { "application/json": { schema: { type: "object", properties: { reverted: { type: "boolean" }, contract_id: { type: "string", format: "uuid" }, restored_amount: { type: "number" }, items_exact: { type: "boolean", description: "false quando os itens voltaram por escala inversa (aproximada), por aus\xEAncia do registro anterior" } } } } } },
2220
+ "404": errorResponse("Reajuste ou contrato n\xE3o encontrado"),
2221
+ "409": errorResponse("N\xE3o \xE9 o reajuste mais recente, j\xE1 foi desfeito, ou o valor mudou depois"),
2222
+ ...COMMON_ERRORS
2223
+ }
2224
+ }
2225
+ },
1964
2226
  "/market-indices": {
1965
2227
  get: {
1966
2228
  tags: ["Contratos"],
@@ -2137,6 +2399,7 @@ var OPENAPI_SPEC = {
2137
2399
  amount: { type: "number", description: "Valor recebido. Omitido, quita o saldo restante da parcela." },
2138
2400
  payment_date: { type: "string", format: "date", description: "Data do recebimento (YYYY-MM-DD). Padr\xE3o: hoje." },
2139
2401
  receipt_method_id: { type: "string", format: "uuid", description: "Forma de RECEBIMENTO (GET /v1/payment-methods). Aceita tamb\xE9m o nome `payment_method_id`." },
2402
+ payment_method_id: { type: "string", format: "uuid", description: "Apelido de 'receipt_method_id'. Este s\xF3 tem efeito quando o can\xF4nico n\xE3o vem." },
2140
2403
  bank_account_id: { type: "string", format: "uuid", description: "Conta que recebeu (GET /v1/bank-accounts)." },
2141
2404
  notes: { type: "string", description: "Observa\xE7\xE3o livre do pagamento." }
2142
2405
  } } } } },
@@ -2248,6 +2511,10 @@ var OPENAPI_SPEC = {
2248
2511
  description: "Destinat\xE1rio(s). Aceita string separada por v\xEDrgula ou lista. Omitido, usa o e-mail do cliente.",
2249
2512
  oneOf: [{ type: "string" }, { type: "array", items: { type: "string", format: "email" } }]
2250
2513
  },
2514
+ recipient_emails: {
2515
+ description: "Apelido de 'to'. Mesmo formato; 'to' tem preced\xEAncia.",
2516
+ oneOf: [{ type: "string" }, { type: "array", items: { type: "string", format: "email" } }]
2517
+ },
2251
2518
  subject: { type: "string", description: "Assunto. Padr\xE3o: 'Segunda via da fatura <numero>'." },
2252
2519
  body_html: { type: "string", description: "Corpo em HTML. Padr\xE3o: mensagem curta com valor e vencimento." },
2253
2520
  include_attachments: { type: "boolean", default: true, description: "Anexa os arquivos da fatura." }
@@ -3202,9 +3469,12 @@ var OPENAPI_SPEC = {
3202
3469
  }
3203
3470
  },
3204
3471
  delete: {
3472
+ // `operationId` próprio: esta rota dividia `deleteWebhook` com DELETE /webhooks/{id},
3473
+ // e id repetido faz a derivação de tool casar com UMA das duas — a outra fica
3474
+ // inalcançável pelo MCP, em silêncio. Um id por operação.
3205
3475
  tags: ["Webhooks"],
3206
- summary: "Remover webhook",
3207
- operationId: "deleteWebhook",
3476
+ summary: "Remover a configura\xE7\xE3o de webhook de pagamentos",
3477
+ operationId: "deletePaymentsWebhookConfig",
3208
3478
  security: [{ ApiKeyAuth: ["webhooks:manage"] }],
3209
3479
  responses: { "200": { description: "Removido" }, "404": errorResponse("Nenhum webhook configurado"), ...COMMON_ERRORS }
3210
3480
  }
@@ -3233,6 +3503,276 @@ var OPENAPI_SPEC = {
3233
3503
  // -----------------------------------------------------------------------
3234
3504
  // Contas bancárias (read-only)
3235
3505
  // -----------------------------------------------------------------------
3506
+ "/inbox/messages": {
3507
+ get: {
3508
+ tags: ["Caixa de Entrada"],
3509
+ summary: "Listar mensagens da caixa de entrada",
3510
+ operationId: "listInboxMessages",
3511
+ security: [{ ApiKeyAuth: ["inbox:read"] }],
3512
+ parameters: [
3513
+ ...PAGINATION_PARAMS,
3514
+ { name: "status", in: "query", description: "Estado do processamento da mensagem.", schema: { type: "string" } },
3515
+ { name: "from_email", in: "query", description: "Remetente (busca parcial).", schema: { type: "string" } },
3516
+ { name: "subject", in: "query", description: "Assunto (busca parcial).", schema: { type: "string" } },
3517
+ { name: "received_from", in: "query", description: "Recebidas a partir desta data.", schema: { type: "string", format: "date" } },
3518
+ { name: "received_to", in: "query", description: "Recebidas at\xE9 esta data.", schema: { type: "string", format: "date" } }
3519
+ ],
3520
+ responses: { "200": paginatedResponse("#/components/schemas/InboxMessage"), ...COMMON_ERRORS }
3521
+ }
3522
+ },
3523
+ "/inbox/messages/{id}": {
3524
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3525
+ get: {
3526
+ tags: ["Caixa de Entrada"],
3527
+ summary: "Obter mensagem da caixa de entrada",
3528
+ operationId: "getInboxMessage",
3529
+ security: [{ ApiKeyAuth: ["inbox:read"] }],
3530
+ responses: { "200": { description: "Mensagem da caixa de entrada", content: { "application/json": { schema: { $ref: "#/components/schemas/InboxMessage" } } } }, "404": errorResponse("Mensagem da caixa de entrada n\xE3o encontrado"), ...COMMON_ERRORS }
3531
+ }
3532
+ },
3533
+ "/inbox/documents": {
3534
+ get: {
3535
+ tags: ["Caixa de Entrada"],
3536
+ summary: "Listar documentos da caixa de entrada",
3537
+ operationId: "listInboxDocuments",
3538
+ security: [{ ApiKeyAuth: ["inbox:read"] }],
3539
+ parameters: [
3540
+ ...PAGINATION_PARAMS,
3541
+ { name: "kind", in: "query", description: "Tipo do documento extra\xEDdo (boleto, nfe, guia\u2026).", schema: { type: "string" } },
3542
+ { name: "outcome", in: "query", description: "Desfecho do processamento.", schema: { type: "string" } },
3543
+ { name: "message_id", in: "query", description: "Mensagem de origem.", schema: { type: "string", format: "uuid" } },
3544
+ { name: "supplier_id", in: "query", description: "Fornecedor casado.", schema: { type: "string", format: "uuid" } },
3545
+ { name: "purchase_invoice_id", in: "query", description: "Conta a pagar lan\xE7ada a partir dele.", schema: { type: "string", format: "uuid" } },
3546
+ { name: "due_from", in: "query", description: "Vencimento a partir de.", schema: { type: "string", format: "date" } },
3547
+ { name: "due_to", in: "query", description: "Vencimento at\xE9.", schema: { type: "string", format: "date" } }
3548
+ ],
3549
+ responses: { "200": paginatedResponse("#/components/schemas/InboxDocument"), ...COMMON_ERRORS }
3550
+ }
3551
+ },
3552
+ "/inbox/documents/{id}": {
3553
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3554
+ get: {
3555
+ tags: ["Caixa de Entrada"],
3556
+ summary: "Obter documento da caixa de entrada",
3557
+ operationId: "getInboxDocument",
3558
+ security: [{ ApiKeyAuth: ["inbox:read"] }],
3559
+ responses: { "200": { description: "Documento da caixa de entrada", content: { "application/json": { schema: { $ref: "#/components/schemas/InboxDocument" } } } }, "404": errorResponse("Documento da caixa de entrada n\xE3o encontrado"), ...COMMON_ERRORS }
3560
+ }
3561
+ },
3562
+ "/reconciliation/entries": {
3563
+ get: {
3564
+ tags: ["Concilia\xE7\xE3o"],
3565
+ summary: "Listar lan\xE7amentos do extrato",
3566
+ operationId: "listStatementEntries",
3567
+ security: [{ ApiKeyAuth: ["reconciliation:read"] }],
3568
+ parameters: [
3569
+ ...PAGINATION_PARAMS,
3570
+ { name: "bank_account_id", in: "query", description: "Conta banc\xE1ria.", schema: { type: "string", format: "uuid" } },
3571
+ { name: "entry_type", in: "query", description: "Entrada ou sa\xEDda.", schema: { type: "string" } },
3572
+ { name: "reconciliation_period_id", in: "query", description: "Per\xEDodo de concilia\xE7\xE3o.", schema: { type: "string", format: "uuid" } },
3573
+ { name: "is_ignored", in: "query", description: "Somente ignorados (true) ou n\xE3o ignorados (false).", schema: { type: "string", enum: ["true", "false"] } },
3574
+ { name: "description", in: "query", description: "Descri\xE7\xE3o (busca parcial).", schema: { type: "string" } },
3575
+ { name: "date_from", in: "query", description: "Data do lan\xE7amento a partir de.", schema: { type: "string", format: "date" } },
3576
+ { name: "date_to", in: "query", description: "Data do lan\xE7amento at\xE9.", schema: { type: "string", format: "date" } }
3577
+ ],
3578
+ responses: { "200": paginatedResponse("#/components/schemas/StatementEntry"), ...COMMON_ERRORS }
3579
+ }
3580
+ },
3581
+ "/reconciliation/entries/{id}": {
3582
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3583
+ get: {
3584
+ tags: ["Concilia\xE7\xE3o"],
3585
+ summary: "Obter lan\xE7amento de extrato",
3586
+ operationId: "getStatementEntry",
3587
+ security: [{ ApiKeyAuth: ["reconciliation:read"] }],
3588
+ responses: { "200": { description: "Lan\xE7amento de extrato", content: { "application/json": { schema: { $ref: "#/components/schemas/StatementEntry" } } } }, "404": errorResponse("Lan\xE7amento de extrato n\xE3o encontrado"), ...COMMON_ERRORS }
3589
+ }
3590
+ },
3591
+ "/reconciliation/periods": {
3592
+ get: {
3593
+ tags: ["Concilia\xE7\xE3o"],
3594
+ summary: "Listar per\xEDodos de concilia\xE7\xE3o",
3595
+ operationId: "listReconciliationPeriods",
3596
+ security: [{ ApiKeyAuth: ["reconciliation:read"] }],
3597
+ parameters: [
3598
+ ...PAGINATION_PARAMS,
3599
+ { name: "bank_account_id", in: "query", description: "Conta banc\xE1ria.", schema: { type: "string", format: "uuid" } },
3600
+ { name: "status", in: "query", description: "Estado do per\xEDodo (open, closed\u2026).", schema: { type: "string" } }
3601
+ ],
3602
+ responses: { "200": paginatedResponse("#/components/schemas/ReconciliationPeriod"), ...COMMON_ERRORS }
3603
+ }
3604
+ },
3605
+ "/reconciliation/periods/{id}": {
3606
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3607
+ get: {
3608
+ tags: ["Concilia\xE7\xE3o"],
3609
+ summary: "Obter per\xEDodo de concilia\xE7\xE3o",
3610
+ operationId: "getReconciliationPeriod",
3611
+ security: [{ ApiKeyAuth: ["reconciliation:read"] }],
3612
+ responses: { "200": { description: "Per\xEDodo de concilia\xE7\xE3o", content: { "application/json": { schema: { $ref: "#/components/schemas/ReconciliationPeriod" } } } }, "404": errorResponse("Per\xEDodo de concilia\xE7\xE3o n\xE3o encontrado"), ...COMMON_ERRORS }
3613
+ }
3614
+ },
3615
+ "/card-statements": {
3616
+ get: {
3617
+ tags: ["Cart\xE3o de Cr\xE9dito"],
3618
+ summary: "Listar faturas de cart\xE3o",
3619
+ operationId: "listCardStatements",
3620
+ security: [{ ApiKeyAuth: ["cards:read"] }],
3621
+ parameters: [
3622
+ ...PAGINATION_PARAMS,
3623
+ { name: "bank_account_id", in: "query", description: "Cart\xE3o (conta banc\xE1ria do tipo cart\xE3o).", schema: { type: "string", format: "uuid" } },
3624
+ { name: "status", in: "query", description: "aberta, fechada ou paga.", schema: { type: "string" } },
3625
+ { name: "reference_month", in: "query", description: "M\xEAs de compet\xEAncia (AAAA-MM-DD do 1\xBA dia).", schema: { type: "string" } },
3626
+ { name: "due_from", in: "query", description: "Vencimento a partir de.", schema: { type: "string", format: "date" } },
3627
+ { name: "due_to", in: "query", description: "Vencimento at\xE9.", schema: { type: "string", format: "date" } }
3628
+ ],
3629
+ responses: { "200": paginatedResponse("#/components/schemas/CardStatement"), ...COMMON_ERRORS }
3630
+ }
3631
+ },
3632
+ "/card-statements/{id}": {
3633
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3634
+ get: {
3635
+ tags: ["Cart\xE3o de Cr\xE9dito"],
3636
+ summary: "Obter fatura de cart\xE3o",
3637
+ operationId: "getCardStatement",
3638
+ security: [{ ApiKeyAuth: ["cards:read"] }],
3639
+ responses: { "200": { description: "Fatura de cart\xE3o", content: { "application/json": { schema: { $ref: "#/components/schemas/CardStatement" } } } }, "404": errorResponse("Fatura de cart\xE3o n\xE3o encontrado"), ...COMMON_ERRORS }
3640
+ }
3641
+ },
3642
+ "/dda-boletos": {
3643
+ get: {
3644
+ tags: ["DDA"],
3645
+ summary: "Listar boletos do DDA",
3646
+ operationId: "listDdaBoletos",
3647
+ security: [{ ApiKeyAuth: ["dda:read"] }],
3648
+ parameters: [
3649
+ ...PAGINATION_PARAMS,
3650
+ { name: "match_status", in: "query", description: "Situa\xE7\xE3o do casamento com uma conta a pagar.", schema: { type: "string" } },
3651
+ { name: "supplier_id", in: "query", description: "Fornecedor casado.", schema: { type: "string", format: "uuid" } },
3652
+ { name: "overdue", in: "query", description: "Somente vencidos (true).", schema: { type: "string", enum: ["true", "false"] } },
3653
+ { name: "beneficiary_name", in: "query", description: "Benefici\xE1rio (busca parcial).", schema: { type: "string" } },
3654
+ { name: "due_from", in: "query", description: "Vencimento a partir de.", schema: { type: "string", format: "date" } },
3655
+ { name: "due_to", in: "query", description: "Vencimento at\xE9.", schema: { type: "string", format: "date" } }
3656
+ ],
3657
+ responses: { "200": paginatedResponse("#/components/schemas/DdaBoleto"), ...COMMON_ERRORS }
3658
+ }
3659
+ },
3660
+ "/dda-boletos/{id}": {
3661
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3662
+ get: {
3663
+ tags: ["DDA"],
3664
+ summary: "Obter boleto de dda",
3665
+ operationId: "getDdaBoleto",
3666
+ security: [{ ApiKeyAuth: ["dda:read"] }],
3667
+ responses: { "200": { description: "Boleto de DDA", content: { "application/json": { schema: { $ref: "#/components/schemas/DdaBoleto" } } } }, "404": errorResponse("Boleto de DDA n\xE3o encontrado"), ...COMMON_ERRORS }
3668
+ }
3669
+ },
3670
+ "/recurring-expenses": {
3671
+ get: {
3672
+ tags: ["Recorrentes"],
3673
+ summary: "Listar despesas recorrentes",
3674
+ operationId: "listRecurringExpenses",
3675
+ security: [{ ApiKeyAuth: ["recurring:read"] }],
3676
+ parameters: [
3677
+ ...PAGINATION_PARAMS,
3678
+ { name: "status", in: "query", description: "Estado da regra (ativa, pausada\u2026).", schema: { type: "string" } },
3679
+ { name: "supplier_id", in: "query", description: "Fornecedor.", schema: { type: "string", format: "uuid" } },
3680
+ { name: "frequency", in: "query", description: "Periodicidade.", schema: { type: "string" } },
3681
+ { name: "next_from", in: "query", description: "Pr\xF3xima gera\xE7\xE3o a partir de.", schema: { type: "string", format: "date" } },
3682
+ { name: "next_to", in: "query", description: "Pr\xF3xima gera\xE7\xE3o at\xE9.", schema: { type: "string", format: "date" } }
3683
+ ],
3684
+ responses: { "200": paginatedResponse("#/components/schemas/RecurringExpense"), ...COMMON_ERRORS }
3685
+ }
3686
+ },
3687
+ "/recurring-expenses/{id}": {
3688
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3689
+ get: {
3690
+ tags: ["Recorrentes"],
3691
+ summary: "Obter despesa recorrente",
3692
+ operationId: "getRecurringExpense",
3693
+ security: [{ ApiKeyAuth: ["recurring:read"] }],
3694
+ responses: { "200": { description: "Despesa recorrente", content: { "application/json": { schema: { $ref: "#/components/schemas/RecurringExpense" } } } }, "404": errorResponse("Despesa recorrente n\xE3o encontrado"), ...COMMON_ERRORS }
3695
+ }
3696
+ },
3697
+ "/recurring-purchase-invoices": {
3698
+ get: {
3699
+ tags: ["Recorrentes"],
3700
+ summary: "Listar contas a pagar recorrentes",
3701
+ operationId: "listRecurringPurchaseInvoices",
3702
+ security: [{ ApiKeyAuth: ["recurring:read"] }],
3703
+ parameters: [
3704
+ ...PAGINATION_PARAMS,
3705
+ { name: "status", in: "query", description: "Estado da regra.", schema: { type: "string" } },
3706
+ { name: "supplier_id", in: "query", description: "Fornecedor.", schema: { type: "string", format: "uuid" } },
3707
+ { name: "frequency", in: "query", description: "Periodicidade.", schema: { type: "string" } },
3708
+ { name: "next_from", in: "query", description: "Pr\xF3xima gera\xE7\xE3o a partir de.", schema: { type: "string", format: "date" } },
3709
+ { name: "next_to", in: "query", description: "Pr\xF3xima gera\xE7\xE3o at\xE9.", schema: { type: "string", format: "date" } }
3710
+ ],
3711
+ responses: { "200": paginatedResponse("#/components/schemas/RecurringPurchaseInvoice"), ...COMMON_ERRORS }
3712
+ }
3713
+ },
3714
+ "/recurring-purchase-invoices/{id}": {
3715
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3716
+ get: {
3717
+ tags: ["Recorrentes"],
3718
+ summary: "Obter conta a pagar recorrente",
3719
+ operationId: "getRecurringPurchaseInvoice",
3720
+ security: [{ ApiKeyAuth: ["recurring:read"] }],
3721
+ responses: { "200": { description: "Conta a pagar recorrente", content: { "application/json": { schema: { $ref: "#/components/schemas/RecurringPurchaseInvoice" } } } }, "404": errorResponse("Conta a pagar recorrente n\xE3o encontrado"), ...COMMON_ERRORS }
3722
+ }
3723
+ },
3724
+ "/insumos": {
3725
+ get: {
3726
+ tags: ["Insumos"],
3727
+ summary: "Listar insumos",
3728
+ operationId: "listInsumos",
3729
+ security: [{ ApiKeyAuth: ["insumos:read"] }],
3730
+ parameters: [
3731
+ ...PAGINATION_PARAMS,
3732
+ { name: "name", in: "query", description: "Nome (busca parcial).", schema: { type: "string" } },
3733
+ { name: "active", in: "query", description: "Somente ativos (true) ou inativos (false).", schema: { type: "string", enum: ["true", "false"] } }
3734
+ ],
3735
+ responses: { "200": paginatedResponse("#/components/schemas/Insumo"), ...COMMON_ERRORS }
3736
+ }
3737
+ },
3738
+ "/insumos/{id}": {
3739
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3740
+ get: {
3741
+ tags: ["Insumos"],
3742
+ summary: "Obter insumo",
3743
+ operationId: "getInsumo",
3744
+ security: [{ ApiKeyAuth: ["insumos:read"] }],
3745
+ responses: { "200": { description: "Insumo", content: { "application/json": { schema: { $ref: "#/components/schemas/Insumo" } } } }, "404": errorResponse("Insumo n\xE3o encontrado"), ...COMMON_ERRORS }
3746
+ }
3747
+ },
3748
+ "/notifications": {
3749
+ get: {
3750
+ tags: ["Notifica\xE7\xF5es"],
3751
+ summary: "Listar notifica\xE7\xF5es",
3752
+ operationId: "listNotifications",
3753
+ security: [{ ApiKeyAuth: ["notifications:read"] }],
3754
+ parameters: [
3755
+ ...PAGINATION_PARAMS,
3756
+ { name: "type", in: "query", description: "Tipo da notifica\xE7\xE3o.", schema: { type: "string" } },
3757
+ { name: "entity_type", in: "query", description: "Entidade relacionada.", schema: { type: "string" } },
3758
+ { name: "entity_id", in: "query", description: "Id da entidade relacionada.", schema: { type: "string", format: "uuid" } },
3759
+ { name: "user_id", in: "query", description: "Destinat\xE1rio.", schema: { type: "string", format: "uuid" } },
3760
+ { name: "created_from", in: "query", description: "Criadas a partir de.", schema: { type: "string", format: "date" } },
3761
+ { name: "created_to", in: "query", description: "Criadas at\xE9.", schema: { type: "string", format: "date" } }
3762
+ ],
3763
+ responses: { "200": paginatedResponse("#/components/schemas/Notification"), ...COMMON_ERRORS }
3764
+ }
3765
+ },
3766
+ "/notifications/{id}": {
3767
+ parameters: [{ name: "id", in: "path", required: true, schema: { type: "string", format: "uuid" } }],
3768
+ get: {
3769
+ tags: ["Notifica\xE7\xF5es"],
3770
+ summary: "Obter notifica\xE7\xE3o",
3771
+ operationId: "getNotification",
3772
+ security: [{ ApiKeyAuth: ["notifications:read"] }],
3773
+ responses: { "200": { description: "Notifica\xE7\xE3o", content: { "application/json": { schema: { $ref: "#/components/schemas/Notification" } } } }, "404": errorResponse("Notifica\xE7\xE3o n\xE3o encontrado"), ...COMMON_ERRORS }
3774
+ }
3775
+ },
3236
3776
  "/bank-accounts": {
3237
3777
  get: {
3238
3778
  tags: ["Contas banc\xE1rias"],
@@ -3650,6 +4190,55 @@ var API_MODULES = [
3650
4190
  { key: "delete", label: "Excluir regra", description: "Remover regras de split" }
3651
4191
  ]
3652
4192
  },
4193
+ {
4194
+ key: "inbox",
4195
+ label: "Caixa de Entrada",
4196
+ permissions: [
4197
+ { key: "read", label: "Consultar mensagens e documentos", description: "Ver os e-mails recebidos e os boletos/notas extra\xEDdos deles" }
4198
+ ]
4199
+ },
4200
+ {
4201
+ key: "reconciliation",
4202
+ label: "Concilia\xE7\xE3o Banc\xE1ria",
4203
+ permissions: [
4204
+ { key: "read", label: "Consultar extrato e per\xEDodos", description: "Ver lan\xE7amentos do extrato e os per\xEDodos de concilia\xE7\xE3o" }
4205
+ ]
4206
+ },
4207
+ {
4208
+ key: "cards",
4209
+ label: "Cart\xE3o de Cr\xE9dito",
4210
+ permissions: [
4211
+ { key: "read", label: "Consultar faturas", description: "Ver as faturas de cart\xE3o, com fechamento, vencimento e total" }
4212
+ ]
4213
+ },
4214
+ {
4215
+ key: "dda",
4216
+ label: "DDA",
4217
+ permissions: [
4218
+ { key: "read", label: "Consultar boletos", description: "Ver os boletos que o banco avisou por DDA e o status de casamento" }
4219
+ ]
4220
+ },
4221
+ {
4222
+ key: "recurring",
4223
+ label: "Recorrentes",
4224
+ permissions: [
4225
+ { key: "read", label: "Consultar regras", description: "Ver as regras que geram despesas e contas a pagar recorrentes" }
4226
+ ]
4227
+ },
4228
+ {
4229
+ key: "insumos",
4230
+ label: "Insumos",
4231
+ permissions: [
4232
+ { key: "read", label: "Listar e visualizar", description: "Consultar o cat\xE1logo de insumos" }
4233
+ ]
4234
+ },
4235
+ {
4236
+ key: "notifications",
4237
+ label: "Notifica\xE7\xF5es",
4238
+ permissions: [
4239
+ { key: "read", label: "Consultar notifica\xE7\xF5es", description: "Ver as notifica\xE7\xF5es geradas para os usu\xE1rios da empresa" }
4240
+ ]
4241
+ },
3653
4242
  {
3654
4243
  key: "audit",
3655
4244
  label: "Auditoria",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comando.one/mcp-server",
3
- "version": "0.8.0",
3
+ "version": "0.9.1",
4
4
  "description": "Servidor MCP (Model Context Protocol) para a API pública do Comando1 — opere seu ERP por linguagem natural.",
5
5
  "type": "module",
6
6
  "license": "MIT",