{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"coffee-ratio"},"result":{"entity_type":"calculator","id":"coffee-ratio","calculator_id":"coffee-ratio","canonical_url":"https://tttkmbb.com/food/coffee-ratio","name":"Coffee Ratio Calculator","title":"Coffee to Water Ratio Calculator – Grams of Coffee for Drip, Pour-Over, French Press, Espresso, Cold Brew and AeroPress","category":"food","category_name":"Food & Cooking","tool_name":"calculate_coffee_ratio","featured_mcp_tool":false,"description":"Computes the grams of ground coffee for a given amount of water (or the water for a given dose) from a brew ratio, using method-specific default ratios (drip and pour-over 1:16, French press 1:15, AeroPress 1:13, cold brew concentrate 1:8, espresso 1:2) or a custom ratio.","use_when":"You want to know how much coffee to use for a certain volume of water, how much water a dose of coffee needs, or the ratio implied by amounts you already used.","do_not_use_when":"You need caffeine content or extraction/TDS calculations; ratios here are by weight of dry coffee and water only.","inputs":[{"name":"water_ml","label":"Water","type":"number","unit":"ml","required":false,"max":100000,"exclusive_min":0,"description":"Brew water in millilitres (≈ grams). Give this and/or coffee_g.","example":500},{"name":"coffee_g","label":"Coffee","type":"number","unit":"g","required":false,"max":10000,"exclusive_min":0,"description":"Ground coffee in grams. If both water_ml and coffee_g are given, the calculator reports the ratio they imply.","example":30},{"name":"brew_method","label":"Brew method","type":"enum","required":false,"default":"drip","values":[{"value":"drip","label":"Drip / filter machine (1:16)","aliases":["filter","batch brew"]},{"value":"pour_over","label":"Pour-over (1:16)","aliases":["pour over","v60","chemex","pourover"]},{"value":"french_press","label":"French press (1:15)","aliases":["french press","press","cafetiere","plunger"]},{"value":"aeropress","label":"AeroPress (1:13)","aliases":["aero press"]},{"value":"cold_brew","label":"Cold brew concentrate (1:8)","aliases":["cold brew"]},{"value":"espresso","label":"Espresso, beverage weight (1:2)"}],"description":"Sets the default ratio (water parts per 1 part coffee) when no custom ratio is given.","example":"drip"},{"name":"ratio","label":"Custom ratio (water per 1 coffee)","type":"number","required":false,"min":1,"max":30,"description":"Water parts per 1 part coffee by weight, e.g. 16 for 1:16; overrides the brew-method default.","example":16}],"outputs":[{"name":"coffee_g","label":"Coffee","type":"number","unit":"g","decimals":1,"description":"Ground coffee dose."},{"name":"water_ml","label":"Water","type":"number","unit":"ml","decimals":0,"description":"Brew water (for espresso: beverage weight in grams)."},{"name":"ratio","label":"Ratio (water : coffee)","type":"number","decimals":2,"description":"Water parts per 1 part coffee."},{"name":"ratio_text","label":"Ratio","type":"string","decimals":4,"description":"Ratio written as 1:N."},{"name":"coffee_g_per_liter","label":"Coffee concentration","type":"number","unit":"g/L","decimals":1,"description":"Grams of coffee per litre of water; the SCA Golden Cup range for filter coffee is 55 g/L ± 10 % (49.5–60.5 g/L)."},{"name":"tablespoons_approx","label":"Tablespoons (approx.)","type":"number","unit":"tbsp","decimals":1,"description":"Approximate volume of the dose at ~5.5 g of medium-ground coffee per level tablespoon; a scale is more accurate."}],"input_schema":{"type":"object","properties":{"water_ml":{"description":"Brew water in millilitres (≈ grams). Give this and/or coffee_g. Unit: ml.","type":"number","maximum":100000,"exclusiveMinimum":0,"examples":[500],"x-unit":"ml"},"coffee_g":{"description":"Ground coffee in grams. If both water_ml and coffee_g are given, the calculator reports the ratio they imply. Unit: g.","type":"number","maximum":10000,"exclusiveMinimum":0,"examples":[30],"x-unit":"g"},"brew_method":{"description":"Sets the default ratio (water parts per 1 part coffee) when no custom ratio is given.","type":"string","enum":["drip","pour_over","french_press","aeropress","cold_brew","espresso"],"default":"drip","examples":["drip"]},"ratio":{"description":"Water parts per 1 part coffee by weight, e.g. 16 for 1:16; overrides the brew-method default.","type":"number","minimum":1,"maximum":30,"examples":[16]}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"coffee_g":{"description":"Ground coffee dose. Unit: g.","type":"number","x-unit":"g"},"water_ml":{"description":"Brew water (for espresso: beverage weight in grams). Unit: ml.","type":"number","x-unit":"ml"},"ratio":{"description":"Water parts per 1 part coffee.","type":"number"},"ratio_text":{"description":"Ratio written as 1:N.","type":"string"},"coffee_g_per_liter":{"description":"Grams of coffee per litre of water; the SCA Golden Cup range for filter coffee is 55 g/L ± 10 % (49.5–60.5 g/L). Unit: g/L.","type":"number","x-unit":"g/L"},"tablespoons_approx":{"description":"Approximate volume of the dose at ~5.5 g of medium-ground coffee per level tablespoon; a scale is more accurate. Unit: tbsp.","type":"number","x-unit":"tbsp"}}},"formula":"coffee_g = water_ml / ratio (or water_ml = coffee_g × ratio); coffee_g_per_liter = 1000 / ratio; tablespoons ≈ coffee_g / 5.5","method":"Ratios are by weight; 1 ml of water weighs 1 g. The SCA Golden Cup Standard (55 g/L ± 10 %) corresponds to about 1:16.5–1:20; espresso ratios describe beverage yield rather than water added.","sources":[{"name":"Specialty Coffee Association – Brewing best practices and Golden Cup Standard (55 g/L ± 10 %)","url":"https://sca.coffee/research/protocols-best-practices","type":"standard","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"500 ml drip coffee","inputs":{"water_ml":500,"brew_method":"drip"},"expected":{"coffee_g":31.3,"water_ml":500,"ratio":16,"ratio_text":"1:16","coffee_g_per_liter":62.5},"url":"https://tttkmbb.com/api/v1/calculate/coffee-ratio?water_ml=500&brew_method=drip"},{"name":"18 g espresso dose","inputs":{"coffee_g":18,"brew_method":"espresso"},"expected":{"water_ml":36,"coffee_g":18,"ratio":2,"ratio_text":"1:2"},"url":"https://tttkmbb.com/api/v1/calculate/coffee-ratio?coffee_g=18&brew_method=espresso"}],"faq":[{"q":"Should I measure water in ml or grams?","a":"They are interchangeable for brewing (1 ml = 1 g). Weighing both coffee and water on a scale is the most repeatable method."},{"q":"Why does cold brew use 1:8?","a":"That is a concentrate ratio; dilute the finished brew roughly 1:1 with water or milk. For ready-to-drink cold brew use about 1:15."}],"tags":["coffee ratio","coffee to water ratio","how much coffee","pour over ratio","french press ratio","espresso ratio"],"related":[{"calculator_id":"cooking-converter","reason":"Convert cups or fluid ounces of water to millilitres first."}],"links":{"html":"https://tttkmbb.com/food/coffee-ratio","markdown":"https://tttkmbb.com/food/coffee-ratio.md","json":"https://tttkmbb.com/food/coffee-ratio.json","api":"https://tttkmbb.com/api/v1/calculate/coffee-ratio","schema":"https://tttkmbb.com/api/v1/calculators/coffee-ratio","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:31:45Z","next_actions":[{"tool":"run_calculator","calculator_id":"coffee-ratio","reason":"Run Coffee Ratio Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/food/coffee-ratio.md"}}