@easyfunnel/mcp 0.1.6 → 0.1.8

package/dist/index.js

@@ -119,7 +119,26 @@ var listProjectsDefinition = {
 };
 async function listProjects(client2) {
   const projects = await client2.listProjects();
-  return { content: [{ type: "text", text: JSON.stringify(projects, null, 2) }] };
+  let output = "";
+  if (Array.isArray(projects) && projects.length > 0) {
+    for (const p of projects) {
+      output += `Project: ${p.name}
+`;
+      output += `  ID:              ${p.id}
+`;
+      output += `  Project API Key: ${p.api_key}  (use this in the SDK / env var)
+`;
+      output += `  Domains:         ${p.domain_whitelist?.length ? p.domain_whitelist.join(", ") : "(all allowed)"}
+
+`;
+    }
+    output += `NOTE: The "Project API Key" (ef_...) goes in your app's env var for the SDK.
+`;
+    output += `The "Account API Key" (efa_...) is only for the MCP server \u2014 never put it in your app code.`;
+  } else {
+    output = "No projects found. Use create_project to create one.";
+  }
+  return { content: [{ type: "text", text: output }] };
 }
 
 // src/tools/create-project.ts
@@ -163,13 +182,17 @@ var import_path = require("path");
 var import_child_process = require("child_process");
 var setupSdkDefinition = {
   name: "setup_sdk",
-  description: "Install the EasyFunnel SDK, write the env var, and wrap the app with the provider. Supports Next.js, Vite, CRA, SvelteKit, and plain HTML.",
+  description: "Install the EasyFunnel SDK, write the env var, and wrap the app with the provider. Supports Next.js, Vite, CRA, SvelteKit, and plain HTML. Provide either project_id (recommended) or project_api_key.",
   inputSchema: {
     type: "object",
     properties: {
+      project_id: {
+        type: "string",
+        description: "The project ID (UUID). The tool will look up the correct project API key (ef_...) automatically. Preferred over project_api_key."
+      },
       project_api_key: {
         type: "string",
-        description: "The project API key (ef_...)"
+        description: "The project API key (ef_...). Use project_id instead if possible \u2014 this avoids accidentally passing the wrong key."
       },
       project_root: {
         type: "string",
@@ -181,7 +204,7 @@ var setupSdkDefinition = {
         description: "The framework used in the project"
       }
     },
-    required: ["project_api_key", "project_root", "framework"]
+    required: ["project_root", "framework"]
   }
 };
 var frameworkConfigs = {
@@ -216,20 +239,48 @@ function detectPackageManager(projectRoot) {
   if ((0, import_fs.existsSync)((0, import_path.join)(projectRoot, "yarn.lock"))) return "yarn";
   return "npm";
 }
-async function setupSdk(args) {
-  const { project_api_key, project_root, framework } = args;
-  if (!project_api_key?.startsWith("ef_")) {
-    return {
-      content: [
-        {
+async function setupSdk(client2, args) {
+  const { project_root, framework } = args;
+  let project_api_key = args.project_api_key || "";
+  if (args.project_id && !project_api_key) {
+    try {
+      const projects = await client2.listProjects();
+      const project = projects.find((p) => p.id === args.project_id);
+      if (project?.api_key) {
+        project_api_key = project.api_key;
+      } else {
+        return {
+          content: [{
+            type: "text",
+            text: `Error: Project ID "${args.project_id}" not found. Run list_projects to see your projects.`
+          }]
+        };
+      }
+    } catch (err) {
+      return {
+        content: [{
           type: "text",
-          text: `Error: Invalid API key format. Project keys start with "ef_". Got: "${project_api_key || "(empty)"}"
+          text: `Error: Could not look up project: ${err.message}`
+        }]
+      };
+    }
+  }
+  if (!project_api_key?.startsWith("ef_")) {
+    const hint = project_api_key?.startsWith("efa_") ? `
 
-Account keys ("efa_") are for the MCP server, not the SDK. Use list_projects to find your project API key.`
-        }
-      ]
+You passed an account API key (efa_...). That key is for the MCP server, not the SDK.
+Use project_id instead, or run list_projects to find the correct project API key (ef_...).` : `
+
+Use project_id instead of project_api_key \u2014 the tool will look up the correct key automatically.`;
+    return {
+      content: [{
+        type: "text",
+        text: `Error: Invalid API key format. Project keys start with "ef_". Got: "${project_api_key || "(empty)"}"
+${hint}`
+      }]
     };
   }
+  const config = framework !== "html" ? frameworkConfigs[framework] : null;
   if (framework === "html") {
     return {
       content: [
@@ -241,6 +292,9 @@ Add this script tag to your <head>:
 
   <script defer data-api-key="${project_api_key}" src="https://easyfunnel.co/sdk.js"></script>
 
+Project API Key: ${project_api_key}
+(This is the PROJECT key for the SDK \u2014 not the account key used by the MCP server.)
+
 This will automatically track page views and clicks on elements with data-ef-track attributes.
 
 Next: After adding the script, I'll verify everything works with a test event.`
@@ -248,7 +302,6 @@ Next: After adding the script, I'll verify everything works with a test event.`
       ]
     };
   }
-  const config = frameworkConfigs[framework];
   const steps = [];
   const filesModified = [];
   const pm = detectPackageManager(project_root);
@@ -268,8 +321,16 @@ Next: After adding the script, I'll verify everything works with a test event.`
     if (!content.includes(config.envVarName)) {
       (0, import_fs.writeFileSync)(envPath, content.trimEnd() + "\n" + envLine + "\n");
       envWritten = true;
+    } else if (!content.includes(envLine)) {
+      const updated = content.replace(
+        new RegExp(`^${config.envVarName}=.*$`, "m"),
+        envLine
+      );
+      (0, import_fs.writeFileSync)(envPath, updated);
+      envWritten = true;
+      steps.push(`[done] Updated ${config.envVarName} to new API key in ${config.envFile}`);
     } else {
-      steps.push(`[skip] ${config.envVarName} already exists in ${config.envFile}`);
+      steps.push(`[skip] ${config.envVarName} already set correctly in ${config.envFile}`);
     }
   } else {
     (0, import_fs.writeFileSync)(envPath, envLine + "\n");
@@ -278,8 +339,8 @@ Next: After adding the script, I'll verify everything works with a test event.`
   if (envWritten) {
     const verifyContent = (0, import_fs.readFileSync)(envPath, "utf-8");
     if (verifyContent.includes(project_api_key)) {
-      steps.push(`[done] Added ${config.envVarName}=${project_api_key.slice(0, 8)}... to ${config.envFile}`);
-      filesModified.push({ file: config.envFile, action: "Added API key" });
+      steps.push(`[done] Set ${config.envVarName}=${project_api_key} in ${config.envFile}`);
+      filesModified.push({ file: config.envFile, action: "Set project API key" });
     } else {
       steps.push(`[FAIL] Wrote to ${config.envFile} but verification failed`);
     }
@@ -348,6 +409,13 @@ Files modified:
     }
   }
   output += `
+Project API Key: ${project_api_key}
+`;
+  output += `Env var: ${config.envVarName}=${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.
 `;
   output += `
@@ -2077,7 +2145,7 @@ server.setRequestHandler(import_types.CallToolRequestSchema, async (request) =>
     case "scan_codebase":
       return scanCodebase(client, args);
     case "setup_sdk":
-      return setupSdk(args);
+      return setupSdk(client, args);
     case "validate_setup":
       return validateSetup(client, args);
     case "recommend_funnels":

package/package.json

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