whyusersleave 1.0.0

package/.next/trace

@@ -0,0 +1,2 @@
+[{"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"}]

package/index.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const API_KEY = process.env.WUL_API_KEY;
+const API_BASE = process.env.WUL_API_URL || "https://whyusersleave.vercel.app";
+
+if (!API_KEY) {
+  console.error("Error: WUL_API_KEY environment variable is required.");
+  console.error("Get your API key from https://whyusersleave.vercel.app/dashboard");
+  process.exit(1);
+}
+
+const server = new McpServer({
+  name: "whyusersleave",
+  version: "1.0.0",
+});
+
+async function apiCall(path, options = {}) {
+  const url = `${API_BASE}${path}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+      ...options.headers,
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`API error ${res.status}: ${text}`);
+  }
+  return res;
+}
+
+// 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.",
+  {},
+  async () => {
+    const res = await apiCall("/api/issues");
+    const data = await res.json();
+    const { issues, summary, lastRun } = data;
+
+    if (!issues || issues.length === 0) {
+      return {
+        content: [{
+          type: "text",
+          text: "No UX issues tracked yet. Run `generate_report` first to analyze your site and start tracking issues.",
+        }],
+      };
+    }
+
+    const lines = [];
+
+    // 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`);
+
+    // 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("");
+    }
+
+    // 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)}`);
+        }
+
+        // Context
+        const context = issue.extra?.context || issue.description;
+        if (context) lines.push(`  ${context}`);
+
+        if (issue.selector) lines.push(`  Selector: \`${issue.selector}\``);
+        lines.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 > 5) lines.push(`- ...and ${fixed.length - 5} more`);
+    }
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// 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.",
+  {},
+  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();
+
+    return {
+      content: [{ type: "text", text }],
+    };
+  }
+);
+
+// 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.",
+  {},
+  async () => {
+    // Step 1: Re-aggregate fresh data
+    await apiCall("/api/insights/aggregate", {
+      method: "POST",
+      body: JSON.stringify({}),
+    });
+
+    // Step 2: Re-generate export (this updates issue tracking)
+    await apiCall("/api/insights/export").then((r) => r.text());
+
+    // Step 3: Get updated issues with deltas
+    const issuesRes = await apiCall("/api/issues");
+    const { issues, summary, lastRun } = await issuesRes.json();
+
+    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 ✓`);
+      }
+      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}`);
+      }
+      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}`);
+      }
+      lines.push("");
+    }
+
+    if (fixed.length === 0 && improved.length === 0 && open.length === 0) {
+      lines.push("No issues tracked yet. Run `generate_report` first.");
+    }
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// 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.",
+  {},
+  async () => {
+    const res = await apiCall("/api/me");
+    const { site } = await res.json();
+
+    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}`);
+      }
+    }
+
+    if (!ctx.description) {
+      lines.push("No product context configured yet. Set it up at https://whyusersleave.vercel.app/dashboard");
+    }
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// Start server
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "whyusersleave",
+  "version": "1.0.0",
+  "description": "MCP server for WhyUsersLeave UX analytics — get UX issues, generate reports, and verify fixes directly in Claude Code",
+  "bin": {
+    "whyusersleave": "./index.js"
+  },
+  "type": "module",
+  "keywords": ["mcp", "claude", "ux", "analytics", "dead-clicks", "user-behavior"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  }
+}