@utilix-tech/mcp 0.49.0 → 0.51.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.51.0
+- Add `calculate_moving_averages` tool: compute SMA and EMA series from a list of numbers and a window size.
+- Add `calculate_markdown_task_list_progress` tool: parse a Markdown document's checkbox task list and report completion percentage overall and per section.
+
+## 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 191 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 (31 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -192,6 +192,8 @@ 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 |
+| `calculate_moving_averages` | Compute simple moving average (SMA) and exponential moving average (EMA) series from a list of numbers and a window size |
 
 ### API / Network (28 tools)
 | Tool | Description |
@@ -249,7 +251,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `lint_conventional_commit` | Lint a commit message against the Conventional Commits v1.0.0 spec: header format, blank-line separation, footer tokens, and BREAKING CHANGE casing |
 | `test_gitignore_patterns` | Test a list of paths against a .gitignore file's patterns, following git's last-match-wins and negation rules |
 
-### Data (11 tools)
+### Data (12 tools)
 | Tool | Description |
 |------|-------------|
 | `validate_yaml` | Validate YAML syntax |
@@ -263,6 +265,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `generate_markdown_toc` | Scan a Markdown document's ATX headings and build a nested table of contents with GitHub-style anchor slugs |
 | `csv_to_sql_insert` | Convert CSV data with a header row into parameterless SQL INSERT statements, with basic type inference and ANSI/MySQL identifier quoting |
 | `find_csv_duplicate_rows` | Group CSV/TSV rows that share the same value across a chosen set of key columns, or the entire row |
+| `calculate_markdown_task_list_progress` | Parse a Markdown document's checkbox task list and report completion percentage overall and per section, grouped by the nearest preceding heading |
 
 ### CSS (2 tools)
 | Tool | Description |

package/dist/index.js

@@ -8304,5 +8304,141 @@ 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));
+  }
+);
+function _calculateMovingAveragesMcp(values, windowSize) {
+  if (!Array.isArray(values) || values.length === 0 || !values.every((v) => typeof v === "number" && Number.isFinite(v))) {
+    return { error: "values must be a non-empty array of finite numbers" };
+  }
+  if (!Number.isInteger(windowSize) || windowSize < 1) {
+    return { error: "windowSize must be a positive integer" };
+  }
+  if (windowSize > values.length) {
+    return { error: "windowSize must be less than or equal to the number of values" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const multiplier = 2 / (windowSize + 1);
+  const points = [];
+  let emaPrev = null;
+  for (let i = 0; i < values.length; i++) {
+    let sma = null;
+    if (i >= windowSize - 1) {
+      let sum = 0;
+      for (let j = i - windowSize + 1; j <= i; j++) sum += values[j];
+      sma = round4(sum / windowSize);
+    }
+    let ema = null;
+    if (i === windowSize - 1) {
+      ema = sma;
+      emaPrev = ema;
+    } else if (i > windowSize - 1 && emaPrev !== null) {
+      ema = round4(values[i] * multiplier + emaPrev * (1 - multiplier));
+      emaPrev = ema;
+    }
+    points.push({ index: i, value: values[i], sma, ema });
+  }
+  const last = points[points.length - 1];
+  return { windowSize, multiplier: round4(multiplier), points, latestSma: last.sma, latestEma: last.ema };
+}
+server.tool(
+  "calculate_moving_averages",
+  "Compute simple moving average (SMA) and exponential moving average (EMA) series from a list of numbers and a window size, a foundational technical-indicator building block for price/volume data. No live market-data feed is involved: this operates only on numbers you supply.",
+  {
+    values: z.array(z.number()).min(1).describe("A non-empty series of finite numbers, e.g. daily closing prices"),
+    windowSize: z.number().int().min(1).describe("The trailing window size for both SMA and EMA, must not exceed values.length")
+  },
+  async ({ values, windowSize }) => {
+    const result = _calculateMovingAveragesMcp(values, windowSize);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+function _calculateMarkdownTaskListProgressMcp(markdown) {
+  const round2 = (n) => Math.round(n * 100) / 100;
+  const headingRe = /^(#{1,6})\s+(.*)$/;
+  const itemRe = /^(\s*)[-*+]\s+\[([ xX])\]\s+(.*)$/;
+  let currentSection = "(no heading)";
+  const items = [];
+  for (const line of markdown.replace(/\r\n/g, "\n").split("\n")) {
+    const headingMatch = line.match(headingRe);
+    if (headingMatch) {
+      currentSection = headingMatch[2].trim();
+      continue;
+    }
+    const itemMatch = line.match(itemRe);
+    if (itemMatch) {
+      items.push({
+        text: itemMatch[3].trim(),
+        checked: itemMatch[2].toLowerCase() === "x",
+        indent: itemMatch[1].length,
+        section: currentSection
+      });
+    }
+  }
+  const totalItems = items.length;
+  const completedItems = items.filter((i) => i.checked).length;
+  const percentComplete = totalItems === 0 ? 0 : round2(completedItems / totalItems * 100);
+  const sectionOrder = [];
+  const sectionTotals = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    if (!sectionTotals.has(item.section)) {
+      sectionTotals.set(item.section, { total: 0, completed: 0 });
+      sectionOrder.push(item.section);
+    }
+    const s = sectionTotals.get(item.section);
+    s.total++;
+    if (item.checked) s.completed++;
+  }
+  const sections = sectionOrder.map((section) => {
+    const s = sectionTotals.get(section);
+    return { section, total: s.total, completed: s.completed, percentComplete: s.total === 0 ? 0 : round2(s.completed / s.total * 100) };
+  });
+  return { totalItems, completedItems, percentComplete, sections, items };
+}
+server.tool(
+  "calculate_markdown_task_list_progress",
+  "Parse a Markdown document's `- [ ]`/`- [x]` task list checkboxes and report completion percentage overall and per section, where a section is the nearest preceding ATX heading of any level.",
+  {
+    markdown: z.string().describe("The Markdown document to scan for task list checkboxes")
+  },
+  async ({ markdown }) => {
+    const result = _calculateMarkdownTaskListProgressMcp(markdown);
+    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.51.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",