@easyfunnel/mcp 0.1.9 → 0.1.10

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);
@@ -2117,6 +2125,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 +2232,8 @@ server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({
     queryEventsDefinition,
     deleteFunnelDefinition,
     updateFunnelDefinition,
-    setupChatWidgetDefinition
+    setupChatWidgetDefinition,
+    queryConversationsDefinition
   ]
 }));
 server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
@@ -2183,6 +2269,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.10",
   "description": "MCP server for easyfunnel.co — AI-powered analytics tools for Claude/Cursor",
   "main": "dist/index.js",
   "bin": {