mcp-zenskar 2.2.0 → 2.2.1

package/README.md

@@ -113,7 +113,7 @@ Once configured, you can ask Claude to interact with your Zenskar data:
 "Create a $25 credit note against the latest invoice for customer X"
 "Show me the balance sheet and income statement"
 "List all products and their pricing configurations"
-"Record a $1000 manual payment against invoice Y"
+"Record a $1000 successful manual payment or tax withheld amount against invoice Y"
 ```
 
 ## Available Tools
@@ -188,7 +188,7 @@ Once configured, you can ask Claude to interact with your Zenskar data:
 | --------------------- | ---------------------------------------------------------------------- |
 | `listAllPayments`     | List all payments with filtering and sorting, including refund records |
 | `getPaymentById`      | Get a payment by ID                                                    |
-| `createPayment`       | Record a payment against an invoice                                    |
+| `createPayment`       | Record a successful manual/offline payment or tax withheld amount      |
 | `updatePayment`       | Update a payment's invoice allocations (`payment_parts`)               |
 | `deleteManualPayment` | Delete a manual payment                                                |
 | `editManualPayment`   | Edit a manual payment's amount or method                               |

package/dist/mcp-config.json

@@ -3799,7 +3799,7 @@
     },
     {
       "name": "createPayment",
-      "description": "Record a payment. Link to invoices via payment_parts array. Payment method enum: card, cash, check, charge_back, bank_transfer, direct_debit, other, credits, etc. Type enum: payment, refund, payment_reversal, authorization, tax_withheld. For manual payments use payment_method='other' and type='payment'.",
+      "description": "Record a successful manual/offline payment or tax-withheld amount, equivalent to the frontend Add Payment flow. Link to invoices via payment_parts array. Use type='payment' with payment_method='bank_transfer', 'check', 'cash', or 'card'. Use type='tax_withheld' without payment_method. Always use status='success'. Do not use status='created' for manually recorded payments; created payments are unrealized and will not reduce invoice amount_due or mark invoices paid. The backend assigns the payment timestamp when the payment is recorded. Refunds, authorizations, reversals, payment links, and gateway charge attempts are outside this tool's scope.",
       "args": [
         {
           "name": "customer_id",
@@ -3831,47 +3831,37 @@
         },
         {
           "name": "payment_method",
-          "description": "Payment method: card, cash, check, charge_back, bank_transfer, direct_debit, other, credits, ach_credit_transfer, etc. Use 'other' for manual payments.",
+          "description": "Manual payment method. Required when type='payment'; omit for type='tax_withheld'. Supported values match the frontend Add Payment flow.",
           "type": "string",
           "required": false,
           "position": "body",
           "enum": [
-            "card",
-            "cash",
-            "check",
-            "charge_back",
             "bank_transfer",
-            "direct_debit",
-            "amazon_payments",
-            "paypal_express_checkout",
-            "upi",
-            "netbanking_emandates",
-            "other",
-            "credits",
-            "ach_credit_transfer"
+            "check",
+            "cash",
+            "card"
           ]
         },
         {
           "name": "type",
-          "description": "Payment type: payment, refund, payment_reversal, authorization, or tax_withheld.",
+          "description": "Frontend Add Payment type. Use 'payment' for a manual/offline payment, or 'tax_withheld' for a tax withheld amount. Refunds, payment reversals, and authorizations are outside this tool's scope.",
           "type": "string",
           "required": false,
           "position": "body",
           "default": "payment",
           "enum": [
             "payment",
-            "refund",
-            "payment_reversal",
-            "authorization",
             "tax_withheld"
           ]
         },
         {
           "name": "status",
-          "description": "Payment status.",
+          "description": "Payment status for this recorded payment. Use 'success' for manually recorded/offline payments so linked invoices are marked paid when payment_parts cover the amount due.",
           "type": "string",
           "required": false,
-          "position": "body"
+          "position": "body",
+          "default": "success",
+          "enum": ["success"]
         },
         {
           "name": "external_id",
@@ -3879,13 +3869,6 @@
           "type": "string",
           "required": false,
           "position": "body"
-        },
-        {
-          "name": "timestamp",
-          "description": "Payment timestamp in ISO 8601 format.",
-          "type": "string",
-          "required": false,
-          "position": "body"
         }
       ],
       "requestTemplate": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-zenskar",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Model Context Protocol (MCP) server for Zenskar API - customer management, invoicing, and billing operations",
   "type": "module",
   "main": "dist/server.mjs",