fix: search_tools natural language, get_tool/compare_tools case-insensitive slugs, compare UTM tags

Author: imkemit-ops

index.js

@@ -166,7 +166,7 @@ const CATEGORIES = [
 const TOOL_DEFINITIONS = [
   {
     name: 'search_tools',
-    description: 'Search 508+ software products by name, keyword, or use case. Returns name, category, rating, free plan availability, starting price, and ComparEdge URL.\n\nBEHAVIOR: Performs fuzzy matching across product names and categories. Returns up to `limit` results ranked by relevance. Each result includes a direct ComparEdge link.\n\nUSAGE GUIDELINES:\n- Use to discover tools when you do not know the exact slug.\n- Use before calling get_tool or get_pricing if the slug is uncertain.\n- Use for category browsing: query "crm", "ai coding", "project management".\n\nEXAMPLE QUERIES: "Find CRM tools", "search for Slack alternatives", "what project management tools exist?"',
+    description: 'Search 495+ software products by name, keyword, category, or natural language query. Returns name, category, rating, free plan availability, starting price, and ComparEdge URL.\n\nBEHAVIOR: Scores each product against all meaningful keywords in the query (stopwords like "best", "find", "top" are ignored). Supports both exact product names and natural language queries.\n\nUSAGE GUIDELINES:\n- Use to discover tools when you do not know the exact slug.\n- Use before calling get_tool or get_pricing if the slug is uncertain.\n- Use for category browsing: query "crm", "ai coding", "project management".\n- Natural language works: "best CRM for startups" → extracts "crm" and "startups" keywords.\n\nEXAMPLE QUERIES: "notion", "CRM", "best CRM for startups", "project management free", "ai coding tools"',
     inputSchema: {
       type: 'object',
       properties: {
@@ -329,9 +329,15 @@ function fmtRow(label, v1, v2) {
 
 async function searchTools(args) {
   const { query, limit = 5 } = args;
-  const q = query.toLowerCase();
   const allTools = await getAllTools();
 
+  // Stopwords to ignore when splitting natural language queries
+  const STOPWORDS = new Set(['find','best','top','what','are','the','for','a','an','to','in','of','and','or','with','use','using','good','great','cheap','free','open','source','tool','tools','software','app','apps','platform','service']);
+
+  // Split query into meaningful keywords, strip stopwords
+  const qFull = query.toLowerCase();
+  const qWords = qFull.split(/\s+/).filter(w => w.length > 1 && !STOPWORDS.has(w));
+
   // Score each tool by relevance
   const scored = allTools
     .map(t => {
@@ -341,12 +347,22 @@ async function searchTools(args) {
       const desc = (t.description || '').toLowerCase();
       const cat  = (t.categoryName || t.category || '').toLowerCase();
 
-      if (name === q) score += 100;
-      else if (name.startsWith(q)) score += 60;
-      else if (name.includes(q)) score += 40;
-      if (slug.includes(q)) score += 30;
-      if (desc.includes(q)) score += 20;
-      if (cat.includes(q)) score += 15;
+      // Exact full-query match (highest priority)
+      if (name === qFull) score += 100;
+      else if (name.startsWith(qFull)) score += 60;
+      else if (name.includes(qFull)) score += 40;
+      if (slug.includes(qFull)) score += 30;
+      if (cat.includes(qFull)) score += 15;
+
+      // Individual keyword matches (natural language support)
+      for (const w of qWords) {
+        if (name === w) score += 50;
+        else if (name.startsWith(w)) score += 30;
+        else if (name.includes(w)) score += 20;
+        if (slug.includes(w)) score += 15;
+        if (cat.includes(w)) score += 10;
+        if (desc.includes(w)) score += 5;
+      }
 
       return { t, score };
     })
@@ -374,7 +390,7 @@ async function searchTools(args) {
 }
 
 async function getTool(args) {
-  const { slug } = args;
+  const slug = (args.slug || '').toLowerCase().trim();
   const [allTools, allPricing] = await Promise.all([getAllTools(), getAllPricing()]);
 
   const t = allTools.find(x => x.slug === slug);
@@ -414,7 +430,8 @@ async function getTool(args) {
 }
 
 async function compareTools(args) {
-  const { tool1, tool2 } = args;
+  const tool1 = (args.tool1 || '').toLowerCase().trim();
+  const tool2 = (args.tool2 || '').toLowerCase().trim();
   const allTools = await getAllTools();
 
   const t1 = allTools.find(x => x.slug === tool1);
@@ -449,9 +466,9 @@ async function compareTools(args) {
     p2.forEach(p => lines.push(`  - ${p.name}: ${formatPrice(p.price)}`));
   }
 
-  lines.push(`\n${t1.name} URL: ${toolURL(tool1)}`);
-  lines.push(`${t2.name} URL: ${toolURL(tool2)}`);
-  lines.push(`Full comparison: ${SITE_BASE}/compare/${tool1}-vs-${tool2}`);
+  lines.push(`\n${t1.name} URL: ${toolURL(tool1, true)}`);
+  lines.push(`${t2.name} URL: ${toolURL(tool2, true)}`);
+  lines.push(`Full comparison: ${SITE_BASE}/compare/${tool1}-vs-${tool2}?utm_source=mcp&utm_medium=ide&utm_campaign=comparedge-mcp`);
   return lines.join('\n');
 }
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comparedge/mcp-server",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "mcpName": "io.github.imkemit-ops/comparedge-mcp",
   "description": "MCP server for ComparEdge: verified pricing, alternatives, and feature comparisons for 508+ SaaS and AI tools.",
   "main": "index.js",