{
  "title": "CSV column calculator",
  "human_url": "https://happytails.ai/en/data-tools/csv-column-calculator/",
  "agent_url": "https://happytails.ai/agents/en/data-tools/csv-column-calculator/",
  "language": "en",
  "markdown_url": "https://happytails.ai/en/data-tools/csv-column-calculator.md",
  "content": "CSV column calculator\nCalculate new CSV columns from existing values, then review results and errors before downloading.\nHow to use CSV column calculator\nPaste CSV with a unique header and unchanged source values.\nAdd a name,expression CSV of distinct derived columns and choose output decimal precision.\nReview derived values and the located errors CSV, then download the complete CSV and JSON report.\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.\nUseful next steps\nCSV anonymizer\nCSV encoding repair\nExact calculations with explicit rounding\nUse decimals, exact source column names, + - * / and parentheses. Bracket headers containing spaces, for example [unit price]. Exact rational intermediates round only when each final result is written, using nearest with ties to even. Choose 2, 6, 12 or 16 decimal places. Trailing fractional zeros are omitted.\nVisible errors without code execution\nExpressions cannot run JavaScript, call functions, access properties or reference other derived columns. Invalid expressions, missing columns, nonnumeric cells, division by zero and arithmetic bounds leave affected derived cells empty and appear by one-based source record in the errors CSV.\nLocal processing and exact strings\nProcessing runs on your device. CSV downloads quote every cell and protect spreadsheet formula prefixes by default, which changes affected strings. Preserve original cells is for trusted machine processing. Import identifiers as text in spreadsheet applications to preserve leading zeros.",
  "content_format": "text/plain",
  "visibility": "public",
  "links": [
    {
      "name": "CSV anonymizer",
      "url": "https://happytails.ai/en/data-tools/csv-anonymizer/"
    },
    {
      "name": "CSV encoding repair",
      "url": "https://happytails.ai/en/data-tools/csv-encoding-repair/"
    }
  ],
  "tool": {
    "id": "csv-column-calculator",
    "category": "data-tools",
    "built": true,
    "requirements": "At most 20 expressions of 1,000 characters, 200 syntax nodes and 32 nested groups or signs each; 500,000 total row-node evaluations and 10,000 errors. Input decimals permit 100 significant digits and 30 fractional places; exact reduced numerators and denominators permit 256 digits. Output permits 100 significant digits. Up to 1,000,000 input characters, 10,000 records, 100 columns including additions and 100,000 cells. CSV output is capped at 4,000,000 characters.",
    "implementation": {
      "fields": [
        {
          "key": "delimiter",
          "label": "Input CSV separator",
          "value": ",",
          "type": "select",
          "values": [
            ",",
            ";",
            "\t"
          ]
        },
        {
          "key": "expressions",
          "label": "Derived column expressions",
          "value": "name,expression\ntotal,quantity * unit_price",
          "type": "textarea",
          "help": "CSV with headers name,expression. Up to 20 distinct new columns. Use + - * /, parentheses, decimals and exact column names. Use [unit price] for spaces, and ]] inside brackets for a literal ]. No functions, strings or references to other derived columns."
        },
        {
          "key": "decimalPlaces",
          "label": "Maximum output decimal places",
          "value": "12",
          "type": "select",
          "values": [
            "2",
            "6",
            "12",
            "16"
          ]
        },
        {
          "key": "exportMode",
          "label": "Spreadsheet formula handling",
          "value": "Protect formulas",
          "type": "select",
          "values": [
            "Protect formulas",
            "Preserve original cells"
          ]
        }
      ],
      "registrationFamily": "csv-preparation",
      "presentation": "metrics",
      "note": "Create new columns from your existing data. Calculations use exact arithmetic and round only the final value; errors are listed by record. Your original columns stay intact. Processed on your device. CSV downloads protect spreadsheet formula prefixes by default, which changes affected cells.",
      "experience": {
        "automatic": false,
        "single": false,
        "inputMaxLength": 1000000,
        "inputMode": "text",
        "label": "Source CSV",
        "placeholder": "CSV with a unique header",
        "help": "Use exact source headers in the expressions. Original cells and leading zeros remain strings. Up to 1,000,000 characters. Review the settings before running.",
        "action": null
      },
      "mode": "explicit",
      "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": "# CSV column calculator\n\n- Human page: https://happytails.ai/en/data-tools/csv-column-calculator/\n- Markdown: https://happytails.ai/en/data-tools/csv-column-calculator.md\n- Structured JSON: https://happytails.ai/agents/en/data-tools/csv-column-calculator/index.json\n- Visibility: public\n\n## Tool capabilities\n\n| Property | Value |\n| --- | --- |\n| Tool ID | `csv-column-calculator` |\n| Category | data-tools |\n| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |\n| Browser execution | Use the visible action or interactive controls. |\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\nCreate new columns from your existing data. Calculations use exact arithmetic and round only the final value; errors are listed by record. Your original columns stay intact. Processed on your device. CSV downloads protect spreadsheet formula prefixes by default, which changes affected cells.\n\n### Inputs and settings\n\nText input: Source CSV.\n\nExample or placeholder shown in the interface (not a validated fixture):\n\n```text\nCSV with a unique header\n```\n\nUse exact source headers in the expressions. Original cells and leading zeros remain strings. Up to 1,000,000 characters. Review the settings before running.\n\n| Setting | Meaning | Control type | Default | Constraints |\n| --- | --- | --- | --- | --- |\n| `delimiter` | Input CSV separator | select | \",\" | Allowed: ,, ;, \t |\n| `expressions` | Derived column expressions | textarea | \"name,expression\\ntotal,quantity * unit_price\" |  |\n| `decimalPlaces` | Maximum output decimal places | select | \"12\" | Allowed: 2, 6, 12, 16 |\n| `exportMode` | Spreadsheet formula handling | select | \"Protect formulas\" | Allowed: Protect formulas, Preserve original cells |\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\nAt most 20 expressions of 1,000 characters, 200 syntax nodes and 32 nested groups or signs each; 500,000 total row-node evaluations and 10,000 errors. Input decimals permit 100 significant digits and 30 fractional places; exact reduced numerators and denominators permit 256 digits. Output permits 100 significant digits. Up to 1,000,000 input characters, 10,000 records, 100 columns including additions and 100,000 cells. CSV output is capped at 4,000,000 characters.\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\": \"csv-column-calculator\",\n  \"category\": \"data-tools\",\n  \"built\": true,\n  \"requirements\": \"At most 20 expressions of 1,000 characters, 200 syntax nodes and 32 nested groups or signs each; 500,000 total row-node evaluations and 10,000 errors. Input decimals permit 100 significant digits and 30 fractional places; exact reduced numerators and denominators permit 256 digits. Output permits 100 significant digits. Up to 1,000,000 input characters, 10,000 records, 100 columns including additions and 100,000 cells. CSV output is capped at 4,000,000 characters.\",\n  \"implementation\": {\n    \"fields\": [\n      {\n        \"key\": \"delimiter\",\n        \"label\": \"Input CSV separator\",\n        \"value\": \",\",\n        \"type\": \"select\",\n        \"values\": [\n          \",\",\n          \";\",\n          \"\\t\"\n        ]\n      },\n      {\n        \"key\": \"expressions\",\n        \"label\": \"Derived column expressions\",\n        \"value\": \"name,expression\\ntotal,quantity * unit_price\",\n        \"type\": \"textarea\",\n        \"help\": \"CSV with headers name,expression. Up to 20 distinct new columns. Use + - * /, parentheses, decimals and exact column names. Use [unit price] for spaces, and ]] inside brackets for a literal ]. No functions, strings or references to other derived columns.\"\n      },\n      {\n        \"key\": \"decimalPlaces\",\n        \"label\": \"Maximum output decimal places\",\n        \"value\": \"12\",\n        \"type\": \"select\",\n        \"values\": [\n          \"2\",\n          \"6\",\n          \"12\",\n          \"16\"\n        ]\n      },\n      {\n        \"key\": \"exportMode\",\n        \"label\": \"Spreadsheet formula handling\",\n        \"value\": \"Protect formulas\",\n        \"type\": \"select\",\n        \"values\": [\n          \"Protect formulas\",\n          \"Preserve original cells\"\n        ]\n      }\n    ],\n    \"registrationFamily\": \"csv-preparation\",\n    \"presentation\": \"metrics\",\n    \"note\": \"Create new columns from your existing data. Calculations use exact arithmetic and round only the final value; errors are listed by record. Your original columns stay intact. Processed on your device. CSV downloads protect spreadsheet formula prefixes by default, which changes affected cells.\",\n    \"experience\": {\n      \"automatic\": false,\n      \"single\": false,\n      \"inputMaxLength\": 1000000,\n      \"inputMode\": \"text\",\n      \"label\": \"Source CSV\",\n      \"placeholder\": \"CSV with a unique header\",\n      \"help\": \"Use exact source headers in the expressions. Original cells and leading zeros remain strings. Up to 1,000,000 characters. Review the settings before running.\",\n      \"action\": null\n    },\n    \"mode\": \"explicit\",\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 new CSV columns from existing values, then review results and errors before downloading.\n\n### How to use CSV column calculator\n\n1. Paste CSV with a unique header and unchanged source values.\n2. Add a name,expression CSV of distinct derived columns and choose output decimal precision.\n3. Review derived values and the located errors CSV, then download the complete CSV and JSON report.\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## Useful next steps\n\n- [CSV anonymizer](https://happytails.ai/en/data-tools/csv-anonymizer/) ([Markdown](https://happytails.ai/en/data-tools/csv-anonymizer.md))\n\n- [CSV encoding repair](https://happytails.ai/en/data-tools/csv-encoding-repair/) ([Markdown](https://happytails.ai/en/data-tools/csv-encoding-repair.md))\n\n## Exact calculations with explicit rounding\n\nUse decimals, exact source column names, + - \\* / and parentheses. Bracket headers containing spaces, for example \\[unit price\\]. Exact rational intermediates round only when each final result is written, using nearest with ties to even. Choose 2, 6, 12 or 16 decimal places. Trailing fractional zeros are omitted.\n\n### Visible errors without code execution\n\nExpressions cannot run JavaScript, call functions, access properties or reference other derived columns. Invalid expressions, missing columns, nonnumeric cells, division by zero and arithmetic bounds leave affected derived cells empty and appear by one-based source record in the errors CSV.\n\n### Local processing and exact strings\n\nProcessing runs on your device. CSV downloads quote every cell and protect spreadsheet formula prefixes by default, which changes affected strings. Preserve original cells is for trusted machine processing. Import identifiers as text in spreadsheet applications to preserve leading zeros.\n"
}