@utilix-tech/mcp 0.55.0 → 0.56.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.56.0
+- Add `calculate_debt_to_income_ratio` tool: compute the debt-to-income ratio (total monthly debt payments / gross monthly income) from one or more monthly debts, plus a qualitative tier matching common mortgage-lending guidance.
+- Add `infer_csv_column_types` tool: parse CSV/TSV data and infer each column's data type (integer, float, boolean, ISO 8601 date, or string), flagging nullable columns and empty-cell counts.
+
 ## 0.55.0
 - Add `validate_package_exports` tool: parse a package.json's exports field and flag common dual-package (ESM/CJS) misconfigurations, a types condition not listed first, a missing default fallback, mismatched require/import extensions, mixed subpath/condition keys, and pattern mismatches.
 - Add `build_x_content_type_options_header` tool: build the fixed X-Content-Type-Options: nosniff header, validate a pasted value, and assess MIME-sniffing risk for a given Content-Type.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 198 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 200 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 (33 tools)
+### Units (34 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
@@ -196,6 +196,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `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 |
 | `calculate_credit_utilization` | Compute per-account and overall credit utilization (balance / limit) from one or more credit accounts, plus a qualitative tier matching common credit-scoring guidance |
+| `calculate_debt_to_income_ratio` | Compute the debt-to-income ratio (total monthly debt payments / gross monthly income) from one or more monthly debts, plus a qualitative tier matching common mortgage-lending guidance |
 
 ### API / Network (29 tools)
 | Tool | Description |
@@ -257,7 +258,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `validate_tsconfig` | Validate a tsconfig.json file (JSONC-aware): unknown keys, unknown compilerOptions, and type mismatches |
 | `validate_package_exports` | Validate a package.json "exports" field: dual-package (ESM/CJS) misconfigurations like a missing default fallback or a require/import pointing at the wrong extension |
 
-### Data (13 tools)
+### Data (14 tools)
 | Tool | Description |
 |------|-------------|
 | `validate_yaml` | Validate YAML syntax |
@@ -273,6 +274,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `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 |
 | `analyze_caption_speed` | Parse an SRT or WebVTT file and report the words-per-minute reading speed of every cue, flagging ones that exceed common broadcast accessibility guidelines |
+| `infer_csv_column_types` | Parse CSV/TSV data and infer each column's data type (integer, float, boolean, ISO 8601 date, or string), flagging nullable columns and empty-cell counts |
 
 ### CSS (2 tools)
 | Tool | Description |

package/dist/index.js

