@easyfunnel/mcp 0.1.8 → 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);
@@ -211,25 +219,25 @@ var frameworkConfigs = {
   nextjs: {
     envFile: ".env.local",
     envVarName: "NEXT_PUBLIC_EASYFUNNEL_KEY",
-    envAccessor: "process.env.NEXT_PUBLIC_EASYFUNNEL_KEY!",
+    envAccessor: (apiKey2) => `process.env.NEXT_PUBLIC_EASYFUNNEL_KEY || "${apiKey2}"`,
     layoutPaths: ["app/layout.tsx", "app/layout.jsx", "src/app/layout.tsx", "src/app/layout.jsx"]
   },
   vite: {
     envFile: ".env",
     envVarName: "VITE_EASYFUNNEL_KEY",
-    envAccessor: "import.meta.env.VITE_EASYFUNNEL_KEY",
+    envAccessor: (apiKey2) => `import.meta.env.VITE_EASYFUNNEL_KEY || "${apiKey2}"`,
     layoutPaths: ["src/App.tsx", "src/App.jsx", "src/main.tsx", "src/main.jsx"]
   },
   cra: {
     envFile: ".env",
     envVarName: "REACT_APP_EASYFUNNEL_KEY",
-    envAccessor: "process.env.REACT_APP_EASYFUNNEL_KEY!",
+    envAccessor: (apiKey2) => `process.env.REACT_APP_EASYFUNNEL_KEY || "${apiKey2}"`,
     layoutPaths: ["src/App.tsx", "src/App.jsx", "src/index.tsx", "src/index.jsx"]
   },
   sveltekit: {
     envFile: ".env",
     envVarName: "PUBLIC_EASYFUNNEL_KEY",
-    envAccessor: "import.meta.env.PUBLIC_EASYFUNNEL_KEY",
+    envAccessor: (apiKey2) => `import.meta.env.PUBLIC_EASYFUNNEL_KEY || "${apiKey2}"`,
     layoutPaths: ["src/routes/+layout.svelte"]
   }
 };
