{
  "title": "Coffee brew ratio calculator",
  "human_url": "https://happytails.ai/en/calculators/coffee-brew-ratio-calculator/",
  "agent_url": "https://happytails.ai/agents/en/calculators/coffee-brew-ratio-calculator/",
  "language": "en",
  "markdown_url": "https://happytails.ai/en/calculators/coffee-brew-ratio-calculator.md",
  "content": "Coffee brew ratio calculator\nCalculate coffee or water from a brew ratio, then check extraction using measured beverage mass and TDS.\nHow can we improve this tool?\nReport a problem or share an idea.\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\nHow to use Coffee brew ratio calculator\nEnter the measurements and assumptions for this recipe or plan.\nReview the calculated quantities and their stated basis.\nDownload the report and verify it against your measured result.\nUseful next steps\nCoffee dilution calculator\nIngredient density converter\nUse mass for the ratio\nA 1:16 coffee-to-water ratio needs 320 g water for 20 g coffee. The brew water is not necessarily the same mass as the drink in your cup.\nMeasure extraction separately\nExtraction yield uses finished beverage mass multiplied by measured TDS, divided by dry coffee dose. A 300 g drink at 1.35% TDS from 20 g coffee gives 20.25% extraction. It does not score flavor.\nSave the result\nDownload CSV and a text or JSON report with the calculation and its assumptions. Processing stays on your device. Check measurements and selected units before using the result.",
  "content_format": "text/plain",
  "visibility": "public",
  "links": [
    {
      "name": "Coffee dilution calculator",
      "url": "https://happytails.ai/en/calculators/coffee-dilution-calculator/"
    },
    {
      "name": "Ingredient density converter",
      "url": "https://happytails.ai/en/calculators/ingredient-density-converter/"
    }
  ],
  "tool": {
    "id": "coffee-brew-ratio-calculator",
    "category": "calculators",
    "built": true,
    "requirements": "Positive coffee and water masses. TDS is a percentage by mass. Inputs implying more extracted solids than the dry dose are rejected.",
    "implementation": {
      "fields": [
        {
          "key": "mode",
          "label": "Calculate",
          "value": "Coffee dose to water",
          "type": "select",
          "values": [
            "Coffee dose to water",
            "Water to coffee dose",
            "Measure extraction"
          ]
        },
        {
          "key": "coffee",
          "label": "Dry coffee dose",
          "value": 20,
          "type": "number",
          "min": 0,
          "max": 100000000,
          "step": "any",
          "showWhen": {
            "mode": [
              "Coffee dose to water",
              "Measure extraction"
            ]
          }
        },
        {
          "key": "water",
          "label": "Brew water mass",
          "value": 320,
          "type": "number",
          "min": 0,
          "max": 100000000,
          "step": "any",
          "showWhen": {
            "mode": [
              "Water to coffee dose",
              "Measure extraction"
            ]
          }
        },
        {
          "key": "ratio",
          "label": "Water mass per 1 part coffee",
          "value": 16,
          "type": "number",
          "min": 0.01,
          "max": 100,
          "step": "any",
          "showWhen": {
            "mode": [
              "Coffee dose to water",
              "Water to coffee dose"
            ]
          }
        },
        {
          "key": "beverage",
          "label": "Measured finished beverage mass",
          "value": 300,
          "type": "number",
          "min": 0,
          "max": 100000000,
          "step": "any",
          "showWhen": {
            "mode": [
              "Measure extraction"
            ]
          }
        },
        {
          "key": "tds",
          "label": "Measured beverage TDS (%)",
          "value": 1.35,
          "type": "number",
          "min": 0,
          "max": 100,
          "step": "any",
          "showWhen": {
            "mode": [
              "Measure extraction"
            ]
          }
        },
        {
          "key": "massUnit",
          "label": "Mass unit",
          "value": "g",
          "type": "select",
          "values": [
            "g",
            "kg",
            "oz",
            "lb"
          ]
        }
      ],
      "input": false,
      "live": true,
      "presentation": "metrics",
      "note": "Brew ratio uses the water added. Extraction yield uses the finished beverage mass and measured TDS; they are different quantities. Calculated on your device. Changing units keeps the entered numbers.",
      "experience": {
        "automatic": true,
        "single": false,
        "inputMaxLength": 1000000,
        "inputMode": "text",
        "label": "Your text",
        "placeholder": "Type or paste your input…",
        "help": "Change the input or settings to update your result. Results update as you type. Up to 1,000,000 characters.",
        "action": null
      },
      "mode": "automatic",
      "interactive": false
    },
    "execution": "Browser interface",
    "api": null,
    "browser_agent": {
      "supported": true,
      "name": "run_current_tool",
      "discovery": "WebMCP on the human page in a supporting browser",
      "verification": "See audit/API-AUDIT.md; availability is not verification"
    }
  },
  "markdown": "# Coffee brew ratio calculator\n\n- Human page: https://happytails.ai/en/calculators/coffee-brew-ratio-calculator/\n- Markdown: https://happytails.ai/en/calculators/coffee-brew-ratio-calculator.md\n- Structured JSON: https://happytails.ai/agents/en/calculators/coffee-brew-ratio-calculator/index.json\n- Visibility: public\n\n## Tool capabilities\n\n| Property | Value |\n| --- | --- |\n| Tool ID | `coffee-brew-ratio-calculator` |\n| Category | calculators |\n| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |\n| Browser execution | Automatic updates after valid input or file selection. |\n| Browser processing | Browser; see tool notes for network behavior. |\n| HTTP API | Not callable through HTTP. |\n| Browser-agent interface | run_current_tool |\n\n### Implementation notes\n\nBrew ratio uses the water added. Extraction yield uses the finished beverage mass and measured TDS; they are different quantities. Calculated on your device. Changing units keeps the entered numbers.\n\n### Inputs and settings\n\nNo free-text input is required. Use the file inputs and/or settings below.\n\n| Setting | Meaning | Control type | Default | Constraints |\n| --- | --- | --- | --- | --- |\n| `mode` | Calculate | select | \"Coffee dose to water\" | Allowed: Coffee dose to water, Water to coffee dose, Measure extraction |\n| `coffee` | Dry coffee dose | number | 20 | min=0 max=100000000 step=any |\n| `water` | Brew water mass | number | 320 | min=0 max=100000000 step=any |\n| `ratio` | Water mass per 1 part coffee | number | 16 | min=0.01 max=100 step=any |\n| `beverage` | Measured finished beverage mass | number | 300 | min=0 max=100000000 step=any |\n| `tds` | Measured beverage TDS (%) | number | 1.35 | min=0 max=100 step=any |\n| `massUnit` | Mass unit | select | \"g\" | Allowed: g, kg, oz, lb |\n\n### Browser-agent workflow\n\n1. Open the human page in a browser that supports WebMCP.\n2. Discover the interface exposed by that page; use its actual schema.\n3. Select files on the page first when the tool requires files.\n4. Call `run_current_tool` with valid input and settings.\n5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.\n\nCalls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.\n\n### Planning specification\n\nPositive coffee and water masses. TDS is a percentage by mass. Inputs implying more extracted solids than the dry dose are rejected.\n\nThis describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.\n\n### Complete machine-readable capability record\n\n```json\n{\n  \"id\": \"coffee-brew-ratio-calculator\",\n  \"category\": \"calculators\",\n  \"built\": true,\n  \"requirements\": \"Positive coffee and water masses. TDS is a percentage by mass. Inputs implying more extracted solids than the dry dose are rejected.\",\n  \"implementation\": {\n    \"fields\": [\n      {\n        \"key\": \"mode\",\n        \"label\": \"Calculate\",\n        \"value\": \"Coffee dose to water\",\n        \"type\": \"select\",\n        \"values\": [\n          \"Coffee dose to water\",\n          \"Water to coffee dose\",\n          \"Measure extraction\"\n        ]\n      },\n      {\n        \"key\": \"coffee\",\n        \"label\": \"Dry coffee dose\",\n        \"value\": 20,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100000000,\n        \"step\": \"any\",\n        \"showWhen\": {\n          \"mode\": [\n            \"Coffee dose to water\",\n            \"Measure extraction\"\n          ]\n        }\n      },\n      {\n        \"key\": \"water\",\n        \"label\": \"Brew water mass\",\n        \"value\": 320,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100000000,\n        \"step\": \"any\",\n        \"showWhen\": {\n          \"mode\": [\n            \"Water to coffee dose\",\n            \"Measure extraction\"\n          ]\n        }\n      },\n      {\n        \"key\": \"ratio\",\n        \"label\": \"Water mass per 1 part coffee\",\n        \"value\": 16,\n        \"type\": \"number\",\n        \"min\": 0.01,\n        \"max\": 100,\n        \"step\": \"any\",\n        \"showWhen\": {\n          \"mode\": [\n            \"Coffee dose to water\",\n            \"Water to coffee dose\"\n          ]\n        }\n      },\n      {\n        \"key\": \"beverage\",\n        \"label\": \"Measured finished beverage mass\",\n        \"value\": 300,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100000000,\n        \"step\": \"any\",\n        \"showWhen\": {\n          \"mode\": [\n            \"Measure extraction\"\n          ]\n        }\n      },\n      {\n        \"key\": \"tds\",\n        \"label\": \"Measured beverage TDS (%)\",\n        \"value\": 1.35,\n        \"type\": \"number\",\n        \"min\": 0,\n        \"max\": 100,\n        \"step\": \"any\",\n        \"showWhen\": {\n          \"mode\": [\n            \"Measure extraction\"\n          ]\n        }\n      },\n      {\n        \"key\": \"massUnit\",\n        \"label\": \"Mass unit\",\n        \"value\": \"g\",\n        \"type\": \"select\",\n        \"values\": [\n          \"g\",\n          \"kg\",\n          \"oz\",\n          \"lb\"\n        ]\n      }\n    ],\n    \"input\": false,\n    \"live\": true,\n    \"presentation\": \"metrics\",\n    \"note\": \"Brew ratio uses the water added. Extraction yield uses the finished beverage mass and measured TDS; they are different quantities. Calculated on your device. Changing units keeps the entered numbers.\",\n    \"experience\": {\n      \"automatic\": true,\n      \"single\": false,\n      \"inputMaxLength\": 1000000,\n      \"inputMode\": \"text\",\n      \"label\": \"Your text\",\n      \"placeholder\": \"Type or paste your input…\",\n      \"help\": \"Change the input or settings to update your result. Results update as you type. Up to 1,000,000 characters.\",\n      \"action\": null\n    },\n    \"mode\": \"automatic\",\n    \"interactive\": false\n  },\n  \"execution\": \"Browser interface\",\n  \"api\": null,\n  \"browser_agent\": {\n    \"supported\": true,\n    \"name\": \"run_current_tool\",\n    \"discovery\": \"WebMCP on the human page in a supporting browser\",\n    \"verification\": \"See audit/API-AUDIT.md; availability is not verification\"\n  }\n}\n```\n\n## Page guide\n\nCalculate coffee or water from a brew ratio, then check extraction using measured beverage mass and TDS.\n\nHow can we improve this tool?\n\nReport a problem or share an idea.\n\nPlease leave out private information. Your message and the tool name go to our team via PostHog.\n\n### How to use Coffee brew ratio calculator\n\n1. Enter the measurements and assumptions for this recipe or plan.\n2. Review the calculated quantities and their stated basis.\n3. Download the report and verify it against your measured result.\n\n## Useful next steps\n\n- [Coffee dilution calculator](https://happytails.ai/en/calculators/coffee-dilution-calculator/) ([Markdown](https://happytails.ai/en/calculators/coffee-dilution-calculator.md))\n\n- [Ingredient density converter](https://happytails.ai/en/calculators/ingredient-density-converter/) ([Markdown](https://happytails.ai/en/calculators/ingredient-density-converter.md))\n\n## Use mass for the ratio\n\nA 1:16 coffee-to-water ratio needs 320 g water for 20 g coffee. The brew water is not necessarily the same mass as the drink in your cup.\n\n### Measure extraction separately\n\nExtraction yield uses finished beverage mass multiplied by measured TDS, divided by dry coffee dose. A 300 g drink at 1.35% TDS from 20 g coffee gives 20.25% extraction. It does not score flavor.\n\n### Save the result\n\nDownload CSV and a text or JSON report with the calculation and its assumptions. Processing stays on your device. Check measurements and selected units before using the result.\n"
}