@@ -7271,6 +7271,71 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _CSV_TYPE_ISO_DATE_RE_MCP = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+function _classifyCsvValueMcp(raw) {
+  const v = raw.trim();
+  if (v === "") return "empty";
+  if (/^(true|false)$/i.test(v)) return "boolean";
+  if (/^-?\d+$/.test(v)) return "integer";
+  if (/^-?\d+\.\d+$/.test(v)) return "float";
+  if (_CSV_TYPE_ISO_DATE_RE_MCP.test(v)) return "date";
+  return "string";
+}
+function _inferCsvColumnTypesMcp(input, delimiter, hasHeader) {
+  if (!input || input.trim() === "") return { error: "Input is empty" };
+  const delim = delimiter || ",";
+  const header = hasHeader !== false;
+  const lines = input.replace(/\r\n/g, "\n").split("\n").filter((l) => l.trim() !== "");
+  if (lines.length === 0) return { error: "No data found" };
+  const allRows = lines.map((l) => _parseCsvRowForSqlMcp(l, delim));
+  const headers = header ? allRows[0].map((h) => h.trim()) : allRows[0].map((_, idx) => `Column ${idx + 1}`);
+  const rows = header ? allRows.slice(1) : allRows;
+  const columns = headers.map((name, colIdx) => {
+    const seen = /* @__PURE__ */ new Set();
+    let sawString = false;
+    let nullCount = 0;
+    const sampleValues = [];
+    for (const row of rows) {
+      const raw = row[colIdx] ?? "";
+      const kind = _classifyCsvValueMcp(raw);
+      if (kind === "empty") {
+        nullCount++;
+        continue;
+      }
+      if (sampleValues.length < 3) sampleValues.push(raw);
+      if (kind === "string") sawString = true;
+      else seen.add(kind);
+    }
+    let inferredType;
+    if (sawString || seen.size === 0) inferredType = "string";
+    else if (seen.size === 1) inferredType = [...seen][0];
+    else if (seen.has("integer") && seen.has("float") && seen.size === 2) inferredType = "float";
+    else inferredType = "string";
+    return {
+      name,
+      inferredType,
+      nullable: nullCount > 0,
+      nullCount,
+      totalCount: rows.length,
+      sampleValues
+    };
+  });
+  return { columns, rowCount: rows.length };
+}
+server.tool(
+  "infer_csv_column_types",
+  "Parse CSV/TSV data and infer each column's data type (integer, float, boolean, ISO 8601 date, or string) by classifying every non-empty value and finding the tightest type that fits them all: all-integer values infer as integer, a mix of integers and decimals infers as float, and anything that doesn't fit a narrower type falls back to string. Empty cells mark a column nullable but don't affect its inferred type.",
+  {
+    csv: z.string().min(1).describe("CSV/TSV data to infer column types from"),
+    delimiter: z.string().optional().describe('Field delimiter (default ",")'),
+    hasHeader: z.boolean().default(true).describe("Whether the first row is a header")
+  },
+  async ({ csv, delimiter, hasHeader }) => {
+    const result = _inferCsvColumnTypesMcp(csv, delimiter, hasHeader);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var _VARY_HEADER_NOTES_MCP = {
   "accept-encoding": "Caches must store a separate response per compression scheme (gzip, br, etc.) the client accepts.",
   "accept-language": "Caches must store a separate response per requested language, which can fragment a shared cache badly if Accept-Language values are highly varied.",
@@ -8922,6 +8987,59 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _classifyDtiMcp(percent) {
+  if (percent < 36) return "healthy";
+  if (percent < 43) return "moderate";
+  if (percent < 50) return "high";
+  return "severe";
+}
+function _calculateDebtToIncomeRatioMcp(debts, grossMonthlyIncome) {
+  if (!Array.isArray(debts) || debts.length === 0) {
+    return { error: "debts must be a non-empty array" };
+  }
+  if (typeof grossMonthlyIncome !== "number" || !Number.isFinite(grossMonthlyIncome) || grossMonthlyIncome <= 0) {
+    return { error: "grossMonthlyIncome must be a finite number greater than zero" };
+  }
+  const round2 = (n) => Math.round(n * 100) / 100;
+  let totalMonthlyDebt = 0;
+  const results = [];
+  for (let i = 0; i < debts.length; i++) {
+    const debt = debts[i];
+    if (typeof debt.amount !== "number" || !Number.isFinite(debt.amount) || debt.amount < 0) {
+      return { error: `debt ${i + 1}: amount must be a finite, non-negative number` };
+    }
+    totalMonthlyDebt += debt.amount;
+    results.push({
+      label: debt.label?.trim() || `Debt ${i + 1}`,
+      amount: debt.amount,
+      percentOfIncome: round2(debt.amount / grossMonthlyIncome * 100)
+    });
+  }
+  const dtiPercent = round2(totalMonthlyDebt / grossMonthlyIncome * 100);
+  return {
+    debts: results,
+    totalMonthlyDebt: round2(totalMonthlyDebt),
+    grossMonthlyIncome,
+    dtiPercent,
+    tier: _classifyDtiMcp(dtiPercent)
+  };
+}
+server.tool(
+  "calculate_debt_to_income_ratio",
+  "Compute the debt-to-income ratio (total monthly debt payments / gross monthly income) from one or more monthly debt items, plus a qualitative tier matching common mortgage-lending guidance: under 36% is healthy, under 43% is moderate (43% is the back-end ratio ceiling many mortgage lenders use), under 50% is high, and 50%+ is severe. This is a back-end DTI (all monthly debt payments over gross income), not a front-end housing-only ratio.",
+  {
+    debts: z.array(z.object({
+      label: z.string().optional().describe("Optional debt label"),
+      amount: z.number().min(0).describe("Monthly payment amount for this debt")
+    })).min(1).describe("A non-empty list of monthly debt payments"),
+    grossMonthlyIncome: z.number().positive().describe("Gross (pre-tax) monthly income")
+  },
+  async ({ debts, grossMonthlyIncome }) => {
+    const result = _calculateDebtToIncomeRatioMcp(debts, grossMonthlyIncome);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var _CAPTION_TIMESTAMP_RE_MCP = /(\d+):(\d{1,2}):(\d{1,2})[.,](\d{1,3})|(\d{1,3}):(\d{1,2})[.,](\d{1,3})/;
 var _CAPTION_SKIP_BLOCK_KEYWORDS_MCP = ["NOTE", "STYLE", "REGION"];
 function _parseCaptionTimestampMcp(raw) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.55.0",
+  "version": "0.56.0",
   "description": "MCP server exposing 198 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",