whyusersleave 1.1.0 → 1.3.1

package/index.js

@@ -13,7 +13,7 @@ if (!API_KEY) {
 
 const server = new McpServer({
   name: "whyusersleave",
-  version: "1.1.0",
+  version: "1.3.1",
 });
 
 // Cache resolved sites
@@ -36,15 +36,18 @@ async function apiCall(path, options = {}) {
   return res;
 }
 
-/** Fire-and-forget tool call tracking */
-function trackToolCall(toolName) {
+/** Fire-and-forget tool call tracking with optional result logging */
+function trackToolCall(toolName, { input, result } = {}) {
+  const payload = { tool_name: toolName };
+  if (input) payload.input = input;
+  if (result) payload.result = typeof result === "string" ? result : JSON.stringify(result);
   fetch(`${API_BASE}/api/mcp/activity`, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${API_KEY}`,
       "Content-Type": "application/json",
     },
-    body: JSON.stringify({ tool_name: toolName }),
+    body: JSON.stringify(payload),
   }).catch(() => {});
 }
 
@@ -90,7 +93,6 @@ server.tool(
   {},
   async () => {
     const sites = await getSites();
-    trackToolCall("get_ux_issues");
 
     if (sites.length === 0) {
       return {
@@ -168,8 +170,10 @@ server.tool(
       }
     }
 
+    const output = allLines.join("\n");
+    trackToolCall("get_ux_issues", { result: output });
     return {
-      content: [{ type: "text", text: allLines.join("\n") }],
+      content: [{ type: "text", text: output }],
     };
   }
 );
@@ -181,7 +185,6 @@ server.tool(
   {},
   async () => {
     const sites = await getSites();
-    trackToolCall("generate_report");
     const allOutput = [];
 
     for (const site of sites) {
@@ -199,8 +202,10 @@ server.tool(
       allOutput.push(text);
     }
 
+    const output = allOutput.join("\n\n---\n\n");
+    trackToolCall("generate_report", { result: output });
     return {
-      content: [{ type: "text", text: allOutput.join("\n\n---\n\n") }],
+      content: [{ type: "text", text: output }],
     };
   }
 );
@@ -212,7 +217,6 @@ server.tool(
   {},
   async () => {
     const sites = await getSites();
-    trackToolCall("verify_fixes");
     const allLines = [];
 
     for (const site of sites) {
@@ -272,8 +276,10 @@ server.tool(
       }
     }
 
+    const output = allLines.join("\n");
+    trackToolCall("verify_fixes", { result: output });
     return {
-      content: [{ type: "text", text: allLines.join("\n") }],
+      content: [{ type: "text", text: output }],
     };
   }
 );
@@ -285,7 +291,6 @@ server.tool(
   {},
   async () => {
     const sites = await getSites();
-    trackToolCall("get_site_context");
     const lines = [];
 
     for (const site of sites) {
@@ -311,8 +316,94 @@ server.tool(
       lines.push("");
     }
 
+    const output = lines.join("\n");
+    trackToolCall("get_site_context", { result: output });
     return {
-      content: [{ type: "text", text: lines.join("\n") }],
+      content: [{ type: "text", text: output }],
+    };
+  }
+);
+
+// Tool 5: ask_question
+server.tool(
+  "ask_question",
+  "Ask a question about user behavior on your site. Returns a data-grounded answer from your real analytics. Use this to understand WHY users behave a certain way, not just WHAT they do. Examples: 'Why are users bouncing from /pricing?', 'What form fields cause the most abandonment?', 'What are users searching for with Ctrl+F?'",
+  {
+    question: {
+      type: "string",
+      description:
+        "Natural language question about user behavior, e.g. 'Why are users bouncing from /pricing?'",
+    },
+  },
+  async ({ question }) => {
+    const sites = await getSites();
+    const allLines = [];
+
+    for (const site of sites) {
+      if (sites.length > 1) {
+        allLines.push(`# ${site.name || site.domain}\n`);
+      }
+
+      const res = await apiCall(`/api/ask${qs(siteParam(site.id))}`, {
+        method: "POST",
+        body: JSON.stringify({ question }),
+      });
+      const data = await res.json();
+      allLines.push(data.answer || "No answer generated.");
+
+      if (data.sources?.length > 0) {
+        allLines.push(`\n*Based on: ${data.sources.join(", ")}*`);
+      }
+    }
+
+    const output = allLines.join("\n\n");
+    trackToolCall("ask_question", { input: { question }, result: output });
+    return {
+      content: [{ type: "text", text: output }],
+    };
+  }
+);
+
+// Tool 6: get_recommendations
+server.tool(
+  "get_recommendations",
+  "Get a prioritized action plan based on real user behavior data. Returns 3-5 recommendations ordered by business impact — what's hurting conversion/retention most and exactly what to fix. Call this before starting any work to know where to focus.",
+  {},
+  async () => {
+    const sites = await getSites();
+    const allLines = [];
+
+    for (const site of sites) {
+      if (sites.length > 1) {
+        allLines.push(`# ${site.name || site.domain}\n`);
+      }
+
+      const res = await apiCall(
+        `/api/recommendations${qs(siteParam(site.id))}`
+      );
+      const data = await res.json();
+
+      if (data.data_status === "no_data") {
+        allLines.push(
+          data.recommendations ||
+            "No data yet. Run `generate_report` first."
+        );
+        continue;
+      }
+
+      if (data.stats) {
+        allLines.push(
+          `*${data.stats.sessions} sessions, ${data.stats.bounce_rate}% bounce rate, ${data.stats.open_issues} open issues*\n`
+        );
+      }
+
+      allLines.push(data.recommendations || "No recommendations generated.");
+    }
+
+    const output = allLines.join("\n\n");
+    trackToolCall("get_recommendations", { result: output });
+    return {
+      content: [{ type: "text", text: output }],
     };
   }
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whyusersleave",
-  "version": "1.1.0",
+  "version": "1.3.1",
   "description": "MCP server for WhyUsersLeave UX analytics — get UX issues, generate reports, and verify fixes directly in Claude Code",
   "bin": {
     "whyusersleave": "./index.js"