mcp-zenskar 2.2.4 → 2.3.0

package/dist/mcp-config.json

@@ -3169,7 +3169,7 @@
     },
     {
       "name": "updateContract",
-      "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.",
+      "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). Renewal: renew_with_default_contract, renew_with_existing, do_not_renew. EXPIRY: this tool CANNOT expire, end, terminate or cancel a contract. Contract status is derived from the CONTRACT-LEVEL end_date; phase end_dates never affect it. If the user asks to expire/end/terminate/cancel a contract, or to 'set' or 'update' its expiry date, you MUST call expireContract instead of this tool — it sets the end_date and also prunes future phases, trims overlapping phases and caps product dates, which this tool does not. Setting a past end_date here is rejected.",
       "args": [
         {
           "name": "contractId",
@@ -3187,7 +3187,7 @@
         },
         {
           "name": "status",
-          "description": "Contract status: draft, active, paused, or disputed. Cannot set to 'expired' via update.",
+          "description": "Contract status: draft, active, paused, or disputed. 'expired' is not settable here — it is derived from contract-level end_date. Use expireContract to expire a contract.",
           "type": "string",
           "required": true,
           "position": "body",
@@ -3223,7 +3223,7 @@
         },
         {
           "name": "end_date",
-          "description": "Contract end date in ISO 8601 format.",
+          "description": "Contract end date in ISO 8601 format. Drives the effective contract status: a past end_date makes the contract read as EXPIRED. Leave null for an open-ended contract. Prefer expireContract over setting a past end_date here.",
           "type": "string",
           "required": false,
           "position": "body"
@@ -3751,21 +3751,21 @@
     },
     {
       "name": "expireContract",
-      "description": "Expire an ACTIVE or PAUSED contract by adjusting its end_date. Allowed status transitions: ACTIVE→EXPIRED, PAUSED→EXPIRED. EXPIRED is terminal — calling on an already-expired contract returns 400; do NOT retry, do NOT escalate to deleteContract or any other destructive tool as a fallback. Verify contract.status via getContractById before calling. Idempotency: NO. The contract expires at end of day 23:59:59.999999. Host enforces user confirmation via the approval gate; do NOT ask the user to re-confirm before calling.",
+      "description": "THE ONLY tool that can expire, end, terminate or cancel contracts — use it whenever the user wants contracts to stop on a given date, including when they phrase it as 'update the expiry date'. Do NOT use updateContract for this. To expire SEVERAL contracts, pass every id in contractIds on a SINGLE call — never call this tool once per contract, as each call raises its own approval dialog and only the most recent one can be approved. Expire an ACTIVE or PAUSED contract by adjusting its end_date. Allowed status transitions: ACTIVE→EXPIRED, PAUSED→EXPIRED. EXPIRED is terminal — calling on an already-expired contract returns 400; do NOT retry, do NOT escalate to deleteContract or any other destructive tool as a fallback. Verify contract.status via getContractById before calling. Idempotency: NO. The contract expires at end of day 23:59:59.999999. Host enforces user confirmation via the approval gate; do NOT ask the user to re-confirm before calling.",
       "needsApproval": true,
       "approvalConfig": {
         "title": "Expire Contract",
         "description": "This will set the contract's end_date and transition status to EXPIRED. EXPIRED is terminal.",
-        "warningText": "Once expired, the contract cannot be re-activated through this endpoint. Future-dated phases beyond the expiry will be removed.",
+        "warningText": "Approving this expires EVERY contract listed in contractIds — review the full list before confirming. Expiry is terminal: contracts cannot be re-activated through this endpoint, and future-dated phases beyond the expiry will be removed.",
         "confirmText": "Expire Contract",
         "cancelText": "Cancel",
-        "sensitiveFields": ["contractId", "expiry_date"]
+        "sensitiveFields": ["contractIds", "expiry_date"]
       },
       "args": [
         {
-          "name": "contractId",
-          "description": "The unique identifier (UUID) of the contract to expire.",
-          "type": "string",
+          "name": "contractIds",
+          "description": "UUIDs of the contracts to expire. Always a list, even for one contract. Pass every contract in one call. Each contract expires independently. The result reports each one.",
+          "type": "array",
           "required": true,
           "position": "path"
         },
@@ -3777,8 +3777,9 @@
           "position": "body"
         }
       ],
+      "bulkOver": { "listArg": "contractIds", "maxBatch": 25 },
       "requestTemplate": {
-        "url": "/contract_v2/{contractId}/expire",
+        "url": "/contract_v2/{contractIds}/expire",
         "method": "PATCH",
         "headers": {
           "Content-Type": "application/json"