mcp-zenskar 1.1.3 → 1.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-zenskar",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Model Context Protocol (MCP) server for Zenskar API - customer management, invoicing, and billing operations",
   "main": "src/server.js",
   "bin": {

package/src/mcp-config.json

@@ -2568,7 +2568,7 @@
     },
     {
       "name": "updateContract",
-      "description": "Update an existing contract. The API requires name, status, currency, start_date, and customer_id even for partial changes — fetch the contract first with getContractById to get current values, then send all required fields plus any changes. Status: draft, active, paused, expired, disputed. Renewal: renew_with_default_contract, renew_with_existing, do_not_renew.",
+      "description": "Update an existing contract. This is a PUT endpoint — you MUST fetch the contract first with getContractById, then send ALL required fields including phases. Without phases the API returns 500. Copy phases from the GET response (each phase needs name, start_date, end_date at minimum). Status: draft, active, paused, expired, disputed. Renewal: renew_with_default_contract, renew_with_existing, do_not_renew.",
       "args": [
         {
           "name": "contractId",
@@ -2656,9 +2656,9 @@
         },
         {
           "name": "phases",
-          "description": "Array of contract phases with pricing details. Each phase includes name, start_date, end_date, phase_type, and pricings.",
+          "description": "REQUIRED — Array of contract phases. Without this the API returns 500. Copy phases from getContractById response. Each phase needs at minimum: name, start_date, end_date. Include pricings array if the phase has pricing.",
           "type": "array",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
@@ -4647,7 +4647,7 @@
     },
     {
       "name": "previewQuoteEstimate",
-      "description": "Preview the estimated billing for a quote before creating it.",
+      "description": "Preview the estimated billing for a quote before creating it. Requires customer_id, currency, and line_items at minimum. Use getProductPricings to find valid product_id + pricing_id combos for line_items.",
       "args": [
         {
           "name": "customer_id",
@@ -4656,9 +4656,23 @@
           "required": true,
           "position": "body"
         },
+        {
+          "name": "currency",
+          "description": "Three-letter ISO 4217 currency code (e.g. USD).",
+          "type": "string",
+          "required": true,
+          "position": "body"
+        },
+        {
+          "name": "line_items",
+          "description": "Array of line items. Each item: {product_id, pricing_id}. The pricing_id must belong to the product_id — use getProductPricings to find valid combos.",
+          "type": "array",
+          "required": true,
+          "position": "body"
+        },
         {
           "name": "plan_id",
-          "description": "Plan ID to estimate.",
+          "description": "Plan ID to estimate (alternative to line_items).",
           "type": "string",
           "required": false,
           "position": "body"
@@ -4667,14 +4681,14 @@
           "name": "start_date",
           "description": "Start date (YYYY-MM-DD).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
           "name": "end_date",
           "description": "End date (YYYY-MM-DD).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
@@ -5290,6 +5304,153 @@
       "responseTemplate": {
         "prependBody": "## Attached Payment Method\n\n"
       }
+    },
+    {
+      "name": "deleteCustomer",
+      "description": "Delete a customer by ID. This is permanent and cannot be undone. The customer must not have active contracts or unpaid invoices.",
+      "args": [
+        {
+          "name": "customerId",
+          "description": "The unique identifier (UUID) of the customer to delete.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        }
+      ],
+      "requestTemplate": {
+        "url": "/customers/{customerId}",
+        "method": "DELETE",
+        "headers": {
+          "Content-Type": "application/json"
+        }
+      },
+      "responseTemplate": {
+        "prependBody": "## Customer Deleted\n\n"
+      }
+    },
+    {
+      "name": "deleteContact",
+      "description": "Delete a contact by ID.",
+      "args": [
+        {
+          "name": "contactId",
+          "description": "The unique identifier (UUID) of the contact to delete.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        }
+      ],
+      "requestTemplate": {
+        "url": "/contacts/{contactId}",
+        "method": "DELETE",
+        "headers": {
+          "Content-Type": "application/json"
+        }
+      },
+      "responseTemplate": {
+        "prependBody": "## Contact Deleted\n\n"
+      }
+    },
+    {
+      "name": "deletePaymentMethod",
+      "description": "Delete a payment method from a customer.",
+      "args": [
+        {
+          "name": "customerId",
+          "description": "The unique identifier (UUID) of the customer.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        },
+        {
+          "name": "paymentMethodId",
+          "description": "The unique identifier (UUID) of the payment method to delete.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        }
+      ],
+      "requestTemplate": {
+        "url": "/customers/{customerId}/payment_methods/{paymentMethodId}",
+        "method": "DELETE",
+        "headers": {
+          "Content-Type": "application/json"
+        }
+      },
+      "responseTemplate": {
+        "prependBody": "## Payment Method Deleted\n\n"
+      }
+    },
+    {
+      "name": "pauseContract",
+      "description": "Pause an active contract. Requires a start_date for the pause and an unpause_extension_policy.",
+      "args": [
+        {
+          "name": "contractId",
+          "description": "The unique identifier (UUID) of the contract to pause.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        },
+        {
+          "name": "start_date",
+          "description": "Date when the pause begins (ISO 8601 format, e.g. 2026-04-01T00:00:00).",
+          "type": "string",
+          "required": true,
+          "position": "body"
+        },
+        {
+          "name": "unpause_extension_policy",
+          "description": "How to handle the contract end date when unpaused.",
+          "type": "string",
+          "required": true,
+          "position": "body",
+          "enum": [
+            "extend",
+            "overlap"
+          ]
+        },
+        {
+          "name": "end_date",
+          "description": "Optional date when the pause ends and contract auto-resumes (ISO 8601).",
+          "type": "string",
+          "required": false,
+          "position": "body"
+        }
+      ],
+      "requestTemplate": {
+        "url": "/contract_v2/{contractId}/pause",
+        "method": "POST",
+        "headers": {
+          "Content-Type": "application/json"
+        }
+      },
+      "responseTemplate": {
+        "prependBody": "## Contract Paused\n\n"
+      }
+    },
+    {
+      "name": "resumeContract",
+      "description": "Resume a paused contract. No request body needed.",
+      "args": [
+        {
+          "name": "contractId",
+          "description": "The unique identifier (UUID) of the contract to resume.",
+          "type": "string",
+          "required": true,
+          "position": "path"
+        }
+      ],
+      "requestTemplate": {
+        "url": "/contract_v2/{contractId}/resume",
+        "method": "PATCH",
+        "headers": {
+          "Content-Type": "application/json"
+        }
+      },
+      "responseTemplate": {
+        "prependBody": "## Contract Resumed\n\n"
+      }
     }
   ]
 }