zola-mcp 1.1.0 → 1.1.2

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Zola wedding planning tools for Claude Code",
-    "version": "1.1.0"
+    "version": "1.1.2"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Zola",
       "source": "./",
       "description": "Zola wedding planning tools for Claude — vendors, budget, guests, seating, events, registry, inquiries, and more via MCP",
-      "version": "1.1.0",
+      "version": "1.1.2",
       "author": {
         "name": "Chris Chall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "zola",
   "displayName": "Zola",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zola wedding planning tools for Claude — vendors, budget, guests, seating, events, registry, inquiries, and more via MCP",
   "author": {
     "name": "Chris Chall",

package/dist/bundle.js

@@ -31562,11 +31562,48 @@ async function updateCurrentTheme(args) {
   );
   return jsonResult(response.data);
 }
+var ALLOWED_BODY_FONT_FAMILY_IDS = [68, 198];
+var WEB_API_ONLY_FIELDS = ["header_color", "nav_font_color"];
 async function updateWebsiteCustomization(args) {
+  for (const field of WEB_API_ONLY_FIELDS) {
+    if (args[field] !== void 0) {
+      throw new Error(
+        `${field} is not writable via the mobile-api endpoint this MCP uses. The Zola web UI sets it via POST www.zola.com/web-api/v1/websiteCustomization/update (cookie + CSRF auth), which this MCP does not yet support. For now, change it in the Zola web UI under Website > Design.`
+      );
+    }
+  }
+  if (args.body_font_family_id !== void 0 && !ALLOWED_BODY_FONT_FAMILY_IDS.includes(args.body_font_family_id)) {
+    throw new Error(
+      `body_font_family_id must be one of [${ALLOWED_BODY_FONT_FAMILY_IDS.join(
+        ", "
+      )}] (68=Libre Baskerville, 198=Circular). The header font catalog does not apply to the body font.`
+    );
+  }
+  let preserved;
+  if (args.header_font_family_id !== void 0) {
+    const current = await client.requestMobile(
+      "GET",
+      "/v3/websites/website-customizations/context"
+    );
+    preserved = current.data.current_style_customizations;
+  }
   const body = {};
+  if (preserved) {
+    if (preserved.accent_color != null) body.accent_color = preserved.accent_color;
+    if (preserved.background_color != null) body.background_color = preserved.background_color;
+    if (preserved.body?.color != null) body.body_font = { color: preserved.body.color };
+    if (preserved.navigation_customization?.background_color != null) {
+      body.navigation_customization = {
+        background_color: preserved.navigation_customization.background_color
+      };
+    }
+  }
   if (args.accent_color !== void 0) body.accent_color = args.accent_color;
   if (args.background_color !== void 0) body.background_color = args.background_color;
-  if (args.body_font_color !== void 0) body.body_font = { color: args.body_font_color };
+  if (args.body_font_color !== void 0) {
+    const existing = body.body_font ?? {};
+    body.body_font = { ...existing, color: args.body_font_color };
+  }
   if (args.navigation_background_color !== void 0) {
     body.navigation_customization = { background_color: args.navigation_background_color };
   }
@@ -31611,14 +31648,16 @@ function registerWebsiteThemeTools(server2) {
     annotations: { destructiveHint: false }
   }, updateCurrentTheme);
   server2.registerTool("update_website_customization", {
-    description: "Update website colors and fonts. Provide only what changes \u2014 accepts a partial update. Colors are 6-char hex without #.",
+    description: "Update website colors and fonts. Provide only what changes. Colors are 6-char hex without #. Note: when header_font_family_id changes, the wrapper auto-fetches current state and re-sends all active colors to defend against a Zola partial-update wipe bug. body_font_family_id is restricted to [68, 198]. header_color and nav_font_color exist on Zola's web-api endpoint but are NOT writable via the mobile-api this MCP uses \u2014 change them in the Zola web UI for now.",
     inputSchema: {
       accent_color: external_exports3.string().optional().describe("6-char hex (no #)"),
       background_color: external_exports3.string().optional(),
       body_font_color: external_exports3.string().optional(),
       navigation_background_color: external_exports3.string().optional(),
       header_font_family_id: external_exports3.number().optional().describe("Font family ID \u2014 call get_website_customizations to see available font_family_ids"),
-      body_font_family_id: external_exports3.number().optional()
+      body_font_family_id: external_exports3.number().optional().describe("Restricted to 68 (Libre Baskerville) or 198 (Circular). Other IDs return a generic API error."),
+      header_color: external_exports3.string().optional().describe("Writable only via Zola's web-api (cookie+CSRF), not the mobile-api this MCP uses. Passing this throws."),
+      nav_font_color: external_exports3.string().optional().describe("Writable only via Zola's web-api (cookie+CSRF), not the mobile-api this MCP uses. Passing this throws.")
     },
     annotations: { destructiveHint: false }
   }, updateWebsiteCustomization);
@@ -31752,7 +31791,7 @@ function registerRegistryItemTools(server2) {
 // src/index.ts
 var server = new McpServer({
   name: "zola-mcp",
-  version: "1.1.0"
+  version: "1.1.2"
 });
 registerVendorTools(server);
 registerBudgetTools(server);

package/dist/index.js

@@ -13,7 +13,7 @@ import { registerWebsiteThemeTools } from './tools/website-theme.js';
 import { registerRegistryItemTools } from './tools/registry-items.js';
 const server = new McpServer({
     name: 'zola-mcp',
-    version: '1.1.0',
+    version: '1.1.2',
 });
 registerVendorTools(server);
 registerBudgetTools(server);

package/dist/tools/website-theme.js

@@ -26,14 +26,57 @@ export async function updateCurrentTheme(args) {
     const response = await client.requestMobile('PUT', '/v3/themes/current', body);
     return jsonResult(response.data);
 }
+// Only these two font_family_id values work for the body font; sending any other
+// (even ones valid for the header) yields a generic "tool execution failed" error.
+// See docs/zola-api-quirks.md for the empirical evidence.
+const ALLOWED_BODY_FONT_FAMILY_IDS = [68, 198];
+// These fields exist on the web-api endpoint (POST www.zola.com/web-api/v1/
+// websiteCustomization/update) but NOT on the mobile-api endpoint this MCP
+// currently uses. Until web-api support is added, callers passing these get a
+// clear pointer at the only paths that work today.
+const WEB_API_ONLY_FIELDS = ['header_color', 'nav_font_color'];
 export async function updateWebsiteCustomization(args) {
+    for (const field of WEB_API_ONLY_FIELDS) {
+        if (args[field] !== undefined) {
+            throw new Error(`${field} is not writable via the mobile-api endpoint this MCP uses. ` +
+                `The Zola web UI sets it via POST www.zola.com/web-api/v1/websiteCustomization/update ` +
+                `(cookie + CSRF auth), which this MCP does not yet support. ` +
+                `For now, change it in the Zola web UI under Website > Design.`);
+        }
+    }
+    if (args.body_font_family_id !== undefined &&
+        !ALLOWED_BODY_FONT_FAMILY_IDS.includes(args.body_font_family_id)) {
+        throw new Error(`body_font_family_id must be one of [${ALLOWED_BODY_FONT_FAMILY_IDS.join(', ')}] (68=Libre Baskerville, 198=Circular). The header font catalog does not apply to the body font.`);
+    }
+    // Partial-update wipe defence: when header_font_family_id changes the server
+    // resets every other active customization to null unless we resend them.
+    let preserved;
+    if (args.header_font_family_id !== undefined) {
+        const current = await client.requestMobile('GET', '/v3/websites/website-customizations/context');
+        preserved = current.data.current_style_customizations;
+    }
     const body = {};
+    if (preserved) {
+        if (preserved.accent_color != null)
+            body.accent_color = preserved.accent_color;
+        if (preserved.background_color != null)
+            body.background_color = preserved.background_color;
+        if (preserved.body?.color != null)
+            body.body_font = { color: preserved.body.color };
+        if (preserved.navigation_customization?.background_color != null) {
+            body.navigation_customization = {
+                background_color: preserved.navigation_customization.background_color,
+            };
+        }
+    }
     if (args.accent_color !== undefined)
         body.accent_color = args.accent_color;
     if (args.background_color !== undefined)
         body.background_color = args.background_color;
-    if (args.body_font_color !== undefined)
-        body.body_font = { color: args.body_font_color };
+    if (args.body_font_color !== undefined) {
+        const existing = body.body_font ?? {};
+        body.body_font = { ...existing, color: args.body_font_color };
+    }
     if (args.navigation_background_color !== undefined) {
         body.navigation_customization = { background_color: args.navigation_background_color };
     }
@@ -74,14 +117,20 @@ export function registerWebsiteThemeTools(server) {
         annotations: { destructiveHint: false },
     }, updateCurrentTheme);
     server.registerTool('update_website_customization', {
-        description: 'Update website colors and fonts. Provide only what changes — accepts a partial update. Colors are 6-char hex without #.',
+        description: 'Update website colors and fonts. Provide only what changes. Colors are 6-char hex without #. ' +
+            'Note: when header_font_family_id changes, the wrapper auto-fetches current state and re-sends all active colors ' +
+            'to defend against a Zola partial-update wipe bug. body_font_family_id is restricted to [68, 198]. ' +
+            'header_color and nav_font_color exist on Zola\'s web-api endpoint but are NOT writable via the mobile-api ' +
+            'this MCP uses — change them in the Zola web UI for now.',
         inputSchema: {
             accent_color: z.string().optional().describe('6-char hex (no #)'),
             background_color: z.string().optional(),
             body_font_color: z.string().optional(),
             navigation_background_color: z.string().optional(),
             header_font_family_id: z.number().optional().describe('Font family ID — call get_website_customizations to see available font_family_ids'),
-            body_font_family_id: z.number().optional(),
+            body_font_family_id: z.number().optional().describe('Restricted to 68 (Libre Baskerville) or 198 (Circular). Other IDs return a generic API error.'),
+            header_color: z.string().optional().describe('Writable only via Zola\'s web-api (cookie+CSRF), not the mobile-api this MCP uses. Passing this throws.'),
+            nav_font_color: z.string().optional().describe('Writable only via Zola\'s web-api (cookie+CSRF), not the mobile-api this MCP uses. Passing this throws.'),
         },
         annotations: { destructiveHint: false },
     }, updateWebsiteCustomization);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zola-mcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "mcpName": "io.github.chrischall/zola-mcp",
   "description": "Zola wedding MCP server for Claude",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/zola-mcp",
     "source": "github"
   },
-  "version": "1.1.0",
+  "version": "1.1.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "zola-mcp",
-      "version": "1.1.0",
+      "version": "1.1.2",
       "transport": {
         "type": "stdio"
       },