@utilix-tech/mcp 0.49.0 → 0.50.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.50.0
+- Add `calculate_cash_rounding` tool: round a cashless total to the nearest payable cash denomination ("Swedish rounding"), with round-nearest, round-up, and round-down modes.
+
 ## 0.49.0
 - Add `resolve_yaml_anchors` tool: expand YAML anchors, aliases, and merge keys inline, and list which anchors were referenced vs. left unused.
 - Add `split_sitemap` tool: split a URL list exceeding the sitemaps.org 50,000-URL cap into multiple sitemap.xml files plus a sitemap index file.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 188 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 189 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
 
 No API key required. All tools run locally. Requires Node.js 18 or later.
 
@@ -160,7 +160,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `convert_timezone` | Convert a date/time between timezones |
 | `convert_iso8601_duration` | Parse an ISO 8601 duration into components and total seconds, or format seconds into a duration string |
 
-### Units (29 tools)
+### Units (30 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -192,6 +192,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `calculate_payback_period` | Compute the simple and discounted payback period from an initial investment and a series of periodic cash flows |
 | `calculate_cd_maturity` | Compute a certificate of deposit's maturity value and effective annual yield (APY) from a principal, nominal rate, term, and compounding frequency, plus the net early-withdrawal payout |
 | `calculate_depreciation_schedule` | Build a year-by-year fixed-asset depreciation schedule from cost, salvage value, and useful life, using straight-line, double-declining-balance, or sum-of-years-digits |
+| `calculate_cash_rounding` | Round a cashless total to the nearest payable cash denomination ("Swedish rounding"), with round-nearest, round-up, and round-down modes |
 
 ### API / Network (28 tools)
 | Tool | Description |

package/dist/index.js

@@ -8304,5 +8304,41 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _calculateCashRoundingMcp(total, roundingUnit, mode = "nearest") {
+  const round2 = (n) => Math.round(n * 100) / 100;
+  if (typeof total !== "number" || !Number.isFinite(total)) {
+    return { error: "total must be a finite number" };
+  }
+  if (typeof roundingUnit !== "number" || !Number.isFinite(roundingUnit) || roundingUnit <= 0) {
+    return { error: "roundingUnit must be a finite number greater than zero" };
+  }
+  if (mode !== "nearest" && mode !== "up" && mode !== "down") {
+    return { error: 'mode must be one of: "nearest", "up", "down"' };
+  }
+  const steps = total / roundingUnit;
+  const roundedSteps = mode === "up" ? Math.ceil(steps) : mode === "down" ? Math.floor(steps) : Math.round(steps);
+  const roundedTotal = round2(roundedSteps * roundingUnit);
+  return {
+    total: round2(total),
+    roundingUnit,
+    mode,
+    roundedTotal,
+    adjustment: round2(roundedTotal - total)
+  };
+}
+server.tool(
+  "calculate_cash_rounding",
+  'Round a cashless total to the nearest payable cash denomination, the way a till rounds a card-priced total to the nearest 5 cents (or whatever the smallest circulating coin is) when settling in physical cash, commonly called "Swedish rounding" or "cash rounding".',
+  {
+    total: z.number().describe("The cashless total to round"),
+    roundingUnit: z.number().describe("The smallest payable cash denomination to round to, e.g. 0.05"),
+    mode: z.enum(["nearest", "up", "down"]).optional().describe('Rounding mode (default "nearest")')
+  },
+  async ({ total, roundingUnit, mode }) => {
+    const result = _calculateCashRoundingMcp(total, roundingUnit, mode);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "MCP server exposing 188 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",