@@ -374,7 +382,7 @@ Next: After adding the script, I'll verify everything works with a test event.`
     if (content.includes("{children}")) {
       content = content.replace(
         /(\{children\})/,
-        `<EasyFunnelProvider apiKey={${config.envAccessor}}>
+        `<EasyFunnelProvider apiKey={${config.envAccessor(project_api_key)}}>
           $1
         </EasyFunnelProvider>`
       );
@@ -416,10 +424,12 @@ Project API Key: ${project_api_key}
   output += `(This is the PROJECT key for the SDK \u2014 not the account key used by the MCP server.)
 `;
   output += `
-IMPORTANT: Restart your dev server for the env var to take effect.
+The API key is hardcoded in your layout file \u2014 no env var configuration needed.
+`;
+  output += `If you prefer, you can override it via ${config.envVarName} in ${config.envFile}.
 `;
   output += `
-Next: After restarting, I'll verify everything works with a test event.`;
+Next: I'll verify everything works with a test event.`;
   return {
     content: [{ type: "text", text: output }]
   };
@@ -1636,18 +1646,18 @@ function readEnvFile(projectRoot) {
   }
   return null;
 }
+var layoutCandidates = [
+  "app/layout.tsx",
+  "app/layout.jsx",
+  "src/app/layout.tsx",
+  "src/app/layout.jsx",
+  "src/App.tsx",
+  "src/App.jsx",
+  "src/main.tsx",
+  "src/main.jsx"
+];
 function findProviderFile(projectRoot) {
-  const candidates = [
-    "app/layout.tsx",
-    "app/layout.jsx",
-    "src/app/layout.tsx",
-    "src/app/layout.jsx",
-    "src/App.tsx",
-    "src/App.jsx",
-    "src/main.tsx",
-    "src/main.jsx"
-  ];
-  for (const relPath of candidates) {
+  for (const relPath of layoutCandidates) {
     const fullPath = (0, import_path4.join)(projectRoot, relPath);
     if ((0, import_fs6.existsSync)(fullPath)) {
       const content = (0, import_fs6.readFileSync)(fullPath, "utf-8");
@@ -1658,37 +1668,50 @@ function findProviderFile(projectRoot) {
   }
   return null;
 }
+function findHardcodedKey(projectRoot) {
+  for (const relPath of layoutCandidates) {
+    const fullPath = (0, import_path4.join)(projectRoot, relPath);
+    if (!(0, import_fs6.existsSync)(fullPath)) continue;
+    const content = (0, import_fs6.readFileSync)(fullPath, "utf-8");
+    if (!content.includes("EasyFunnelProvider")) continue;
+    const match = content.match(/apiKey[=:].*?(ef_[a-f0-9]+)/);
+    if (match) {
+      return { file: relPath, key: match[1] };
+    }
+  }
+  return null;
+}
 async function validateSetup(client2, args) {
   const { project_root, project_id } = args;
   const checks = [];
   const envResult = readEnvFile(project_root);
+  const hardcodedResult = findHardcodedKey(project_root);
   let apiKey2 = args.project_api_key || "";
-  if (envResult) {
+  if (envResult && envResult.value && envResult.value.startsWith("ef_")) {
     apiKey2 = apiKey2 || envResult.value;
-    if (envResult.value && envResult.value.startsWith("ef_")) {
-      checks.push({
-        name: `${envResult.file} contains ${envResult.varName}`,
-        passed: true,
-        detail: `${envResult.varName}=${envResult.value.slice(0, 8)}...`
-      });
-    } else if (envResult.value) {
-      checks.push({
-        name: `${envResult.file} contains ${envResult.varName}`,
-        passed: false,
-        detail: `Value doesn't start with "ef_". Got: ${envResult.value.slice(0, 20)}`
-      });
-    } else {
-      checks.push({
-        name: `${envResult.file} contains ${envResult.varName}`,
-        passed: false,
-        detail: `${envResult.varName} is empty`
-      });
-    }
+    checks.push({
+      name: `${envResult.file} contains ${envResult.varName}`,
+      passed: true,
+      detail: `${envResult.varName}=${envResult.value.slice(0, 8)}...`
+    });
+  } else if (hardcodedResult) {
+    apiKey2 = apiKey2 || hardcodedResult.key;
+    checks.push({
+      name: `API key found in ${hardcodedResult.file}`,
+      passed: true,
+      detail: `Hardcoded key: ${hardcodedResult.key.slice(0, 8)}... (recommended for static deployments)`
+    });
+  } else if (envResult && envResult.value) {
+    checks.push({
+      name: `${envResult.file} contains ${envResult.varName}`,
+      passed: false,
+      detail: `Value doesn't start with "ef_". Got: ${envResult.value.slice(0, 20)}`
+    });
   } else {
     checks.push({
-      name: "Env file contains API key",
+      name: "API key configured",
       passed: false,
-      detail: "No EasyFunnel API key found in .env.local or .env"
+      detail: "No EasyFunnel API key found in env file or hardcoded in layout. Run setup_sdk to add it."
     });
   }
   const providerFile = findProviderFile(project_root);
@@ -1789,14 +1812,14 @@ Next: Let me suggest conversion funnels based on what I found in your codebase.`
     output += `
 `;
     for (const check of failedChecks) {
-      if (check.name.includes("Env file") || check.name.includes("API key")) {
-        const varName = envResult?.varName || "NEXT_PUBLIC_EASYFUNNEL_KEY";
-        const envFile = envResult?.file || ".env.local";
-        output += `To fix: Add your project API key to ${envFile}:
+      if (check.name.includes("API key") || check.name.includes("Env file")) {
+        output += `To fix: Run setup_sdk to hardcode the API key in your layout file.
 `;
-        output += `  ${varName}=ef_your_key_here
+        output += `Alternatively, add it to an env file:
 `;
-        output += `Then restart your dev server.
+        const varName = envResult?.varName || "NEXT_PUBLIC_EASYFUNNEL_KEY";
+        const envFile = envResult?.file || ".env.local";
+        output += `  ${varName}=ef_your_key_here  (in ${envFile})
 
 `;
       } else if (check.name.includes("Provider")) {
@@ -2102,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) {
@@ -2132,7 +2232,8 @@ server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({
     queryEventsDefinition,
     deleteFunnelDefinition,
     updateFunnelDefinition,
-    setupChatWidgetDefinition
+    setupChatWidgetDefinition,
+    queryConversationsDefinition
   ]
 }));
 server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
@@ -2168,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.8",
+  "version": "0.1.10",
   "description": "MCP server for easyfunnel.co — AI-powered analytics tools for Claude/Cursor",
   "main": "dist/index.js",
   "bin": {