@easyfunnel/mcp 0.1.9 → 0.1.11

package/dist/index.js

@@ -94,6 +94,14 @@ var ApiClient = class {
       body: JSON.stringify(config)
     });
   }
+  async getConversations(projectId, params) {
+    const searchParams = new URLSearchParams();
+    if (params.limit) searchParams.set("limit", params.limit.toString());
+    if (params.session_id) searchParams.set("session_id", params.session_id);
+    return this.request(
+      `/projects/${projectId}/conversations?${searchParams.toString()}`
+    );
+  }
   async queryEvents(projectId, params) {
     const searchParams = new URLSearchParams();
     searchParams.set("query_type", params.query_type);
@@ -824,8 +832,8 @@ var queryEventsDefinition = {
       project_id: { type: "string", description: "Project ID" },
       query_type: {
         type: "string",
-        enum: ["count", "recent", "breakdown", "section_engagement", "traffic_sources"],
-        description: "Type of query"
+        enum: ["count", "recent", "breakdown", "section_engagement", "traffic_sources", "engagement"],
+        description: 'Type of query. Use "engagement" to get scroll depth and engaged time metrics.'
       },
       event_name: {
         type: "string",
@@ -863,7 +871,9 @@ async function queryEvents(client2, args) {
 `;
     output += `  Unique sessions: ${data.unique_sessions}
 `;
-    output += `  Unique users: ${data.unique_users}
+    output += `  Unique visitors: ${data.unique_visitors}
+`;
+    output += `  Identified users: ${data.identified_users}
 `;
   } else if (args.query_type === "recent") {
     output = `Recent events:
@@ -873,8 +883,43 @@ async function queryEvents(client2, args) {
       output += `  [${event.created_at}] ${event.event_name}`;
       if (event.properties?.url) output += ` \u2014 ${event.properties.url}`;
       output += "\n";
+      if (event.properties) {
+        const props = { ...event.properties };
+        delete props.url;
+        const keys = Object.keys(props);
+        if (keys.length > 0) {
+          output += `    properties: ${JSON.stringify(props)}
+`;
+        }
+      }
     }
     if (!data.events?.length) output += "  No events found.\n";
+  } else if (args.query_type === "engagement") {
+    output = `Engagement metrics (${args.time_range || "7d"}):
+
+`;
+    output += `  Avg scroll depth: ${data.avg_scroll_depth}%
+`;
+    output += `  Avg engaged time: ${data.avg_engaged_time}s
+`;
+    output += `  Total engagement events: ${data.total_events}
+
+`;
+    output += `  Scroll depth distribution:
+`;
+    for (const bucket of data.scroll_depth_distribution || []) {
+      output += `    ${bucket.bucket}: ${bucket.count} events
+`;
+    }
+    if (data.top_pages?.length) {
+      output += `
+  Top pages by scroll depth:
+`;
+      for (const page of data.top_pages) {
+        output += `    ${page.url}: ${page.avg_scroll_depth}% avg, ${page.count} events
+`;
+      }
+    }
   } else if (args.query_type === "section_engagement") {
     output = `Section engagement (${args.time_range || "7d"}):
 
@@ -2117,6 +2162,83 @@ The chat widget will appear as a floating bubble in the bottom-right corner of y
   };
 }
 
+// src/tools/query-conversations.ts
+var queryConversationsDefinition = {
+  name: "query_conversations",
+  description: "Read chat widget conversations from visitors. Lists recent conversations with previews, or fetches full message transcript for a specific session.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      project_id: { type: "string", description: "Project ID" },
+      session_id: {
+        type: "string",
+        description: "Specific chat session ID to fetch full transcript. If omitted, lists recent conversations."
+      },
+      limit: {
+        type: "number",
+        description: "Max conversations to return (default: 20, max: 50)"
+      }
+    },
+    required: ["project_id"]
+  }
+};
+async function queryConversations(client2, args) {
+  const data = await client2.getConversations(args.project_id, {
+    limit: args.limit,
+    session_id: args.session_id
+  });
+  let output;
+  if (args.session_id) {
+    const s = data.session;
+    output = `Conversation with ${s.user_email || "Anonymous (" + s.visitor_id.slice(0, 8) + ")"}
+`;
+    output += `Country: ${s.country || "unknown"} | Device: ${s.device || "unknown"} | Browser: ${s.browser || "unknown"}
+`;
+    output += `First page: ${s.first_page || "unknown"}
+`;
+    output += `Started: ${s.created_at}
+`;
+    output += `\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+`;
+    for (const msg of data.messages || []) {
+      const label = msg.role === "user" ? "\u{1F464} Visitor" : "\u{1F916} Assistant";
+      output += `${label}:
+${msg.content}
+`;
+      if (msg.page_url) output += `  [on ${msg.page_url}]
+`;
+      output += "\n";
+    }
+    if (!data.messages?.length) output += "No messages in this conversation.\n";
+  } else {
+    const sessions = data.sessions || [];
+    output = `Chat conversations (${sessions.length} total):
+
+`;
+    for (const s of sessions) {
+      const visitor = s.user_email || `Anonymous (${s.visitor_id.slice(0, 8)})`;
+      const country = s.country || "??";
+      const device = s.device || "?";
+      output += `\u2022 ${visitor} \u2014 ${country}, ${device}, ${s.message_count} msgs
+`;
+      output += `  ID: ${s.id}
+`;
+      if (s.preview) output += `  "${s.preview}"
+`;
+      output += `  First page: ${s.first_page || "?"} | Last active: ${s.last_message_at}
+
+`;
+    }
+    if (sessions.length === 0) {
+      output += "No conversations yet.\n";
+    }
+  }
+  return {
+    content: [{ type: "text", text: output }]
+  };
+}
+
 // src/index.ts
 var apiKey = process.env.EASYFUNNEL_API_KEY;
 if (!apiKey) {
@@ -2147,7 +2269,8 @@ server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({
     queryEventsDefinition,
     deleteFunnelDefinition,
     updateFunnelDefinition,
-    setupChatWidgetDefinition
+    setupChatWidgetDefinition,
+    queryConversationsDefinition
   ]
 }));
 server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
@@ -2183,6 +2306,8 @@ server.setRequestHandler(import_types.CallToolRequestSchema, async (request) =>
       return updateFunnel(client, args);
     case "setup_chat_widget":
       return setupChatWidget(client, args);
+    case "query_conversations":
+      return queryConversations(client, args);
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyfunnel/mcp",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "MCP server for easyfunnel.co — AI-powered analytics tools for Claude/Cursor",
   "main": "dist/index.js",
   "bin": {