@utilix-tech/mcp 0.50.0 → 0.52.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.52.0
+- Add `calculate_gpa` tool: compute a weighted GPA from a list of courses, each with a letter grade and credit hours, using the standard 4.0-capped scale.
+
+## 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.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 189 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 192 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 (30 tools)
+### Units (32 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -193,6 +193,8 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `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 |
+| `calculate_gpa` | Compute a weighted GPA from a list of courses, each with a letter grade and credit hours, using the standard 4.0-capped scale |
 
 ### API / Network (28 tools)
 | Tool | Description |
@@ -250,7 +252,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 |
@@ -264,6 +266,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

@@ -8340,5 +8340,171 @@ server.tool(
     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 GPA_GRADE_POINTS_MCP = {
+  "A+": 4,
+  A: 4,
+  "A-": 3.7,
+  "B+": 3.3,
+  B: 3,
+  "B-": 2.7,
+  "C+": 2.3,
+  C: 2,
+  "C-": 1.7,
+  "D+": 1.3,
+  D: 1,
+  "D-": 0.7,
+  F: 0
+};
+function _calculateGpaMcp(courses) {
+  if (!Array.isArray(courses) || courses.length === 0) {
+    return { error: "courses must be a non-empty array" };
+  }
+  const round2 = (n) => Math.round(n * 100) / 100;
+  let totalCredits = 0;
+  let totalQualityPoints = 0;
+  const results = [];
+  for (let i = 0; i < courses.length; i++) {
+    const course = courses[i];
+    if (typeof course.credits !== "number" || !Number.isFinite(course.credits) || course.credits <= 0) {
+      return { error: `course ${i + 1}: credits must be a finite number greater than zero` };
+    }
+    const gradeKey = typeof course.grade === "string" ? course.grade.trim().toUpperCase() : "";
+    const points = GPA_GRADE_POINTS_MCP[gradeKey];
+    if (points === void 0) {
+      return { error: `course ${i + 1}: unrecognized grade "${course.grade}" (expected one of ${Object.keys(GPA_GRADE_POINTS_MCP).join(", ")})` };
+    }
+    const qualityPoints = round2(points * course.credits);
+    totalCredits += course.credits;
+    totalQualityPoints += qualityPoints;
+    results.push({
+      name: course.name?.trim() || `Course ${i + 1}`,
+      grade: gradeKey,
+      credits: course.credits,
+      qualityPoints
+    });
+  }
+  return {
+    courses: results,
+    totalCredits: round2(totalCredits),
+    totalQualityPoints: round2(totalQualityPoints),
+    gpa: round2(totalQualityPoints / totalCredits)
+  };
+}
+server.tool(
+  "calculate_gpa",
+  "Compute a weighted GPA from a list of courses, each with a letter grade and credit hours, using the standard 4.0-capped scale (A+ counts the same as A).",
+  {
+    courses: z.array(z.object({
+      name: z.string().optional().describe("Optional course name/label"),
+      grade: z.string().describe('Letter grade, e.g. "A", "B+", "C-"'),
+      credits: z.number().positive().describe("Credit hours for this course, must be greater than zero")
+    })).min(1).describe("A non-empty list of courses to average")
+  },
+  async ({ courses }) => {
+    const result = _calculateGpaMcp(courses);
+    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.50.0",
+  "version": "0.52.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",