mcp-zenskar 1.1.2 → 1.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-zenskar",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "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. Use this for mid-contract upgrades, downgrades, amendments, changing renewal policy, updating custom attributes, or modifying contract terms. Required fields: name, status, currency, start_date, customer_id. Status enum: draft, active, paused, expired, disputed. Renewal policy enum: 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"
         },
         {
@@ -4210,7 +4210,7 @@
         },
         {
           "name": "pricing_data",
-          "description": "Pricing data object containing model-specific configuration (rates, tiers, etc.).",
+          "description": "Pricing data object. Must include 'pricing_type' discriminator matching pricing_model. For flat_fee: {pricing_type:'flat_fee', unit_amount:10000} (amount in cents). For per_unit: {pricing_type:'per_unit', unit_amount:500}.",
           "type": "object",
           "required": false,
           "position": "body"
@@ -4397,14 +4397,14 @@
           "name": "start_date",
           "description": "Start date for the estimate (YYYY-MM-DD).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
           "name": "end_date",
           "description": "End date for the estimate (YYYY-MM-DD).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         }
       ],
@@ -4462,7 +4462,7 @@
         },
         {
           "name": "module",
-          "description": "Module/entity type this attribute applies to (e.g., 'customer', 'contract', 'invoice', 'product').",
+          "description": "Module/entity type this attribute applies to. Allowed values: 'customers', 'contracts', 'invoices', 'payments', 'products', 'plans'.",
           "type": "string",
           "required": true,
           "position": "body"
@@ -4600,9 +4600,9 @@
         },
         {
           "name": "customer_id",
-          "description": "The customer ID this quote is for.",
+          "description": "The customer ID this quote is for (required for non-amendment quotes).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
@@ -4616,14 +4616,14 @@
           "name": "start_date",
           "description": "Start date for the quote (YYYY-MM-DD).",
           "type": "string",
-          "required": false,
+          "required": true,
           "position": "body"
         },
         {
           "name": "end_date",
           "description": "End date for the quote (YYYY-MM-DD).",
           "type": "string",
-          "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"
         },
         {