@utilix-tech/mcp 0.51.0 → 0.52.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.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.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 191 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 (31 tools)
+### Units (32 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -194,6 +194,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `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 |

package/dist/index.js

@@ -8440,5 +8440,71 @@ server.tool(
     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.51.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",