@curenorway/kode-mcp 1.0.2 → 1.2.0

package/dist/index.js

@@ -70,6 +70,17 @@ var KodeApiClient = class {
   async listPages(siteId) {
     return this.request(`/api/cdn/sites/${siteId}/pages`);
   }
+  async assignScriptToPage(pageId, scriptId, loadOrderOverride) {
+    await this.request(`/api/cdn/pages/${pageId}/scripts`, {
+      method: "POST",
+      body: JSON.stringify({ scriptId, loadOrderOverride })
+    });
+  }
+  async removeScriptFromPage(pageId, scriptId) {
+    await this.request(`/api/cdn/pages/${pageId}/scripts/${scriptId}`, {
+      method: "DELETE"
+    });
+  }
   // Deployment operations
   async deploy(siteId, options = {}) {
     return this.request("/api/cdn/deploy", {
@@ -241,13 +252,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_get_script",
-        description: "Get the full content of a specific script by its slug (filename without extension) or ID.",
+        description: "Get a script by its slug or ID. By default returns full content. Use includeContent:false to get just metadata (saves context tokens for large scripts).",
         inputSchema: {
           type: "object",
           properties: {
             slug: {
               type: "string",
               description: 'Script slug (e.g., "init", "tracking") or script ID (UUID)'
+            },
+            includeContent: {
+              type: "boolean",
+              description: "Include full script content. Default: true. Set to false to get just metadata (name, type, scope, version, size) - useful for large scripts."
+            },
+            contentPreview: {
+              type: "number",
+              description: "If set, include only the first N characters of content. Useful for previewing large scripts without loading everything."
             }
           },
           required: ["slug"]
@@ -255,7 +274,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_create_script",
-        description: "Create a new script on the Cure Kode CDN. The script will be available at the CDN URL after deployment.",
+        description: "Create a new script on the Cure Kode CDN. The script will be available at the CDN URL after deployment. Global scripts auto-load by default; page-specific scripts do not.",
         inputSchema: {
           type: "object",
           properties: {
@@ -276,6 +295,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: "string",
               enum: ["global", "page-specific"],
               description: 'Script scope - "global" loads on all pages, "page-specific" only on assigned pages. Default: global'
+            },
+            autoLoad: {
+              type: "boolean",
+              description: "Whether to auto-load the script. Default: true for global scripts, false for page-specific. Set to false for scripts you want to load manually via CK.loadScript()."
             }
           },
           required: ["name", "type", "content"]
@@ -283,7 +306,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_update_script",
-        description: "Update an existing script's content. This creates a new version of the script.",
+        description: "Update an existing script's content or settings. This creates a new version of the script when content changes.",
         inputSchema: {
           type: "object",
           properties: {
@@ -295,12 +318,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: "string",
               description: "New script content"
             },
+            autoLoad: {
+              type: "boolean",
+              description: "Whether to auto-load the script. Set to true to load automatically, false for manual loading via CK.loadScript()."
+            },
+            scope: {
+              type: "string",
+              enum: ["global", "page-specific"],
+              description: "Change script scope. Note: changing to page-specific requires assigning to pages."
+            },
             changeSummary: {
               type: "string",
               description: "Brief description of the changes (for version history)"
             }
           },
-          required: ["slug", "content"]
+          required: ["slug"]
         }
       },
       {
@@ -377,6 +409,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         }
       },
+      {
+        name: "kode_assign_script_to_page",
+        description: "Assign a page-specific script to a page. Required for page-specific scripts to load on their target pages.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            scriptSlug: {
+              type: "string",
+              description: "Script slug or ID to assign"
+            },
+            pageSlug: {
+              type: "string",
+              description: "Page slug or ID to assign the script to"
+            },
+            loadOrderOverride: {
+              type: "number",
+              description: "Optional load order for this page (overrides script default)"
+            }
+          },
+          required: ["scriptSlug", "pageSlug"]
+        }
+      },
+      {
+        name: "kode_remove_script_from_page",
+        description: "Remove a script from a page assignment.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            scriptSlug: {
+              type: "string",
+              description: "Script slug or ID to remove"
+            },
+            pageSlug: {
+              type: "string",
+              description: "Page slug or ID to remove the script from"
+            }
+          },
+          required: ["scriptSlug", "pageSlug"]
+        }
+      },
       {
         name: "kode_site_info",
         description: "Get information about the current Cure Kode site including domains and CDN URLs.",
@@ -533,7 +605,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
       case "kode_get_script": {
-        const { slug } = args;
+        const { slug, includeContent = true, contentPreview } = args;
         const scripts = await client.listScripts(siteId);
         const script = scripts.find((s) => s.slug === slug || s.id === slug);
         if (!script) {
@@ -542,6 +614,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             isError: true
           };
         }
+        const contentLength = script.content?.length || 0;
+        const estimatedTokens = Math.ceil(contentLength / 4);
+        if (!includeContent && !contentPreview) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Script: ${script.name}
+Slug: ${script.slug}
+Type: ${script.type}
+Scope: ${script.scope}
+Version: ${script.current_version}
+Auto-load: ${script.auto_load ? "yes" : "no"}
+Size: ${contentLength} chars (~${estimatedTokens} tokens)
+
+Use includeContent:true or contentPreview:N to fetch content.`
+              }
+            ]
+          };
+        }
+        if (contentPreview && contentPreview > 0) {
+          const preview = script.content?.slice(0, contentPreview) || "";
+          const isTruncated = contentLength > contentPreview;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `// Script: ${script.name} (${script.type})
+// Version: ${script.current_version}
+// Scope: ${script.scope}
+// Size: ${contentLength} chars (~${estimatedTokens} tokens)${isTruncated ? `
+// Showing first ${contentPreview} chars` : ""}
+
+${preview}${isTruncated ? "\n\n// ... (truncated) - use includeContent:true for full content" : ""}`
+              }
+            ]
+          };
+        }
         return {
           content: [
             {
@@ -549,6 +659,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               text: `// Script: ${script.name} (${script.type})
 // Version: ${script.current_version}
 // Scope: ${script.scope}
+// Size: ${contentLength} chars (~${estimatedTokens} tokens)
 
 ${script.content}`
             }
@@ -556,20 +667,26 @@ ${script.content}`
         };
       }
       case "kode_create_script": {
-        const { name: scriptName, type, content, scope } = args;
+        const { name: scriptName, type, content, scope, autoLoad } = args;
+        const scriptScope = scope || "global";
         const script = await client.createScript(siteId, {
           name: scriptName,
           slug: scriptName,
           type,
           content,
-          scope: scope || "global"
+          scope: scriptScope,
+          autoLoad
+          // Let API handle default based on scope
         });
+        const autoLoadStatus = script.auto_load ? "will auto-load" : "manual load only (use CK.loadScript())";
         return {
           content: [
             {
               type: "text",
               text: `Created script "${script.name}" (${script.type})
 Slug: ${script.slug}
+Scope: ${script.scope}
+Auto-load: ${autoLoadStatus}
 Version: ${script.current_version}
 
 Note: Run kode_deploy to make it live.`
@@ -578,7 +695,7 @@ Note: Run kode_deploy to make it live.`
         };
       }
       case "kode_update_script": {
-        const { slug, content, changeSummary } = args;
+        const { slug, content, autoLoad, scope, changeSummary } = args;
         const scripts = await client.listScripts(siteId);
         const script = scripts.find((s) => s.slug === slug || s.id === slug);
         if (!script) {
@@ -587,16 +704,22 @@ Note: Run kode_deploy to make it live.`
             isError: true
           };
         }
-        const updated = await client.updateScript(script.id, {
-          content,
-          changeSummary: changeSummary || "Updated via MCP"
-        });
+        const updateData = {};
+        if (content !== void 0) updateData.content = content;
+        if (autoLoad !== void 0) updateData.autoLoad = autoLoad;
+        if (scope !== void 0) updateData.scope = scope;
+        updateData.changeSummary = changeSummary || "Updated via MCP";
+        const updated = await client.updateScript(script.id, updateData);
+        const changes = [];
+        if (content !== void 0) changes.push(`content \u2192 v${updated.current_version}`);
+        if (autoLoad !== void 0) changes.push(`auto_load \u2192 ${autoLoad}`);
+        if (scope !== void 0) changes.push(`scope \u2192 ${scope}`);
         return {
           content: [
             {
               type: "text",
               text: `Updated script "${updated.name}"
-New version: ${updated.current_version}
+Changes: ${changes.join(", ")}
 
 Note: Run kode_deploy to make changes live.`
             }
@@ -764,6 +887,83 @@ Webflow Components:
           ]
         };
       }
+      case "kode_assign_script_to_page": {
+        const { scriptSlug, pageSlug, loadOrderOverride } = args;
+        const scripts = await client.listScripts(siteId);
+        const script = scripts.find((s) => s.slug === scriptSlug || s.id === scriptSlug);
+        if (!script) {
+          return {
+            content: [{ type: "text", text: `Script "${scriptSlug}" not found` }],
+            isError: true
+          };
+        }
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          await client.assignScriptToPage(page.id, script.id, loadOrderOverride);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Assigned script "${script.name}" to page "${page.name}"
+URL patterns: ${page.url_patterns.join(", ")}
+
+Note: Run kode_deploy to make changes live.`
+              }
+            ]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to assign script: ${message}` }],
+            isError: true
+          };
+        }
+      }
+      case "kode_remove_script_from_page": {
+        const { scriptSlug, pageSlug } = args;
+        const scripts = await client.listScripts(siteId);
+        const script = scripts.find((s) => s.slug === scriptSlug || s.id === scriptSlug);
+        if (!script) {
+          return {
+            content: [{ type: "text", text: `Script "${scriptSlug}" not found` }],
+            isError: true
+          };
+        }
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          await client.removeScriptFromPage(page.id, script.id);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Removed script "${script.name}" from page "${page.name}"
+
+Note: Run kode_deploy to make changes live.`
+              }
+            ]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to remove script: ${message}` }],
+            isError: true
+          };
+        }
+      }
       case "kode_site_info": {
         const config = getConfig();
         if (!config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-mcp",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "MCP server for Cure Kode - enables AI agents to manage Webflow scripts",
   "type": "module",
   "bin": {