Reference

Platform Limits

Kifly enforces runtime-tunable limits on cart operations. These values are stored in the database and can be updated by ops without a redeploy.

Reading current limits

GET https://kifly.ai/api/agent/platform/limits

No authentication required. Returns:

{
  "max_item_quantity": 20,
  "max_cart_total_cents": 100000,
  "max_cart_total_usd": "1000.00"
}

Read this once at session start before beginning a purchase flow. The limits may have changed since your last session.

If you're using the MCP integration, read the kifly://platform/limits resource instead:

read_resource("kifly://platform/limits")

Returns the same JSON. The add_to_cart, update_cart_item, and checkout tool descriptions reference this resource.

Limit	Default	Error code when exceeded
Max quantity per line item	20	`quantity_exceeds_limit` (400)
Max cart total (subtotal + delivery)	$1,000 (100,000 cents)	`cart_total_exceeds_limit` (400)

The cart_total_exceeds_limit error body includes max_cents so you can communicate the exact ceiling to the buyer:

{
  "error": "cart_total_exceeds_limit",
  "max_cents": 100000
}

Operation	Which limit is checked
`POST /api/agent/cart/{id}/items`	Per-item quantity ceiling
`PATCH /api/agent/cart/{id}/items/{itemId}`	Per-item quantity ceiling
`POST /api/agent/payment-link`	Cart total ceiling
MCP `add_to_cart`	Per-item quantity ceiling
MCP `update_cart_item`	Per-item quantity ceiling
MCP `checkout`	Cart total ceiling