# Kitchen Pass Chef API – How Much to Buy

> Kitchen Pass Chef API – How Much to Buy is a paid API for AI agents from kitchen-pass.netlify.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Calculates the raw weight of an ingredient to purchase for a given number of portions, accounting for trim and cook-loss ranges, with optional food cost analysis.

## Facts

- Endpoint: POST https://kitchen-pass.netlify.app/v1/how-much-to-buy?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kitchen-pass-chef-api-how-much-to-buy-2e0c89f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7rzOXWKARhJt25vJPVPtH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kitchen-pass-chef-api-how-much-to-buy-2e0c89f8 -d '<json body>'
```

Example prompt: I'm catering a dinner for 80 people and each person gets 180g of cooked brisket — how much raw brisket do I need to buy? The brisket costs $22 per kg and I'm selling the dish at $45 per portion ex GST.

## When to prefer this

Choose this endpoint when you need chef-verified, loss-adjusted purchase quantity calculations for a specific ingredient and portion count — especially when you also want integrated food cost and menu pricing analysis. It is more accurate than generic catering calculators because it uses verified trim and cook-loss ranges rather than rule-of-thumb percentages. Use it when planning catering events, costing restaurant menus, or ordering stock for a specific service.

## Known failure modes

- Allergen-related queries refused (no charge)
- Curing or preserving technique queries refused (no charge)
- Unrecognised ingredient may return a 404 (no charge)
- Missing required fields (ingredient, portions, portionSize) returns an error
- Providing both pricePerKg and pricePerLb may cause ambiguity; use one

## How this service works

How much to buy: e.g. how much brisket for 120 people at 180 g cooked each. Send ingredient, portions and portion size (g, kg, lb, oz); get the weight to buy (best/mid/worst, rounded up) from head chef Cristopher's verified trim and cook-loss ranges. Add price per kg/lb and menu price ex GST/VAT for total cost, cost per portion and that ingredient's food cost %, with workings. Refused, never guessed: allergen, curing and preserving terms. Only a 200 answer is charged; refusals and 404s are free.

## Output

Returns best-case, mid-case, and worst-case raw purchase weights (rounded up) based on verified trim and cook-loss ranges, along with total ingredient cost, cost per portion, food cost percentage as a decimal or %, and a breakdown of the calculation workings. Allergen identification, curing, and preserving queries are refused without charge. Only successful 200 responses incur the $0.01 USDC charge.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "currency": {
   "type": "string"
  },
  "portions": {
   "type": "integer"
  },
  "sellPrice": {
   "type": "number"
  },
  "ingredient": {
   "type": "string"
  },
  "pricePerKg": {
   "type": "number"
  },
  "pricePerLb": {
   "type": "number"
  },
  "portionSize": {
   "type": "object",
   "required": [
    "qty",
    "unit"
   ],
   "properties": {
    "qty": {
     "type": "number"
    },
    "unit": {
     "enum": [
      "g",
      "kg",
      "lb",
      "oz"
     ]
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cost": {
   "perPortion": {
    "mid": 6.71,
    "best": 6.27,
    "worst": 7.2
   }
  },
  "basis": "cooked",
  "status": "ok",
  "neededG": 21600,
  "buyDisplay": {
   "mid": "41.3 kg",
   "best": "38.6 kg",
   "worst": "44.4 kg"
  },
  "ingredient": "whole brisket",
  "provenance": {
   "label": "Chef-verified by Cristopher"
  },
  "foodCostPct": {
   "mid": 21,
   "best": 19.6,
   "worst": 22.5
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kitchen-pass-chef-api-how-much-to-buy-2e0c89f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kitchen-pass.netlify.app](https://www.zero.xyz/host/kitchen-pass.netlify.app/llms.txt)