@utilix-tech/mcp 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.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.)
+
 ## 0.11.0
 - Added robots.txt Validator (`validate_robots_txt`) and Credit Card Number Validator (`validate_card_number`).
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 109 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 113 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,12 +145,15 @@ 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 (3 tools)
+### Units (6 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
 | `px_to_units` | Convert pixels to rem, em, pt, and vw |
 | `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 |
 
 ### API / Network (8 tools)
 | Tool | Description |
@@ -235,11 +238,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

@@ -1742,6 +1742,224 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _IBAN_COUNTRY_LENGTHS = {
+  AD: 24,
+  AE: 23,
+  AL: 28,
+  AT: 20,
+  AZ: 28,
+  BA: 20,
+  BE: 16,
+  BG: 22,
+  BH: 22,
+  BR: 29,
+  BY: 28,
+  CH: 21,
+  CR: 22,
+  CY: 28,
+  CZ: 24,
+  DE: 22,
+  DK: 18,
+  DO: 28,
+  EE: 20,
+  EG: 29,
+  ES: 24,
+  FI: 18,
+  FO: 18,
+  FR: 27,
+  GB: 22,
+  GE: 22,
+  GI: 23,
+  GL: 18,
+  GR: 27,
+  GT: 28,
+  HR: 21,
+  HU: 28,
+  IE: 22,
+  IL: 23,
+  IQ: 23,
+  IS: 26,
+  IT: 27,
+  JO: 30,
+  KW: 30,
+  KZ: 20,
+  LB: 28,
+  LC: 32,
+  LI: 21,
+  LT: 20,
+  LU: 20,
+  LV: 21,
+  LY: 25,
+  MC: 27,
+  MD: 24,
+  ME: 22,
+  MK: 19,
+  MR: 27,
+  MT: 31,
+  MU: 30,
+  NL: 18,
+  NO: 15,
+  PK: 24,
+  PL: 28,
+  PS: 29,
+  PT: 25,
+  QA: 29,
+  RO: 24,
+  RS: 22,
+  SA: 24,
+  SC: 31,
+  SE: 24,
+  SI: 19,
+  SK: 24,
+  SM: 27,
+  ST: 25,
+  SV: 28,
+  TL: 23,
+  TN: 24,
+  TR: 26,
+  UA: 29,
+  VA: 22,
+  VG: 24,
+  XK: 20
+};
+function _ibanMod97(numeric) {
+  let remainder = 0;
+  for (let i = 0; i < numeric.length; i += 7) {
+    remainder = parseInt(String(remainder) + numeric.substr(i, 7), 10) % 97;
+  }
+  return remainder;
+}
+function _formatIban(cleaned) {
+  return cleaned.match(/.{1,4}/g)?.join(" ") ?? cleaned;
+}
+function _validateIban(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const cleaned = input.replace(/\s/g, "").toUpperCase();
+  if (!/^[A-Z0-9]+$/.test(cleaned)) return { error: "IBAN must contain only letters and digits" };
+  if (cleaned.length < 4 || cleaned.length > 34) {
+    return { error: `IBAN length (${cleaned.length}) is outside the valid range of 4-34 characters` };
+  }
+  if (!/^[A-Z]{2}\d{2}/.test(cleaned)) {
+    return { error: "IBAN must start with a 2-letter country code followed by 2 check digits" };
+  }
+  const countryCode = cleaned.slice(0, 2);
+  const checkDigits = cleaned.slice(2, 4);
+  const bban = cleaned.slice(4);
+  const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+  const numeric = rearranged.split("").map((ch) => /[A-Z]/.test(ch) ? String(ch.charCodeAt(0) - 55) : ch).join("");
+  const checksumValid = _ibanMod97(numeric) === 1;
+  const expectedLength = _IBAN_COUNTRY_LENGTHS[countryCode] ?? null;
+  const lengthValid = expectedLength === null ? null : cleaned.length === expectedLength;
+  const valid = checksumValid && lengthValid !== false;
+  return {
+    valid,
+    formatted: _formatIban(cleaned),
+    countryCode,
+    checkDigits,
+    bban,
+    length: cleaned.length,
+    expectedLength,
+    checksumValid,
+    lengthValid
+  };
+}
+server.tool(
+  "validate_iban",
+  "Validate an IBAN via the mod-97 checksum defined by ISO 13616 and format it into the standard human-readable grouped form. Cross-checks the total length against the country's registered fixed length where known.",
+  { iban: z.string().describe("The IBAN, with or without spaces") },
+  async ({ iban }) => {
+    const result = _validateIban(iban);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+function _roundMoneyMcp(n) {
+  return Math.round(n * 100) / 100;
+}
+function _calculateLoan(principal, annualRatePercent, termMonths) {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isInteger(termMonths) || termMonths <= 0) {
+    return { error: "Term must be a positive whole number of months" };
+  }
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let monthlyPayment;
+  if (monthlyRate === 0) {
+    monthlyPayment = principal / termMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, termMonths);
+    monthlyPayment = principal * monthlyRate * factor / (factor - 1);
+  }
+  const schedule = [];
+  let balance = _roundMoneyMcp(principal);
+  let totalPayment = 0;
+  for (let month = 1; month <= termMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : _roundMoneyMcp(balance * monthlyRate);
+    let principalPortion = _roundMoneyMcp(monthlyPayment) - interest;
+    if (month === termMonths || principalPortion > balance) principalPortion = balance;
+    const payment = _roundMoneyMcp(principalPortion + interest);
+    balance = _roundMoneyMcp(balance - principalPortion);
+    totalPayment += payment;
+    schedule.push({ month, payment, principal: _roundMoneyMcp(principalPortion), interest, balance: Math.max(balance, 0) });
+  }
+  return {
+    monthlyPayment: _roundMoneyMcp(monthlyPayment),
+    totalPayment: _roundMoneyMcp(totalPayment),
+    totalInterest: _roundMoneyMcp(totalPayment - principal),
+    termMonths,
+    schedule
+  };
+}
+server.tool(
+  "calculate_loan",
+  "Compute the fixed monthly payment, total interest, and full month-by-month amortization schedule for a loan or mortgage from principal, annual interest rate (as a percent), and term in months.",
+  {
+    principal: z.number().describe("Loan principal amount"),
+    annualRatePercent: z.number().describe("Annual interest rate as a percent, e.g. 6.5"),
+    termMonths: z.number().int().describe("Loan term in months")
+  },
+  async ({ principal, annualRatePercent, termMonths }) => {
+    const result = _calculateLoan(principal, annualRatePercent, termMonths);
+    if ("error" in result) return errText(result);
+    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));
+  }
+);
 server.tool(
   "format_ndjson",
   "Validate newline-delimited JSON (NDJSON/JSON Lines), report per-line errors, and pretty-print each valid line.",
@@ -2485,6 +2703,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.11.0",
-  "description": "MCP server exposing 107 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
+  "version": "0.13.0",
+  "description": "MCP server exposing 113 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",