@utilix-tech/mcp 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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.14.0
+- Added VAT / Sales Tax Calculator (`calculate_tax`).
+
+## 0.13.0
+- Added ICO Favicon Inspector (`read_ico_info`) and Barcode Checksum Validator (`validate_barcode`).
+
 ## 0.12.0
 - Added IBAN Validator / Formatter (`validate_iban`) and Loan / Mortgage Calculator (`calculate_loan`).
 - (npm publish for this version was retried after fixing a CI pin: `npm install -g npm@latest` started pulling npm 12, which requires Node >=22 and broke on this job's pinned Node 20 — now pinned to the npm 11 line.)

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 111 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 114 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.
 
@@ -145,7 +145,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `date_diff` | Calculate the difference between two dates |
 | `convert_timezone` | Convert a date/time between timezones |
 
-### Units (5 tools)
+### Units (7 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -153,6 +153,8 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `validate_card_number` | Validate a credit card number via the Luhn checksum and detect its network |
 | `validate_iban` | Validate an IBAN via the mod-97 checksum and format it into grouped blocks |
 | `calculate_loan` | Compute a loan's monthly payment, total interest, and amortization schedule |
+| `validate_barcode` | Validate an EAN-13, EAN-8, or UPC-A barcode via its weighted mod-10 check digit |
+| `calculate_tax` | Add or remove VAT/sales tax from a price, in either direction |
 
 ### API / Network (8 tools)
 | Tool | Description |
@@ -237,11 +239,12 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `compress_json` | Compress JSON for LLM context budgets |
 | `diff_json_detailed` | Diff two parsed JSON values, returning every path with its op and unchanged paths |
 
-### Image (2 tools)
+### Image (3 tools)
 | Tool | Description |
 |------|-------------|
 | `read_image_info` | Read format, dimensions, bit depth, and alpha channel from image bytes: no decoding required. Supports PNG, JPEG, GIF, WebP, BMP |
 | `read_exif_data` | Read camera make/model, orientation, timestamps, exposure settings, and GPS coordinates from a JPEG's EXIF data |
+| `read_ico_info` | Read how many images a .ico file embeds and each one's width, height, color depth, and size from its ICONDIR header |
 
 ### PDF (1 tool)
 | Tool | Description |

package/dist/index.js

@@ -1926,6 +1926,68 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _BARCODE_FORMAT_BY_LENGTH = { 8: "EAN-8", 12: "UPC-A", 13: "EAN-13" };
+function _computeBarcodeCheckDigit(dataDigits) {
+  let sum = 0;
+  const n = dataDigits.length;
+  for (let i = 0; i < n; i++) {
+    const distanceFromEnd = n - 1 - i;
+    const weight = distanceFromEnd % 2 === 0 ? 3 : 1;
+    sum += dataDigits[i] * weight;
+  }
+  return (10 - sum % 10) % 10;
+}
+function _validateBarcode(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const digits = input.replace(/[\s-]/g, "");
+  if (!/^\d+$/.test(digits)) return { error: "Barcode must contain only digits (spaces and hyphens are ignored)" };
+  const format = _BARCODE_FORMAT_BY_LENGTH[digits.length];
+  if (!format) {
+    return { error: `Unsupported barcode length (${digits.length} digits); expected 8 (EAN-8), 12 (UPC-A), or 13 (EAN-13)` };
+  }
+  const dataDigits = digits.slice(0, -1).split("").map(Number);
+  const checkDigit = Number(digits[digits.length - 1]);
+  const expectedCheckDigit = _computeBarcodeCheckDigit(dataDigits);
+  return { valid: checkDigit === expectedCheckDigit, format, digits, checkDigit, expectedCheckDigit };
+}
+server.tool(
+  "validate_barcode",
+  "Validate an EAN-13, EAN-8, or UPC-A barcode number via its weighted mod-10 check digit algorithm. The format is inferred from the digit length (8, 12, or 13).",
+  { barcode: z.string().describe("The barcode digits, with optional spaces or hyphens") },
+  async ({ barcode }) => {
+    const result = _validateBarcode(barcode);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+function _calculateTax(amount, ratePercent, direction) {
+  if (!Number.isFinite(amount) || amount < 0) return { error: "Amount must be zero or a positive number" };
+  if (!Number.isFinite(ratePercent) || ratePercent < 0) return { error: "Tax rate must be zero or a positive number" };
+  if (direction !== "add" && direction !== "remove") return { error: 'Direction must be "add" or "remove"' };
+  if (direction === "add") {
+    const netAmount2 = _roundMoneyMcp(amount);
+    const taxAmount2 = _roundMoneyMcp(amount * (ratePercent / 100));
+    return { netAmount: netAmount2, taxAmount: taxAmount2, grossAmount: _roundMoneyMcp(netAmount2 + taxAmount2), ratePercent, direction };
+  }
+  const grossAmount = _roundMoneyMcp(amount);
+  const netAmount = _roundMoneyMcp(amount / (1 + ratePercent / 100));
+  const taxAmount = _roundMoneyMcp(grossAmount - netAmount);
+  return { netAmount, taxAmount, grossAmount, ratePercent, direction };
+}
+server.tool(
+  "calculate_tax",
+  "Add tax to a net (pre-tax) amount or remove tax from a gross (tax-inclusive) amount, given a rate. Pure formula, not a live VAT/sales-tax rate lookup.",
+  {
+    amount: z.number().describe("The amount to add tax to (net) or remove tax from (gross)"),
+    ratePercent: z.number().describe("Tax rate as a percent, e.g. 20"),
+    direction: z.enum(["add", "remove"]).describe('"add" treats amount as net and computes gross; "remove" treats amount as gross and backs out net')
+  },
+  async ({ amount, ratePercent, direction }) => {
+    const result = _calculateTax(amount, ratePercent, direction);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 server.tool(
   "format_ndjson",
   "Validate newline-delimited JSON (NDJSON/JSON Lines), report per-line errors, and pretty-print each valid line.",
@@ -2669,6 +2731,45 @@ server.tool("read_id3_tags", "Read ID3 tags (title, artist, album, year, genre,
   if ("error" in result) return errText(result);
   return text(JSON.stringify(result, null, 2));
 });
+function _readU16LE(bytes, offset) {
+  return bytes[offset] | bytes[offset + 1] << 8;
+}
+function _readU32LE(bytes, offset) {
+  return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] << 24) >>> 0;
+}
+function _readIcoInfo(bytes) {
+  if (bytes.length < 6) return { error: "File too small to be a valid ICO file" };
+  if (_readU16LE(bytes, 0) !== 0) return { error: "Not a valid ICO file (reserved header field must be 0)" };
+  const type = _readU16LE(bytes, 2);
+  if (type === 2) return { error: "This is a .cur cursor file (type 2), not a .ico icon file" };
+  if (type !== 1) return { error: `Unrecognized ICONDIR type (${type}); expected 1 for an icon file` };
+  const count = _readU16LE(bytes, 4);
+  if (count === 0) return { error: "ICO file declares zero embedded images" };
+  const images = [];
+  for (let i = 0; i < count; i++) {
+    const offset = 6 + i * 16;
+    if (offset + 16 > bytes.length) return { error: `Truncated ICONDIRENTRY for image ${i}` };
+    const widthRaw = bytes[offset];
+    const heightRaw = bytes[offset + 1];
+    const colorCountRaw = bytes[offset + 2];
+    images.push({
+      width: widthRaw === 0 ? 256 : widthRaw,
+      height: heightRaw === 0 ? 256 : heightRaw,
+      colorCount: colorCountRaw === 0 ? null : colorCountRaw,
+      planes: _readU16LE(bytes, offset + 4),
+      bitCount: _readU16LE(bytes, offset + 6),
+      bytesInRes: _readU32LE(bytes, offset + 8),
+      imageOffset: _readU32LE(bytes, offset + 12)
+    });
+  }
+  return { imageCount: count, images };
+}
+server.tool("read_ico_info", "Read a .ico file's ICONDIR/ICONDIRENTRY header table directly from its bytes to report how many images it embeds and each one's width, height, color depth, and size. No image decoding required.", { ico_base64: z.string().describe("Base64-encoded ICO file bytes, optionally prefixed with a data: URL scheme") }, async ({ ico_base64 }) => {
+  const bytes = new Uint8Array(Buffer.from(ico_base64.replace(/^data:.*;base64,/, ""), "base64"));
+  const result = _readIcoInfo(bytes);
+  if ("error" in result) return errText(result);
+  return text(JSON.stringify(result, null, 2));
+});
 function _parseEnvForDiff(input) {
   const entries = [];
   const errors = [];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.12.0",
-  "description": "MCP server exposing 111 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
+  "version": "0.14.0",
+  "description": "MCP server exposing 114 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",
   "homepage": "https://utilix.tech/mcp",