@utilix-tech/mcp 0.3.0 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 70 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 95 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.
 
@@ -52,6 +52,27 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "utilix": {
+      "command": "npx",
+      "args": ["-y", "@utilix-tech/mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add utilix -- npx -y @utilix-tech/mcp
+```
+
 ## Tools
 
 ### JSON (13 tools)
@@ -176,6 +197,35 @@ Add to `.vscode/mcp.json`:
 | `unicode_inspect` | Inspect Unicode code points of a string |
 | `optimize_svg` | Optimize and minify an SVG string |
 
+### AI / Agent (25 tools)
+| Tool | Description |
+|------|-------------|
+| `estimate_tokens` | Estimate token count and cost for an LLM prompt |
+| `trim_to_tokens` | Trim text to fit a token budget |
+| `chunk_text` | Split text into overlapping chunks for RAG pipelines |
+| `rerank_chunks` | Rerank retrieved chunks by relevance to a query |
+| `score_relevance` | Score a chunk's relevance to a query |
+| `expand_query` | Expand a search query with synonyms/related terms |
+| `summarize_for_llm` | Summarize text to fit a target length or token budget |
+| `detect_pii` | Find emails, phones, SSNs, credit cards in text |
+| `detect_secrets` | Scan text for leaked API keys, tokens, passwords |
+| `detect_prompt_injection` | Score and flag adversarial/injection-style inputs |
+| `repair_json` | Fix malformed JSON with a list of applied fixes |
+| `sanitize_html` | Strip unsafe tags/attributes from HTML |
+| `flatten_json` | Flatten nested JSON into dot-notation keys |
+| `merge_json` | Deep or shallow merge two JSON objects |
+| `extract_json` | Extract JSON blocks embedded in free text |
+| `extract_urls` | Extract all URLs from text |
+| `extract_entities` | Extract named entities from text |
+| `extract_keywords` | Extract keywords from text |
+| `extract_tables` | Extract tabular data from text |
+| `deduplicate_lines` | Remove duplicate lines from text |
+| `validate_json_schema` | Validate JSON against a JSON Schema |
+| `compress_html` | Compress HTML for LLM context budgets |
+| `compress_markdown` | Compress Markdown for LLM context budgets |
+| `compress_json` | Compress JSON for LLM context budgets |
+| `diff_json_detailed` | Diff two parsed JSON values, returning every path with its op and unchanged paths |
+
 ## Requirements
 
 - Node.js 18+
@@ -183,5 +233,7 @@ Add to `.vscode/mcp.json`:
 ## Links
 
 - [Utilix web app](https://utilix.tech) — use these tools in the browser
+- [API Playground](https://utilix.tech/api) — try 10 endpoints live, no signup required
+- [REST API docs](https://utilix.tech/docs#rest-api) — 100+ endpoints at `api.utilix.tech/v1` (1,000 req/day free)
 - [Node.js SDK](https://www.npmjs.com/package/@utilix-tech/sdk) — use in your Node.js projects
 - [Python SDK](https://pypi.org/project/utilix-sdk/) — use in your Python projects

package/dist/index.js

@@ -7,6 +7,7 @@ import { z } from "zod";
 import {
   parseJson,
   minifyJson,
+  diffJson,
   jsonToCsv,
   csvToJson,
   evaluateJsonPath,
@@ -73,7 +74,7 @@ import { formatSql, formatHtml, testRegex, minifyJs, formatGql, parseDockerImage
 import { validateYaml, tomlToJson, xmlToJson, parseCsv } from "@utilix-tech/sdk/data";
 import { generateGradient, minifyCss } from "@utilix-tech/sdk/css";
 import { optimizeSvg, charToCodePoint, numberToWords } from "@utilix-tech/sdk/misc";
-import { estimateTokens, estimateCost, detectPii, redactPii, detectSecrets, detectPromptInjection, repairJson, trimToTokens, chunkText, extractUrls, sanitizeHtml, flattenJson, unflattenJson, mergeJson, extractJson, deduplicateLines, extractKeywords, validateJsonSchema, diffJson, extractTables, extractEntities, compressHtml, compressMarkdown, compressJson, rerankChunks, scoreRelevance, expandQuery, summarizeForLlm } from "@utilix-tech/sdk/ai_agent";
+import { estimateTokens, estimateCost, detectPii, redactPii, detectSecrets, detectPromptInjection, repairJson, trimToTokens, chunkText, extractUrls, sanitizeHtml, flattenJson, unflattenJson, mergeJson, extractJson, deduplicateLines, extractKeywords, validateJsonSchema, diffJson as diffJsonDetailed, extractTables, extractEntities, compressHtml, compressMarkdown, compressJson, rerankChunks, scoreRelevance, expandQuery, summarizeForLlm } from "@utilix-tech/sdk/ai_agent";
 var CRON_DAY_MAP = {
   SUN: "0",
   MON: "1",
@@ -1112,8 +1113,8 @@ server.tool("extract_keywords", "Extract top keywords using TF-IDF scoring.", {
 server.tool("validate_json_schema", "Validate JSON data against a JSON Schema (Draft-07).", { data: z.unknown(), schema: z.record(z.unknown()) }, async ({ data, schema }) => {
   return { content: [{ type: "text", text: JSON.stringify(validateJsonSchema(data, schema), null, 2) }] };
 });
-server.tool("diff_json", "Diff two JSON objects \u2014 returns added, removed, changed, and unchanged paths.", { a: z.unknown(), b: z.unknown() }, async ({ a, b }) => {
-  return { content: [{ type: "text", text: JSON.stringify(diffJson(a, b), null, 2) }] };
+server.tool("diff_json_detailed", "Diff two JSON objects (parsed values, not strings) \u2014 returns a flat list of every path with its op (added/removed/changed/unchanged), plus counts.", { a: z.unknown(), b: z.unknown() }, async ({ a, b }) => {
+  return { content: [{ type: "text", text: JSON.stringify(diffJsonDetailed(a, b), null, 2) }] };
 });
 server.tool("extract_tables", "Extract HTML tables into JSON arrays with headers and rows.", { html: z.string() }, async ({ html }) => {
   return { content: [{ type: "text", text: JSON.stringify(extractTables(html), null, 2) }] };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.3.0",
-  "description": "MCP server exposing 70 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
+  "version": "0.3.1",
+  "description": "MCP server exposing 95 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",
   "homepage": "https://utilix.tech/docs",
@@ -32,7 +32,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && chmod +x dist/index.js",
     "dev": "tsup --watch",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build"

package/smithery.yaml

@@ -1,7 +1,8 @@
 name: utilix
-description: 70 developer utility tools — JSON, hashing, encoding, JWT, UUID, cron, color, SQL, regex, CSS, QR codes and more. All run locally, no API key required.
-homepage: https://utilix.tech
+description: 70 developer utility tools for Claude, Cursor, VS Code, Windsurf, and any MCP-compatible AI assistant. Covers JSON, hashing, encoding, JWT, UUID, cron, color, SQL, regex, CSS, QR codes, and more. All tools run locally — no API key required.
+homepage: https://utilix.tech/mcp
 license: MIT
+repository: https://github.com/utilix-tech/utilix-mcp
 
 startCommand:
   type: stdio