Skip to main content
Glama
Sign In
Continente MCP

Continente MCP

by andredelgado
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Set cart quantity

set_cart_item_quantity
DestructiveIdempotent

Set the exact quantity of a product in the cart, adding it if missing or removing it when zero. Use cartItemId to target a specific line when duplicates exist.

Instructions

Make the cart hold exactly this quantity of a product, adding it if it is not there yet. Zero removes it. Pass cartItemId from get_cart when the product has more than one line. If the result has mutation.outcome "unknown", the cart may have changed: call get_cart before any further change and never repeat the request automatically.

Input Schema

NameRequiredDescriptionDefault
quantityYesDesired total in the product sale unit. Zero removes the item.
productIdYesproductId from another tool, such as "00123". A product slug ending in that ID (for example "leite-00123") also works.
cartItemIdNoCart line identifier from get_cart. Required to select one of several lines for the same product.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.12.1
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "cartItemId": {
-            "anyOf": [
-              {
-                "maxLength": 200,
-                "minLength": 1,
-                "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "confirmedQuantity": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          "disposition": {
-            "anyOf": [
-              {
-                "enum": [
-                  "removed",
-                  "already_absent"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "observedAt": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-            "type": "string"
-          },
-          "outcome": {
-            "const": "confirmed",
-            "type": "string"
-          },
-          "productId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^\\d+$",
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "productId",
-          "requested",
-          "outcome",
-          "confirmedQuantity",
-          "cartItemId",
-          "disposition",
-          "observedAt"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "enum": [
-          "success",
-          "empty",
-          "partial"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "anyOf": [
-              {
-                "enum": [
-                  "invalid_data",
-                  "invalid_input",
-                  "not_authenticated",
-                  "upstream_unavailable",
-                  "not_found",
-                  "sale_rules_unknown",
-                  "quantity_below_minimum",
-                  "cart_change_rejected",
-                  "cart_change_unconfirmed",
-                  "cache_unavailable",
-                  "order_details_unavailable",
-                  "cancelled",
-                  "deadline_exceeded",
-                  "server_closed",
-                  "queue_full",
-                  "browser_unavailable"
-                ],
-                "type": "string"
-              },
-              {
-                "enum": [
-                  "internal_error",
-                  "invalid_result"
-                ],
-                "type": "string"
-              }
-            ]
-          },
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "path": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "path",
-                "code"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      },
-      "mutation": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "not_applied",
-                "type": "string"
-              }
-            },
-            "required": [
-              "outcome"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "unknown",
-                "type": "string"
-              },
-              "recovery": {
-                "additionalProperties": false,
-                "properties": {
-                  "action": {
-                    "const": "get_cart",
-                    "type": "string"
-                  },
-                  "automaticReplay": {
-                    "const": false,
-                    "type": "boolean"
-                  }
-                },
-                "required": [
-                  "action",
-                  "automaticReplay"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "outcome",
-              "recovery"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "signIn": {
-        "additionalProperties": false,
-        "properties": {
-          "action": {
-            "enum": [
-              "configure_credentials",
-              "check_credentials_or_sign_in"
-            ],
-            "type": "string"
-          },
-          "command": {
-            "const": "continentept-mcp login --show-browser",
-            "type": "string"
-          },
-          "credentials": {
-            "enum": [
-              "configured",
-              "missing",
-              "unknown"
-            ],
-            "type": "string"
-          },
-          "guide": {
-            "format": "uri",
-            "type": "string"
-          },
-          "publicTools": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "settings": {
-            "additionalProperties": false,
-            "properties": {
-              "claudeDesktopExtension": {
-                "items": false,
-                "maxItems": 2,
-                "minItems": 2,
-                "prefixItems": [
-                  {
-                    "const": "email",
-                    "type": "string"
-                  },
-                  {
-                    "const": "password",
-                    "type": "string"
-                  }
-                ],
-                "type": "array"
-              },
-              "environment": {
-                "items": false,
-                "maxItems": 2,
-                "minItems": 2,
-                "prefixItems": [
-                  {
-                    "const": "CONTINENTE_EMAIL",
-                    "type": "string"
-                  },
-                  {
-                    "const": "CONTINENTE_PASSWORD",
-                    "type": "string"
-                  }
-                ],
-                "type": "array"
-              }
-            },
-            "required": [
-              "environment",
-              "claudeDesktopExtension"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "credentials",
-          "action",
-          "settings",
-          "command",
-          "guide",
-          "publicTools"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "cartItemId": {
+            "anyOf": [
+              {
+                "maxLength": 200,
+                "minLength": 1,
+                "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "confirmedQuantity": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          "disposition": {
+            "anyOf": [
+              {
+                "enum": [
+                  "removed",
+                  "already_absent"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "observedAt": {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          "outcome": {
+            "const": "confirmed",
+            "type": "string"
+          },
+          "productId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^\\d+$",
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "productId",
+          "requested",
+          "outcome",
+          "confirmedQuantity",
+          "cartItemId",
+          "disposition",
+          "observedAt"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "enum": [
+          "success",
+          "empty",
+          "partial"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "anyOf": [
+              {
+                "enum": [
+                  "invalid_data",
+                  "invalid_input",
+                  "not_authenticated",
+                  "upstream_unavailable",
+                  "not_found",
+                  "sale_rules_unknown",
+                  "quantity_below_minimum",
+                  "cart_change_rejected",
+                  "cart_change_unconfirmed",
+                  "cache_unavailable",
+                  "order_details_unavailable",
+                  "cancelled",
+                  "deadline_exceeded",
+                  "server_closed",
+                  "queue_full",
+                  "browser_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "enum": [
+                  "internal_error",
+                  "invalid_result"
+                ],
+                "type": "string"
+              }
+            ]
+          },
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "code"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      },
+      "mutation": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "not_applied",
+                "type": "string"
+              }
+            },
+            "required": [
+              "outcome"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "unknown",
+                "type": "string"
+              },
+              "recovery": {
+                "additionalProperties": false,
+                "properties": {
+                  "action": {
+                    "const": "get_cart",
+                    "type": "string"
+                  },
+                  "automaticReplay": {
+                    "const": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "action",
+                  "automaticReplay"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "outcome",
+              "recovery"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "signIn": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "enum": [
+              "configure_credentials",
+              "check_credentials_or_sign_in",
+              "confirm_not_a_robot"
+            ],
+            "type": "string"
+          },
+          "command": {
+            "const": "continentept-mcp login --show-browser",
+            "type": "string"
+          },
+          "credentials": {
+            "enum": [
+              "configured",
+              "missing",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "guide": {
+            "format": "uri",
+            "type": "string"
+          },
+          "publicTools": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "settings": {
+            "additionalProperties": false,
+            "properties": {
+              "claudeDesktopExtension": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "email",
+                    "type": "string"
+                  },
+                  {
+                    "const": "password",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              },
+              "environment": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "CONTINENTE_EMAIL",
+                    "type": "string"
+                  },
+                  {
+                    "const": "CONTINENTE_PASSWORD",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              }
+            },
+            "required": [
+              "environment",
+              "claudeDesktopExtension"
+            ],
+            "type": "object"
+          },
+          "signInWindow": {
+            "anyOf": [
+              {
+                "enum": [
+                  "opened",
+                  "already_open",
+                  "not_available"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "credentials",
+          "action",
+          "signInWindow",
+          "settings",
+          "command",
+          "guide",
+          "publicTools"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changedv0.11.0
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "cartItemId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-            "type": "string"
-          },
-          "confirmedQuantity": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          "disposition": {
-            "enum": [
-              "removed",
-              "already_absent"
-            ],
-            "type": "string"
-          },
-          "outcome": {
-            "const": "confirmed",
-            "type": "string"
-          },
-          "productId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^\\d+$",
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "productId",
-          "requested",
-          "outcome",
-          "confirmedQuantity"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "enum": [
-          "success",
-          "empty",
-          "partial"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "anyOf": [
-              {
-                "enum": [
-                  "invalid_data",
-                  "invalid_input",
-                  "not_authenticated",
-                  "upstream_unavailable",
-                  "not_found",
-                  "sale_rules_unknown",
-                  "quantity_below_minimum",
-                  "cart_change_rejected",
-                  "cart_change_unconfirmed",
-                  "cache_unavailable",
-                  "order_details_unavailable",
-                  "cancelled",
-                  "deadline_exceeded",
-                  "server_closed",
-                  "queue_full",
-                  "browser_unavailable"
-                ],
-                "type": "string"
-              },
-              {
-                "enum": [
-                  "internal_error",
-                  "invalid_result"
-                ],
-                "type": "string"
-              }
-            ]
-          },
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "path": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "path",
-                "code"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      },
-      "mutation": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "not_applied",
-                "type": "string"
-              }
-            },
-            "required": [
-              "outcome"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "unknown",
-                "type": "string"
-              },
-              "recovery": {
-                "additionalProperties": false,
-                "properties": {
-                  "action": {
-                    "const": "get_cart",
-                    "type": "string"
-                  },
-                  "automaticReplay": {
-                    "const": false,
-                    "type": "boolean"
-                  }
-                },
-                "required": [
-                  "action",
-                  "automaticReplay"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "outcome",
-              "recovery"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "signIn": {
-        "additionalProperties": false,
-        "properties": {
-          "action": {
-            "enum": [
-              "configure_credentials",
-              "check_credentials_or_sign_in"
-            ],
-            "type": "string"
-          },
-          "command": {
-            "const": "continentept-mcp login --show-browser",
-            "type": "string"
-          },
-          "credentials": {
-            "enum": [
-              "configured",
-              "missing",
-              "unknown"
-            ],
-            "type": "string"
-          },
-          "guide": {
-            "format": "uri",
-            "type": "string"
-          },
-          "publicTools": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "settings": {
-            "additionalProperties": false,
-            "properties": {
-              "claudeDesktopExtension": {
-                "items": false,
-                "maxItems": 2,
-                "minItems": 2,
-                "prefixItems": [
-                  {
-                    "const": "email",
-                    "type": "string"
-                  },
-                  {
-                    "const": "password",
-                    "type": "string"
-                  }
-                ],
-                "type": "array"
-              },
-              "environment": {
-                "items": false,
-                "maxItems": 2,
-                "minItems": 2,
-                "prefixItems": [
-                  {
-                    "const": "CONTINENTE_EMAIL",
-                    "type": "string"
-                  },
-                  {
-                    "const": "CONTINENTE_PASSWORD",
-                    "type": "string"
-                  }
-                ],
-                "type": "array"
-              }
-            },
-            "required": [
-              "environment",
-              "claudeDesktopExtension"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "credentials",
-          "action",
-          "settings",
-          "command",
-          "guide",
-          "publicTools"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "cartItemId": {
+            "anyOf": [
+              {
+                "maxLength": 200,
+                "minLength": 1,
+                "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "confirmedQuantity": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          "disposition": {
+            "anyOf": [
+              {
+                "enum": [
+                  "removed",
+                  "already_absent"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "observedAt": {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          "outcome": {
+            "const": "confirmed",
+            "type": "string"
+          },
+          "productId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^\\d+$",
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "productId",
+          "requested",
+          "outcome",
+          "confirmedQuantity",
+          "cartItemId",
+          "disposition",
+          "observedAt"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "enum": [
+          "success",
+          "empty",
+          "partial"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "anyOf": [
+              {
+                "enum": [
+                  "invalid_data",
+                  "invalid_input",
+                  "not_authenticated",
+                  "upstream_unavailable",
+                  "not_found",
+                  "sale_rules_unknown",
+                  "quantity_below_minimum",
+                  "cart_change_rejected",
+                  "cart_change_unconfirmed",
+                  "cache_unavailable",
+                  "order_details_unavailable",
+                  "cancelled",
+                  "deadline_exceeded",
+                  "server_closed",
+                  "queue_full",
+                  "browser_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "enum": [
+                  "internal_error",
+                  "invalid_result"
+                ],
+                "type": "string"
+              }
+            ]
+          },
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "code"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      },
+      "mutation": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "not_applied",
+                "type": "string"
+              }
+            },
+            "required": [
+              "outcome"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "unknown",
+                "type": "string"
+              },
+              "recovery": {
+                "additionalProperties": false,
+                "properties": {
+                  "action": {
+                    "const": "get_cart",
+                    "type": "string"
+                  },
+                  "automaticReplay": {
+                    "const": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "action",
+                  "automaticReplay"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "outcome",
+              "recovery"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "signIn": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "enum": [
+              "configure_credentials",
+              "check_credentials_or_sign_in"
+            ],
+            "type": "string"
+          },
+          "command": {
+            "const": "continentept-mcp login --show-browser",
+            "type": "string"
+          },
+          "credentials": {
+            "enum": [
+              "configured",
+              "missing",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "guide": {
+            "format": "uri",
+            "type": "string"
+          },
+          "publicTools": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "settings": {
+            "additionalProperties": false,
+            "properties": {
+              "claudeDesktopExtension": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "email",
+                    "type": "string"
+                  },
+                  {
+                    "const": "password",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              },
+              "environment": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "CONTINENTE_EMAIL",
+                    "type": "string"
+                  },
+                  {
+                    "const": "CONTINENTE_PASSWORD",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              }
+            },
+            "required": [
+              "environment",
+              "claudeDesktopExtension"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "credentials",
+          "action",
+          "settings",
+          "command",
+          "guide",
+          "publicTools"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  3. Changed3 schema fields changedv0.10.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "cartItemId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-            "type": "string"
-          },
-          "confirmedQuantity": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          "disposition": {
-            "enum": [
-              "removed",
-              "already_absent"
-            ],
-            "type": "string"
-          },
-          "outcome": {
-            "const": "confirmed",
-            "type": "string"
-          },
-          "productId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^\\d+$",
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "productId",
-          "requested",
-          "outcome",
-          "confirmedQuantity"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "enum": [
-          "success",
-          "empty",
-          "partial"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "anyOf": [
-              {
-                "enum": [
-                  "invalid_data",
-                  "invalid_input",
-                  "not_authenticated",
-                  "upstream_unavailable",
-                  "not_found",
-                  "sale_rules_unknown",
-                  "quantity_below_minimum",
-                  "cart_change_rejected",
-                  "cart_change_unconfirmed",
-                  "cache_unavailable",
-                  "order_details_unavailable",
-                  "cancelled",
-                  "deadline_exceeded",
-                  "server_closed",
-                  "queue_full",
-                  "browser_unavailable"
-                ],
-                "type": "string"
-              },
-              {
-                "enum": [
-                  "internal_error",
-                  "invalid_result"
-                ],
-                "type": "string"
-              }
-            ]
-          },
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "path": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "path",
-                "code"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      },
-      "mutation": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "not_applied",
-                "type": "string"
-              }
-            },
-            "required": [
-              "outcome"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "unknown",
-                "type": "string"
-              },
-              "recovery": {
-                "additionalProperties": false,
-                "properties": {
-                  "action": {
-                    "const": "get_cart",
-                    "type": "string"
-                  },
-                  "automaticReplay": {
-                    "const": false,
-                    "type": "boolean"
-                  }
-                },
-                "required": [
-                  "action",
-                  "automaticReplay"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "outcome",
-              "recovery"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "status": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "cartItemId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+            "type": "string"
+          },
+          "confirmedQuantity": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          "disposition": {
+            "enum": [
+              "removed",
+              "already_absent"
+            ],
+            "type": "string"
+          },
+          "outcome": {
+            "const": "confirmed",
+            "type": "string"
+          },
+          "productId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^\\d+$",
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "productId",
+          "requested",
+          "outcome",
+          "confirmedQuantity"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "enum": [
+          "success",
+          "empty",
+          "partial"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "anyOf": [
+              {
+                "enum": [
+                  "invalid_data",
+                  "invalid_input",
+                  "not_authenticated",
+                  "upstream_unavailable",
+                  "not_found",
+                  "sale_rules_unknown",
+                  "quantity_below_minimum",
+                  "cart_change_rejected",
+                  "cart_change_unconfirmed",
+                  "cache_unavailable",
+                  "order_details_unavailable",
+                  "cancelled",
+                  "deadline_exceeded",
+                  "server_closed",
+                  "queue_full",
+                  "browser_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "enum": [
+                  "internal_error",
+                  "invalid_result"
+                ],
+                "type": "string"
+              }
+            ]
+          },
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "code"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      },
+      "mutation": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "not_applied",
+                "type": "string"
+              }
+            },
+            "required": [
+              "outcome"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "unknown",
+                "type": "string"
+              },
+              "recovery": {
+                "additionalProperties": false,
+                "properties": {
+                  "action": {
+                    "const": "get_cart",
+                    "type": "string"
+                  },
+                  "automaticReplay": {
+                    "const": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "action",
+                  "automaticReplay"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "outcome",
+              "recovery"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "signIn": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "enum": [
+              "configure_credentials",
+              "check_credentials_or_sign_in"
+            ],
+            "type": "string"
+          },
+          "command": {
+            "const": "continentept-mcp login --show-browser",
+            "type": "string"
+          },
+          "credentials": {
+            "enum": [
+              "configured",
+              "missing",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "guide": {
+            "format": "uri",
+            "type": "string"
+          },
+          "publicTools": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "settings": {
+            "additionalProperties": false,
+            "properties": {
+              "claudeDesktopExtension": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "email",
+                    "type": "string"
+                  },
+                  {
+                    "const": "password",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              },
+              "environment": {
+                "items": false,
+                "maxItems": 2,
+                "minItems": 2,
+                "prefixItems": [
+                  {
+                    "const": "CONTINENTE_EMAIL",
+                    "type": "string"
+                  },
+                  {
+                    "const": "CONTINENTE_PASSWORD",
+                    "type": "string"
+                  }
+                ],
+                "type": "array"
+              }
+            },
+            "required": [
+              "environment",
+              "claudeDesktopExtension"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "credentials",
+          "action",
+          "settings",
+          "command",
+          "guide",
+          "publicTools"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  4. Changed1 schema field changedv0.6.0
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "cartItemId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-            "type": "string"
-          },
-          "confirmedQuantity": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          },
-          "disposition": {
-            "enum": [
-              "removed",
-              "already_absent"
-            ],
-            "type": "string"
-          },
-          "outcome": {
-            "const": "confirmed",
-            "type": "string"
-          },
-          "productId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^\\d+$",
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "unit": {
-                "enum": [
-                  "un",
-                  "kg",
-                  "g",
-                  "l",
-                  "ml"
-                ],
-                "type": "string"
-              },
-              "value": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "value",
-              "unit"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "productId",
-          "requested",
-          "outcome",
-          "confirmedQuantity"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "enum": [
-          "success",
-          "empty",
-          "partial"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "anyOf": [
-              {
-                "enum": [
-                  "invalid_data",
-                  "invalid_input",
-                  "not_authenticated",
-                  "upstream_unavailable",
-                  "not_found",
-                  "sale_rules_unknown",
-                  "quantity_below_minimum",
-                  "cart_change_rejected",
-                  "cart_change_unconfirmed",
-                  "cache_unavailable",
-                  "order_details_unavailable",
-                  "cancelled",
-                  "deadline_exceeded",
-                  "server_closed",
-                  "queue_full"
-                ],
-                "type": "string"
-              },
-              {
-                "enum": [
-                  "internal_error",
-                  "invalid_result"
-                ],
-                "type": "string"
-              }
-            ]
-          },
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "path": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "path",
-                "code"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      },
-      "mutation": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "not_applied",
-                "type": "string"
-              }
-            },
-            "required": [
-              "outcome"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "unknown",
-                "type": "string"
-              },
-              "recovery": {
-                "additionalProperties": false,
-                "properties": {
-                  "action": {
-                    "const": "get_cart",
-                    "type": "string"
-                  },
-                  "automaticReplay": {
-                    "const": false,
-                    "type": "boolean"
-                  }
-                },
-                "required": [
-                  "action",
-                  "automaticReplay"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "outcome",
-              "recovery"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "status": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "cartItemId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+            "type": "string"
+          },
+          "confirmedQuantity": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          },
+          "disposition": {
+            "enum": [
+              "removed",
+              "already_absent"
+            ],
+            "type": "string"
+          },
+          "outcome": {
+            "const": "confirmed",
+            "type": "string"
+          },
+          "productId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^\\d+$",
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "unit": {
+                "enum": [
+                  "un",
+                  "kg",
+                  "g",
+                  "l",
+                  "ml"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "value",
+              "unit"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "productId",
+          "requested",
+          "outcome",
+          "confirmedQuantity"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "enum": [
+          "success",
+          "empty",
+          "partial"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "anyOf": [
+              {
+                "enum": [
+                  "invalid_data",
+                  "invalid_input",
+                  "not_authenticated",
+                  "upstream_unavailable",
+                  "not_found",
+                  "sale_rules_unknown",
+                  "quantity_below_minimum",
+                  "cart_change_rejected",
+                  "cart_change_unconfirmed",
+                  "cache_unavailable",
+                  "order_details_unavailable",
+                  "cancelled",
+                  "deadline_exceeded",
+                  "server_closed",
+                  "queue_full",
+                  "browser_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "enum": [
+                  "internal_error",
+                  "invalid_result"
+                ],
+                "type": "string"
+              }
+            ]
+          },
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "code"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      },
+      "mutation": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "not_applied",
+                "type": "string"
+              }
+            },
+            "required": [
+              "outcome"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "unknown",
+                "type": "string"
+              },
+              "recovery": {
+                "additionalProperties": false,
+                "properties": {
+                  "action": {
+                    "const": "get_cart",
+                    "type": "string"
+                  },
+                  "automaticReplay": {
+                    "const": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "action",
+                  "automaticReplay"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "outcome",
+              "recovery"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "status": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  5. First observedv0.2.0

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the annotations by disclosing the upsert semantics, the destructive side effect of quantity 0, and an explicit failure-recovery rule: on mutation.outcome "unknown", re-read via get_cart and never retry automatically. This is exactly the operational context the destructive/openWorld hints alone cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short sentences, each carrying a distinct load: core semantics, zero case, disambiguation, failure recovery. The most critical rule (the unknown-outcome caution) is placed last where it gets emphasis without burying the main verb.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation, and the description covers everything else an agent needs: mutation semantics, the disambiguation parameter source, and a safe recovery path for an indeterminate outcome on a destructive, open-world operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, so the baseline is 3; the description adds real meaning on top by telling the agent where cartItemId comes from (get_cart) and what condition requires it. The other two parameters are left entirely to the schema, which is adequate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a precise verb and resource plus the exact semantics: 'make the cart hold exactly this quantity', 'adding it if it is not there yet', 'zero removes it'. This immediately distinguishes it from add_cart_item and remove_cart_item without opening their schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives the conditional for cartItemId ('when the product has more than one line') and a recovery protocol for an ambiguous result. It does not name the sibling alternatives (add_cart_item, remove_cart_item) explicitly, but the zero-removes and add-if-absent rules make the routing condition clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools