@easyfunnel/mcp 0.1.7 → 0.1.9

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,32 +204,32 @@ var setupSdkDefinition = {
         description: "The framework used in the project"
       }
     },
-    required: ["project_api_key", "project_root", "framework"]
+    required: ["project_root", "framework"]
   }
 };
 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"]
   }
 };
@@ -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);
@@ -286,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`);
     }
@@ -321,7 +374,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>`
       );
@@ -356,10 +409,19 @@ Files modified:
     }
   }
   output += `
-IMPORTANT: Restart your dev server for the env var to take effect.
+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 += `
-Next: After restarting, I'll verify everything works with a test event.`;
+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: I'll verify everything works with a test event.`;
   return {
     content: [{ type: "text", text: output }]
   };
@@ -1576,18 +1638,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");
@@ -1598,37 +1660,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);
@@ -1729,14 +1804,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")) {
@@ -2085,7 +2160,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.7",
+  "version": "0.1.9",
   "description": "MCP server for easyfunnel.co — AI-powered analytics tools for Claude/Cursor",
   "main": "dist/index.js",
   "bin": {