whyusersleave 1.0.0 → 1.1.0

package/index.js

@@ -13,9 +13,12 @@ if (!API_KEY) {
 
 const server = new McpServer({
   name: "whyusersleave",
-  version: "1.0.0",
+  version: "1.1.0",
 });
 
+// Cache resolved sites
+let resolvedSites = null;
+
 async function apiCall(path, options = {}) {
   const url = `${API_BASE}${path}`;
   const res = await fetch(url, {
@@ -33,85 +36,140 @@ async function apiCall(path, options = {}) {
   return res;
 }
 
+/** Fire-and-forget tool call tracking */
+function trackToolCall(toolName) {
+  fetch(`${API_BASE}/api/mcp/activity`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ tool_name: toolName }),
+  }).catch(() => {});
+}
+
+/**
+ * Resolve sites from the API key.
+ * User keys (wul_u_*) return multiple sites.
+ * Site keys return a single site.
+ */
+async function getSites() {
+  if (resolvedSites) return resolvedSites;
+
+  const res = await apiCall("/api/me");
+  const data = await res.json();
+
+  if (data.sites) {
+    // User-level key — multiple sites
+    resolvedSites = data.sites;
+  } else if (data.site) {
+    // Site-level key — single site
+    resolvedSites = [data.site];
+  } else {
+    resolvedSites = [];
+  }
+
+  return resolvedSites;
+}
+
+/** Build site_id query param for API calls */
+function siteParam(siteId) {
+  return siteId ? `site_id=${siteId}` : "";
+}
+
+/** Join query params */
+function qs(...params) {
+  const valid = params.filter(Boolean);
+  return valid.length > 0 ? `?${valid.join("&")}` : "";
+}
+
 // Tool 1: get_ux_issues
 server.tool(
   "get_ux_issues",
-  "Get current UX issues detected on your site. Returns open issues with severity, context, and before/after deltas. Use this to check what needs fixing.",
+  "Get current UX issues detected on your site(s). Returns open issues with severity, context, and before/after deltas. Use this to check what needs fixing.",
   {},
   async () => {
-    const res = await apiCall("/api/issues");
-    const data = await res.json();
-    const { issues, summary, lastRun } = data;
+    const sites = await getSites();
+    trackToolCall("get_ux_issues");
 
-    if (!issues || issues.length === 0) {
+    if (sites.length === 0) {
       return {
-        content: [{
-          type: "text",
-          text: "No UX issues tracked yet. Run `generate_report` first to analyze your site and start tracking issues.",
-        }],
+        content: [{ type: "text", text: "No sites found for this API key." }],
       };
     }
 
-    const lines = [];
+    const allLines = [];
 
-    // Summary
-    lines.push(`## UX Issues Summary`);
-    lines.push(`${summary.open || 0} open, ${summary.improved || 0} improving, ${summary.fixed || 0} fixed (${summary.totalTracked || 0} total tracked)\n`);
+    for (const site of sites) {
+      const res = await apiCall(`/api/issues${qs(siteParam(site.id))}`);
+      const data = await res.json();
+      const { issues, summary, lastRun } = data;
 
-    // Last run info
-    if (lastRun && lastRun.sentCount > 0) {
-      lines.push(`**Last report:** Sent ${lastRun.sentCount} issues to Claude Code`);
-      if (lastRun.fixedCount > 0) lines.push(`  - ${lastRun.fixedCount} fixed`);
-      if (lastRun.improvedCount > 0) lines.push(`  - ${lastRun.improvedCount} improving`);
-      if (lastRun.stillOpenCount > 0) lines.push(`  - ${lastRun.stillOpenCount} still open`);
-      lines.push("");
-    }
+      if (sites.length > 1) {
+        allLines.push(`# ${site.name || site.domain}\n`);
+      }
 
-    // Group by severity
-    const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
-    const open = issues
-      .filter((i) => i.status === "open" || i.status === "regressed" || i.status === "improved")
-      .sort((a, b) => (severityOrder[a.severity] ?? 2) - (severityOrder[b.severity] ?? 2));
-
-    const fixed = issues.filter((i) => i.status === "fixed");
-
-    if (open.length > 0) {
-      lines.push("### Open Issues\n");
-      for (const issue of open) {
-        const sev = (issue.severity || "medium").toUpperCase();
-        const status = issue.status === "improved" ? " (improving)" : issue.status === "regressed" ? " (REGRESSED)" : "";
-        lines.push(`**[${sev}]** ${issue.title}${status}`);
-        lines.push(`  Page: ${issue.page}`);
-
-        // Show delta if available
-        if (issue.baseline_value !== undefined && issue.baseline_value !== null) {
-          const delta = issue.delta || 0;
-          const direction = delta < 0 ? "improving" : delta > 0 ? "worsening" : "no change";
-          lines.push(`  Value: ${Math.round(issue.baseline_value)} → ${Math.round(issue.current_value)} (${delta > 0 ? "+" : ""}${Math.round(delta)}, ${direction})`);
-        } else {
-          lines.push(`  Value: ${Math.round(issue.current_value)}`);
-        }
+      if (!issues || issues.length === 0) {
+        allLines.push("No UX issues tracked yet. Run `generate_report` first to analyze your site and start tracking issues.\n");
+        continue;
+      }
 
-        // Context
-        const context = issue.extra?.context || issue.description;
-        if (context) lines.push(`  ${context}`);
+      // Summary
+      allLines.push(`## UX Issues Summary`);
+      allLines.push(`${summary.open || 0} open, ${summary.improved || 0} improving, ${summary.fixed || 0} fixed (${summary.totalTracked || 0} total tracked)\n`);
+
+      // Last run info
+      if (lastRun && lastRun.sentCount > 0) {
+        allLines.push(`**Last report:** Sent ${lastRun.sentCount} issues to Claude Code`);
+        if (lastRun.fixedCount > 0) allLines.push(`  - ${lastRun.fixedCount} fixed`);
+        if (lastRun.improvedCount > 0) allLines.push(`  - ${lastRun.improvedCount} improving`);
+        if (lastRun.stillOpenCount > 0) allLines.push(`  - ${lastRun.stillOpenCount} still open`);
+        allLines.push("");
+      }
 
-        if (issue.selector) lines.push(`  Selector: \`${issue.selector}\``);
-        lines.push("");
+      // Group by severity
+      const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+      const open = issues
+        .filter((i) => i.status === "open" || i.status === "regressed" || i.status === "improved")
+        .sort((a, b) => (severityOrder[a.severity] ?? 2) - (severityOrder[b.severity] ?? 2));
+
+      const fixed = issues.filter((i) => i.status === "fixed");
+
+      if (open.length > 0) {
+        allLines.push("### Open Issues\n");
+        for (const issue of open) {
+          const sev = (issue.severity || "medium").toUpperCase();
+          const status = issue.status === "improved" ? " (improving)" : issue.status === "regressed" ? " (REGRESSED)" : "";
+          allLines.push(`**[${sev}]** ${issue.title}${status}`);
+          allLines.push(`  Page: ${issue.page}`);
+
+          if (issue.baseline_value !== undefined && issue.baseline_value !== null) {
+            const delta = issue.delta || 0;
+            const direction = delta < 0 ? "improving" : delta > 0 ? "worsening" : "no change";
+            allLines.push(`  Value: ${Math.round(issue.baseline_value)} → ${Math.round(issue.current_value)} (${delta > 0 ? "+" : ""}${Math.round(delta)}, ${direction})`);
+          } else {
+            allLines.push(`  Value: ${Math.round(issue.current_value)}`);
+          }
+
+          const context = issue.extra?.context || issue.description;
+          if (context) allLines.push(`  ${context}`);
+          if (issue.selector) allLines.push(`  Selector: \`${issue.selector}\``);
+          allLines.push("");
+        }
       }
-    }
 
-    if (fixed.length > 0) {
-      lines.push(`### Fixed (${fixed.length})\n`);
-      for (const issue of fixed.slice(0, 5)) {
-        const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : Math.round(issue.peak_value || 0);
-        lines.push(`- ~~${issue.title}~~ (${baseVal} → 0, fixed ${issue.fixed_at ? new Date(issue.fixed_at).toLocaleDateString() : "recently"})`);
+      if (fixed.length > 0) {
+        allLines.push(`### Fixed (${fixed.length})\n`);
+        for (const issue of fixed.slice(0, 5)) {
+          const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : Math.round(issue.peak_value || 0);
+          allLines.push(`- ~~${issue.title}~~ (${baseVal} → 0, fixed ${issue.fixed_at ? new Date(issue.fixed_at).toLocaleDateString() : "recently"})`);
+        }
+        if (fixed.length > 5) allLines.push(`- ...and ${fixed.length - 5} more`);
       }
-      if (fixed.length > 5) lines.push(`- ...and ${fixed.length - 5} more`);
     }
 
     return {
-      content: [{ type: "text", text: lines.join("\n") }],
+      content: [{ type: "text", text: allLines.join("\n") }],
     };
   }
 );
@@ -119,21 +177,30 @@ server.tool(
 // Tool 2: generate_report
 server.tool(
   "generate_report",
-  "Generate a comprehensive UX report with data tables and AI analysis. This runs the full aggregate pipeline on recent session data, then produces a 10-section report including dead clicks, JS errors, form abandonment, page performance, session examples, and a strategic AI analysis. Takes 15-30 seconds.",
+  "Generate a comprehensive UX report with data tables and AI analysis. This runs the full aggregate pipeline on recent session data, then produces a 10-section report. Takes 15-30 seconds. If you have multiple sites, generates a report for each.",
   {},
   async () => {
-    // Step 1: Run aggregate pipeline
-    await apiCall("/api/insights/aggregate", {
-      method: "POST",
-      body: JSON.stringify({}),
-    });
-
-    // Step 2: Stream the export
-    const res = await apiCall("/api/insights/export");
-    const text = await res.text();
+    const sites = await getSites();
+    trackToolCall("generate_report");
+    const allOutput = [];
+
+    for (const site of sites) {
+      if (sites.length > 1) {
+        allOutput.push(`# ${site.name || site.domain}\n`);
+      }
+
+      await apiCall(`/api/insights/aggregate${qs(siteParam(site.id))}`, {
+        method: "POST",
+        body: JSON.stringify({}),
+      });
+
+      const res = await apiCall(`/api/insights/export${qs(siteParam(site.id))}`);
+      const text = await res.text();
+      allOutput.push(text);
+    }
 
     return {
-      content: [{ type: "text", text }],
+      content: [{ type: "text", text: allOutput.join("\n\n---\n\n") }],
     };
   }
 );
@@ -141,66 +208,72 @@ server.tool(
 // Tool 3: verify_fixes
 server.tool(
   "verify_fixes",
-  "Re-analyze your site with fresh session data to see if your fixes worked. Runs the aggregate pipeline on recent sessions (last 24 hours preferred), then returns a before/after comparison of all tracked issues. Use this after deploying fixes to confirm they worked.",
+  "Re-analyze your site(s) with fresh session data to see if your fixes worked. Returns a before/after comparison of all tracked issues.",
   {},
   async () => {
-    // Step 1: Re-aggregate fresh data
-    await apiCall("/api/insights/aggregate", {
-      method: "POST",
-      body: JSON.stringify({}),
-    });
+    const sites = await getSites();
+    trackToolCall("verify_fixes");
+    const allLines = [];
+
+    for (const site of sites) {
+      if (sites.length > 1) {
+        allLines.push(`# ${site.name || site.domain}\n`);
+      }
 
-    // Step 2: Re-generate export (this updates issue tracking)
-    await apiCall("/api/insights/export").then((r) => r.text());
+      await apiCall(`/api/insights/aggregate${qs(siteParam(site.id))}`, {
+        method: "POST",
+        body: JSON.stringify({}),
+      });
 
-    // Step 3: Get updated issues with deltas
-    const issuesRes = await apiCall("/api/issues");
-    const { issues, summary, lastRun } = await issuesRes.json();
+      await apiCall(`/api/insights/export${qs(siteParam(site.id))}`).then((r) => r.text());
 
-    const lines = [];
-    lines.push("## Verification Results\n");
-    lines.push(`Re-aggregated fresh session data. ${summary.totalTracked || 0} issues tracked.\n`);
-
-    const fixed = issues.filter((i) => i.status === "fixed");
-    const improved = issues.filter((i) => i.status === "improved");
-    const open = issues.filter((i) => i.status === "open" || i.status === "regressed");
-
-    if (fixed.length > 0) {
-      lines.push(`### Fixed (${fixed.length})\n`);
-      for (const issue of fixed) {
-        const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : Math.round(issue.peak_value || 0);
-        lines.push(`- ${issue.title}: ${baseVal} → 0 ✓`);
+      const issuesRes = await apiCall(`/api/issues${qs(siteParam(site.id))}`);
+      const { issues, summary } = await issuesRes.json();
+
+      allLines.push("## Verification Results\n");
+      allLines.push(`Re-aggregated fresh session data. ${summary.totalTracked || 0} issues tracked.\n`);
+
+      const fixed = issues.filter((i) => i.status === "fixed");
+      const improved = issues.filter((i) => i.status === "improved");
+      const open = issues.filter((i) => i.status === "open" || i.status === "regressed");
+
+      if (fixed.length > 0) {
+        allLines.push(`### Fixed (${fixed.length})\n`);
+        for (const issue of fixed) {
+          const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : Math.round(issue.peak_value || 0);
+          allLines.push(`- ${issue.title}: ${baseVal} → 0 ✓`);
+        }
+        allLines.push("");
       }
-      lines.push("");
-    }
 
-    if (improved.length > 0) {
-      lines.push(`### Improving (${improved.length})\n`);
-      for (const issue of improved) {
-        const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : "?";
-        const delta = issue.delta !== undefined ? ` (${issue.delta > 0 ? "+" : ""}${Math.round(issue.delta)})` : "";
-        lines.push(`- ${issue.title}: ${baseVal} → ${Math.round(issue.current_value)}${delta}`);
+      if (improved.length > 0) {
+        allLines.push(`### Improving (${improved.length})\n`);
+        for (const issue of improved) {
+          const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : "?";
+          const delta = issue.delta !== undefined ? ` (${issue.delta > 0 ? "+" : ""}${Math.round(issue.delta)})` : "";
+          allLines.push(`- ${issue.title}: ${baseVal} → ${Math.round(issue.current_value)}${delta}`);
+        }
+        allLines.push("");
       }
-      lines.push("");
-    }
 
-    if (open.length > 0) {
-      lines.push(`### Still Open (${open.length})\n`);
-      for (const issue of open) {
-        const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : "?";
-        const delta = issue.delta !== undefined ? ` (${issue.delta > 0 ? "+" : ""}${Math.round(issue.delta)})` : "";
-        const sev = (issue.severity || "medium").toUpperCase();
-        lines.push(`- [${sev}] ${issue.title}: ${baseVal} → ${Math.round(issue.current_value)}${delta}`);
+      if (open.length > 0) {
+        allLines.push(`### Still Open (${open.length})\n`);
+        for (const issue of open) {
+          const baseVal = issue.baseline_value !== undefined ? Math.round(issue.baseline_value) : "?";
+          const delta = issue.delta !== undefined ? ` (${issue.delta > 0 ? "+" : ""}${Math.round(issue.delta)})` : "";
+          const sev = (issue.severity || "medium").toUpperCase();
+          allLines.push(`- [${sev}] ${issue.title}: ${baseVal} → ${Math.round(issue.current_value)}${delta}`);
+        }
+        allLines.push("");
       }
-      lines.push("");
-    }
 
-    if (fixed.length === 0 && improved.length === 0 && open.length === 0) {
-      lines.push("No issues tracked yet. Run `generate_report` first.");
+      if (fixed.length === 0 && improved.length === 0 && open.length === 0) {
+        allLines.push("No issues tracked yet. Run `generate_report` first.\n");
+      }
     }
 
     return {
-      content: [{ type: "text", text: lines.join("\n") }],
+      content: [{ type: "text", text: allLines.join("\n") }],
     };
   }
 );
@@ -208,30 +281,34 @@ server.tool(
 // Tool 4: get_site_context
 server.tool(
   "get_site_context",
-  "Get product context for your site — description, key pages, user journey, business model. Useful for understanding the app you're working on.",
+  "Get product context for your site(s) — description, key pages, user journey, business model.",
   {},
   async () => {
-    const res = await apiCall("/api/me");
-    const { site } = await res.json();
-
+    const sites = await getSites();
+    trackToolCall("get_site_context");
     const lines = [];
-    lines.push(`## ${site.name || "Site"} (${site.domain || "unknown domain"})\n`);
-
-    const ctx = site.context || {};
-    if (ctx.description) lines.push(ctx.description);
-    if (ctx.user_journey) lines.push(`\n**User journey:** ${ctx.user_journey}`);
-    if (ctx.business_model) lines.push(`**Business model:** ${ctx.business_model}`);
-    if (ctx.success_metrics) lines.push(`**Success metrics:** ${ctx.success_metrics}`);
-
-    if (ctx.key_pages && typeof ctx.key_pages === "object") {
-      lines.push("\n**Key pages:**");
-      for (const [path, desc] of Object.entries(ctx.key_pages)) {
-        lines.push(`- ${path}: ${desc}`);
+
+    for (const site of sites) {
+      lines.push(`## ${site.name || "Site"} (${site.domain || "unknown domain"})\n`);
+
+      const ctx = site.context || {};
+      if (ctx.description) lines.push(ctx.description);
+      if (ctx.user_journey) lines.push(`\n**User journey:** ${ctx.user_journey}`);
+      if (ctx.business_model) lines.push(`**Business model:** ${ctx.business_model}`);
+      if (ctx.success_metrics) lines.push(`**Success metrics:** ${ctx.success_metrics}`);
+
+      if (ctx.key_pages && typeof ctx.key_pages === "object") {
+        lines.push("\n**Key pages:**");
+        for (const [path, desc] of Object.entries(ctx.key_pages)) {
+          lines.push(`- ${path}: ${desc}`);
+        }
       }
-    }
 
-    if (!ctx.description) {
-      lines.push("No product context configured yet. Set it up at https://whyusersleave.vercel.app/dashboard");
+      if (!ctx.description) {
+        lines.push("No product context configured yet. Set it up at https://whyusersleave.vercel.app/dashboard");
+      }
+
+      lines.push("");
     }
 
     return {

package/package.json

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

package/.next/trace

@@ -1,2 +0,0 @@
-[{"name":"generate-buildid","duration":284,"timestamp":700550080762,"id":4,"parentId":1,"tags":{},"startTime":1770965442106,"traceId":"291b02670db969a6"},{"name":"load-custom-routes","duration":233,"timestamp":700550081483,"id":5,"parentId":1,"tags":{},"startTime":1770965442106,"traceId":"291b02670db969a6"},{"name":"next-build","duration":95028,"timestamp":700549989812,"id":1,"tags":{"buildMode":"default","isTurboBuild":"false","version":"14.2.21","isTurbopack":false},"startTime":1770965442015,"traceId":"291b02670db969a6"}]
-[{"name":"generate-buildid","duration":280,"timestamp":700557038698,"id":4,"parentId":1,"tags":{},"startTime":1770965449063,"traceId":"7da191ad32ede36c"},{"name":"load-custom-routes","duration":207,"timestamp":700557039344,"id":5,"parentId":1,"tags":{},"startTime":1770965449064,"traceId":"7da191ad32ede36c"},{"name":"next-build","duration":90123,"timestamp":700556951361,"id":1,"tags":{"buildMode":"default","isTurboBuild":"false","version":"14.2.21","isTurbopack":false},"startTime":1770965448976,"traceId":"7da191ad32ede36c"}]