Cups to Grams

Converts a kitchen amount between volume and weight for a specific ingredient, using measured grams-per-cup values (USDA FoodData Central portion weights with FDC ids, and the King Arthur Baking ingredient weight chart) instead of guessed densities. 271 ingredients. Units: US cup (236.5882365 mL), metric cup (250 mL), imperial cup, US legal cup (240 mL), Japanese cup, US/metric/Australian tablespoons, teaspoons, US and imperial fl oz, pints, quarts, gallons, mL, dL, L, g, mg, kg, oz, lb and sticks of butter. Volume to volume and weight to weight need no ingredient. States which cup definition it used and cites the density source.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Quantity to convert, e.g. 1.5. Use decimals for fractions (3/4 = 0.75)."
    },
    "from_unit": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Unit to convert from, e.g. cup, us_cup, metric_cup, tbsp, tsp, fl oz, ml, l, g, oz, lb, stick."
    },
    "to_unit": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Unit to convert to, e.g. g, oz, cup, ml."
    },
    "ingredient": {
      "type": "string",
      "maxLength": 80,
      "description": "Ingredient name, e.g. \"all-purpose flour\", \"brown sugar\", \"honey\". Required when converting between volume and weight."
    },
    "cup_system": {
      "type": "string",
      "enum": [
        "us",
        "metric",
        "imperial"
      ],
      "description": "Which cup and spoon family the bare words cup, tbsp, tsp, fl oz and pint mean. us = 236.588 mL cup (default), metric = 250 mL cup with 15/5 mL spoons, imperial = 284.13 mL cup with UK pints. Explicit units such as metric_cup always win."
    }
  },
  "required": [
    "amount",
    "from_unit",
    "to_unit"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fuzzy search over the ingredient table (flours, sugars, fats, dairy, liquids, nuts, grains, fruit, produce). Returns canonical names, grams per US cup and per tablespoon, and the source (USDA FDC id or King Arthur Baking chart). Use it to pick the exact ingredient before converting.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Ingredient name or part of it, e.g. \"flour\", \"confectioners sugar\", \"oats\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Maximum results. Default 10."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Scales a list of recipe ingredient lines ("1 1/2 cups all-purpose flour", "2 tbsp honey", "3 eggs") by a factor or from original to target servings. Parses mixed numbers and fraction characters. With to_metric_weights, converts cup and spoon amounts to grams with the measured density table and weights to grams, and reports lines it could not match.

{
  "type": "object",
  "properties": {
    "lines": {
      "minItems": 1,
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "description": "Ingredient lines, one per item, quantity first."
    },
    "factor": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Multiply every quantity by this, e.g. 2 or 0.5. Or give servings instead."
    },
    "original_servings": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000,
      "description": "Servings the recipe makes now."
    },
    "target_servings": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000,
      "description": "Servings you want."
    },
    "to_metric_weights": {
      "type": "boolean",
      "description": "Also give grams for each line. Default false."
    },
    "cup_system": {
      "type": "string",
      "enum": [
        "us",
        "metric",
        "imperial"
      ],
      "description": "Which cup and spoon family the bare words cup, tbsp, tsp, fl oz and pint mean. us = 236.588 mL cup (default), metric = 250 mL cup with 15/5 mL spoons, imperial = 284.13 mL cup with UK pints. Explicit units such as metric_cup always win."
    }
  },
  "required": [
    "lines"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Converts an oven setting between Fahrenheit, Celsius and UK gas mark (1/4 to 10, from the standard recipe table) and optionally adjusts for a fan (convection) oven by 20 C, the manufacturer guidance. Returns the nearest gas mark and whether it is an exact table value.

{
  "type": "object",
  "properties": {
    "value": {
      "type": "number",
      "description": "Temperature or gas mark, e.g. 350, 180 or 4."
    },
    "from_scale": {
      "type": "string",
      "enum": [
        "F",
        "C",
        "gas"
      ],
      "description": "Scale of value: F, C or gas (gas mark)."
    },
    "fan": {
      "type": "string",
      "enum": [
        "none",
        "conventional_to_fan",
        "fan_to_conventional"
      ],
      "description": "Fan oven adjustment. Default none."
    }
  },
  "required": [
    "value",
    "from_scale"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}