@utilix-tech/mcp 0.82.0 → 0.83.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.83.0
+- Add `extract_markdown_link_references` tool: extract reference-style Markdown links (`[text][ref]`, the `[text][]` shortcut, and `![alt][ref]` image references) and match them against their `[ref]: url` definitions, flagging unresolved references and unused definitions.
+- Add `extract_prompt_template_variables` tool: extract `{{variable}}`-style placeholders from a prompt template, report occurrence counts, flag duplicates, and optionally cross-check against a list of provided variable names.
+
 ## 0.82.0
 - Add `generate_robots_txt` tool: build a robots.txt file from User-agent groups with Allow/Disallow rules and an optional Crawl-delay, plus a list of Sitemap URLs. The generator-side sibling of `validate_robots_txt`.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 258 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 260 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.
 
@@ -282,7 +282,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `color_palette` | Generate a color palette from a base color |
 | `color_shades` | Generate shades or tints from a base color |
 
-### Code (24 tools)
+### Code (25 tools)
 | Tool | Description |
 |------|-------------|
 | `format_sql` | Format a SQL query with proper indentation |
@@ -309,6 +309,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `parse_connection_string` | Parse a database connection URI (postgres, mysql, mongodb, redis, amqp, and similar) into its scheme, credentials, hosts, database, and query parameters |
 | `validate_fence_language_tags` | Scan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tag against a curated list of common syntax-highlighter identifiers |
 | `count_sql_placeholders` | Count positional (`?`, `$1`) and named (`:name`, `@name`) parameter placeholders in a SQL query, flagging mixed styles and numbered-sequence gaps or duplicates |
+| `extract_markdown_link_references` | Extract every reference-style Markdown link ([text][ref], [text][], ![alt][ref]) and match it against its [ref]: url definition, flagging unresolved references and unused definitions |
 
 ### Data (16 tools)
 | Tool | Description |
@@ -344,7 +345,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `unicode_inspect` | Inspect Unicode code points of a string |
 | `optimize_svg` | Optimize and minify an SVG string |
 
-### AI / Agent (29 tools)
+### AI / Agent (30 tools)
 | Tool | Description |
 |------|-------------|
 | `estimate_tokens` | Estimate token count and cost for an LLM prompt |
@@ -376,6 +377,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `format_few_shot_examples` | Format input/output example pairs into a numbered, XML-tagged, or delimiter-separated few-shot prompt template |
 | `lint_tool_schema` | Lint an OpenAI, Anthropic, or MCP tool/function-calling definition for missing descriptions, invalid names, empty enums, and required/properties mismatches |
 | `calculate_retry_backoff_schedule` | Compute the full sequence of delays an exponential-backoff retry policy would actually produce, given a base delay, multiplier, and max retry count, optionally capped at a max delay and with full/equal jitter ranges |
+| `extract_prompt_template_variables` | Extract every {{variable}}-style placeholder from a prompt template, report occurrence counts, flag duplicates, and optionally cross-check against a list of provided variable names |
 
 ### Image (4 tools)
 | Tool | Description |

package/dist/index.js

@@ -13159,5 +13159,117 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _LINK_REF_DEFINITION_REGEX_MCP = /^ {0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?\s*$/;
+var _LINK_REF_USAGE_REGEX_MCP = /(!?)\[([^[\]\n]*)\]\[([^[\]\n]*)\]/g;
+function _normalizeLinkLabelMcp(label) {
+  return label.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function _extractMarkdownLinkReferencesMcp(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definitionsByLabel = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const match = line.match(_LINK_REF_DEFINITION_REGEX_MCP);
+    if (!match) continue;
+    const label = match[1];
+    const normalized = _normalizeLinkLabelMcp(label);
+    if (definitionsByLabel.has(normalized)) continue;
+    const def = { label, url: match[2], title: match[3] ?? match[4] ?? match[5] ?? void 0 };
+    definitionsByLabel.set(normalized, def);
+    definitions.push(def);
+  }
+  const usages = [];
+  for (const m of markdown.matchAll(_LINK_REF_USAGE_REGEX_MCP)) {
+    const image = m[1] === "!";
+    const text2 = m[2];
+    const rawRef = m[3];
+    const label = rawRef.trim() === "" ? text2 : rawRef;
+    usages.push({ text: text2, label, image });
+  }
+  if (definitions.length === 0 && usages.length === 0) {
+    return { error: "No reference-style links or definitions found" };
+  }
+  const usedLabels = /* @__PURE__ */ new Set();
+  const resolved = [];
+  const unresolvedReferences = [];
+  for (const usage of usages) {
+    const normalized = _normalizeLinkLabelMcp(usage.label);
+    const def = definitionsByLabel.get(normalized);
+    if (def) {
+      usedLabels.add(normalized);
+      resolved.push({ ...usage, url: def.url, title: def.title });
+    } else {
+      unresolvedReferences.push(usage);
+    }
+  }
+  const unusedDefinitions = definitions.filter((d) => !usedLabels.has(_normalizeLinkLabelMcp(d.label)));
+  return {
+    referenceCount: usages.length,
+    definitionCount: definitions.length,
+    resolved,
+    unresolvedReferences,
+    unusedDefinitions
+  };
+}
+server.tool(
+  "extract_markdown_link_references",
+  'Extract every reference-style Markdown link ([text][ref], including the shortcut form [text][] and image references ![alt][ref]) alongside its [ref]: url "title" definition, then flag usages with no matching definition and definitions that no usage ever references.',
+  {
+    markdown: z.string().min(1).describe("The Markdown document text")
+  },
+  async ({ markdown }) => {
+    const result = _extractMarkdownLinkReferencesMcp(markdown);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+var _PROMPT_TEMPLATE_VARIABLE_REGEX_MCP = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function _extractPromptTemplateVariablesMcp(template, providedVars) {
+  const trimmed = template.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const order = [];
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of template.matchAll(_PROMPT_TEMPLATE_VARIABLE_REGEX_MCP)) {
+    const name = m[1];
+    if (!counts.has(name)) {
+      counts.set(name, 0);
+      order.push(name);
+    }
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  if (order.length === 0) return { error: "No {{variable}} placeholders found" };
+  const variables = order.map((name) => ({ name, count: counts.get(name) ?? 0 }));
+  const duplicates = order.filter((name) => (counts.get(name) ?? 0) > 1);
+  let missing = [];
+  const unused = [];
+  if (providedVars !== void 0) {
+    const providedSet = new Set(providedVars.map((v) => v.trim()).filter(Boolean));
+    const usedSet = new Set(order);
+    missing = order.filter((name) => !providedSet.has(name));
+    const seenProvided = /* @__PURE__ */ new Set();
+    for (const raw of providedVars) {
+      const v = raw.trim();
+      if (!v || usedSet.has(v) || seenProvided.has(v)) continue;
+      seenProvided.add(v);
+      unused.push(v);
+    }
+  }
+  return { variableCount: order.length, variables, duplicates, missing, unused };
+}
+server.tool(
+  "extract_prompt_template_variables",
+  "Extract every {{variable}}-style placeholder from a prompt template, reporting each unique variable's occurrence count and flagging ones used more than once. Optionally cross-check against a providedVars list to flag variables the template uses that are missing, and provided names the template never references.",
+  {
+    template: z.string().min(1).describe("The prompt template text containing {{variable}} placeholders"),
+    providedVars: z.array(z.string()).optional().describe("Optional list of variable names already available, to cross-check against the template")
+  },
+  async ({ template, providedVars }) => {
+    const result = _extractPromptTemplateVariablesMcp(template, providedVars);
+    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.82.0",
+  "version": "0.83.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",