@diviops/mcp-server 0.2.9 → 0.2.11

package/README.md

@@ -141,7 +141,7 @@ The server connects via standard WordPress REST API and works with any environme
 | `diviops_save_to_library` | Save block markup to Divi Library |
 | `diviops_update_tb_layout` | Update a Theme Builder layout's block markup |
 | `diviops_create_tb_template` | Create Theme Builder template with header/footer and conditions |
-| `diviops_create_variable` | Create a design token variable. For `type=numbers` fluid tokens, pass `min`+`max` shorthand (anchors default to 320px/1920px) or explicit `targets` like `{"320px":"20px","1920px":"60px"}` — server generates arithmetically-correct `clamp()` instead of hand-written math that silently under-reaches the stated max. Px inputs only in this MVP; rem inputs should be converted to px (1rem=16px) before calling |
+| `diviops_create_variable` | Create a design token variable. For `type=numbers` fluid tokens, pass `min`+`max` shorthand (anchors default to 320px/1920px) or explicit `targets` like `{"320px":"20px","1920px":"60px"}` — server generates arithmetically-correct `clamp()` instead of hand-written math that silently under-reaches the stated max. All-px inputs emit px (root-agnostic). Rem inputs OR rem output require explicit opt-in: pass `output_unit="rem"` (accepts the 1rem=16px default) or `root_font_size_px:N` (declares your site's actual root font-size, e.g. `10` for `html { font-size: 62.5% }`, `20` for `html { font-size: 20px }`) |
 | `diviops_delete_variable` | Delete a variable by ID. Returns HTTP 409 when live references exist unless `force=true` (use `diviops_variables_scan_orphans` to find reference locations). Returns HTTP 403 for Divi's customizer-bound defaults (`gcid-primary-color`, `gcid-secondary-color`, `gcid-heading-color`, `gcid-body-color`, `gcid-link-color` — managed via WP Customizer) |
 | `diviops_create_canvas` | Create a canvas page |
 | `diviops_update_canvas` | Update canvas content |

package/dist/compatibility.d.ts

@@ -2,7 +2,7 @@
  * Version compatibility between MCP server and WP plugin.
  */
 /** Minimum WP plugin version this server requires. */
-export declare const MIN_PLUGIN_VERSION = "1.0.0-beta.28";
+export declare const MIN_PLUGIN_VERSION = "1.0.0-beta.30";
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/compatibility.js

@@ -2,7 +2,7 @@
  * Version compatibility between MCP server and WP plugin.
  */
 /** Minimum WP plugin version this server requires. */
-export const MIN_PLUGIN_VERSION = '1.0.0-beta.28';
+export const MIN_PLUGIN_VERSION = '1.0.0-beta.30';
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/index.js

@@ -107,7 +107,7 @@ server.registerTool("diviops_list_pages", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -120,7 +120,7 @@ server.registerTool("diviops_get_page", {
     const result = await wp.request(`/page/${page_id}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -140,7 +140,7 @@ server.registerTool("diviops_get_page_layout", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -150,7 +150,7 @@ server.registerTool("diviops_list_modules", {
     const result = await wp.request("/modules");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -171,7 +171,7 @@ server.registerTool("diviops_get_module_schema", {
     const output = raw ? result : optimizeSchema(result);
     return {
         content: [
-            { type: "text", text: JSON.stringify(output, null, 2) },
+            { type: "text", text: JSON.stringify(output) },
         ],
     };
 });
@@ -181,7 +181,7 @@ server.registerTool("diviops_get_settings", {
     const result = await wp.request("/settings");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -191,7 +191,7 @@ server.registerTool("diviops_get_global_colors", {
     const result = await wp.request("/global-colors");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -201,7 +201,7 @@ server.registerTool("diviops_get_global_fonts", {
     const result = await wp.request("/global-fonts");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -226,7 +226,7 @@ server.registerTool("diviops_find_icon", {
     const result = await wp.request(`/icons/search?q=${encodeURIComponent(query)}&type=${type ?? "all"}&limit=${limit ?? 10}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -246,7 +246,7 @@ server.registerTool("diviops_update_page_content", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -262,7 +262,7 @@ server.registerTool("diviops_render_preview", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -278,7 +278,7 @@ server.registerTool("diviops_validate_blocks", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -302,7 +302,7 @@ server.registerTool("diviops_append_section", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -341,7 +341,7 @@ server.registerTool("diviops_replace_section", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -377,7 +377,7 @@ server.registerTool("diviops_remove_section", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -411,7 +411,7 @@ server.registerTool("diviops_get_section", {
     const result = await wp.request(`/page/${page_id}/get-section?${qs}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -458,7 +458,7 @@ server.registerTool("diviops_update_module", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -532,7 +532,7 @@ server.registerTool("diviops_move_module", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -558,7 +558,7 @@ server.registerTool("diviops_create_page", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -569,7 +569,7 @@ server.registerTool("diviops_preset_audit", {
     const result = await wp.request("/preset-audit");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -615,7 +615,7 @@ server.registerTool("diviops_preset_cleanup", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -641,7 +641,7 @@ server.registerTool("diviops_preset_update", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -657,7 +657,7 @@ server.registerTool("diviops_preset_delete", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -703,7 +703,7 @@ server.registerTool("diviops_preset_create", {
     const result = await wp.request("/preset-create", { method: "POST", body });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -741,7 +741,7 @@ server.registerTool("diviops_preset_reassign", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -751,7 +751,7 @@ server.registerTool("diviops_preset_scan_orphans", {
     const result = await wp.request("/preset-scan-orphans");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -784,7 +784,7 @@ server.registerTool("diviops_list_library", {
     const result = await wp.request("/library", { params });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -797,7 +797,7 @@ server.registerTool("diviops_get_library_item", {
     const result = await wp.request(`/library/${item_id}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -831,7 +831,7 @@ server.registerTool("diviops_save_to_library", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -856,7 +856,7 @@ server.registerTool("diviops_list_tb_templates", {
     const result = await wp.request("/theme-builder/templates", { params });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -871,7 +871,7 @@ server.registerTool("diviops_get_tb_layout", {
     const result = await wp.request(`/theme-builder/layout/${layout_id}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -888,7 +888,7 @@ server.registerTool("diviops_update_tb_layout", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -917,7 +917,7 @@ server.registerTool("diviops_create_tb_template", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -962,7 +962,7 @@ server.registerTool("diviops_create_canvas", {
     const result = await wp.request("/canvas/create", { method: "POST", body });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -991,7 +991,7 @@ server.registerTool("diviops_list_canvases", {
     const result = await wp.request("/canvases", { params });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1006,7 +1006,7 @@ server.registerTool("diviops_get_canvas", {
     const result = await wp.request(`/canvas/${canvas_post_id}`);
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1041,7 +1041,7 @@ server.registerTool("diviops_update_canvas", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1056,7 +1056,7 @@ server.registerTool("diviops_delete_canvas", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1092,7 +1092,7 @@ server.registerTool("diviops_test_connection", {
     const result = await wp.testConnection();
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1121,7 +1121,7 @@ server.registerTool("diviops_server_info", {
     };
     return {
         content: [
-            { type: "text", text: JSON.stringify(info, null, 2) },
+            { type: "text", text: JSON.stringify(info) },
         ],
     };
 });
@@ -1229,7 +1229,7 @@ server.registerTool("diviops_list_templates", {
         requires_css: t.requires_css ?? false,
     }));
     return {
-        content: [{ type: "text", text: JSON.stringify(list, null, 2) }],
+        content: [{ type: "text", text: JSON.stringify(list) }],
     };
 });
 server.registerTool("diviops_get_template", {
@@ -1254,7 +1254,7 @@ server.registerTool("diviops_get_template", {
     }
     return {
         content: [
-            { type: "text", text: JSON.stringify(template, null, 2) },
+            { type: "text", text: JSON.stringify(template) },
         ],
     };
 });
@@ -1280,12 +1280,12 @@ server.registerTool("diviops_list_variables", {
     const result = await wp.request("/variables", { params });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
 server.registerTool("diviops_create_variable", {
-    description: 'Create a design token variable in the Divi Variable Manager. Colors (type "colors") use gcid-* IDs and hex values. Numbers/strings/etc use gvid-* IDs. For type="numbers" fluid tokens, pass min+max shorthand (anchors default to 320px/1920px) or explicit targets — server generates arithmetically-correct clamp() formulas. Px inputs only in this MVP; rem inputs must be converted to px (1rem=16px) before calling. Mutually exclusive with value.',
+    description: 'Create a design token variable in the Divi Variable Manager. Colors (type "colors") use gcid-* IDs and hex values. Numbers/strings/etc use gvid-* IDs. For type="numbers" fluid tokens, pass min+max shorthand (anchors default to 320px/1920px) or explicit targets — server generates arithmetically-correct clamp() formulas. All-px inputs emit px (safe default, root-agnostic). Rem inputs OR rem output require explicit opt-in: pass output_unit="rem" (accepts the 1rem=16px default) or root_font_size_px:N (declares your site\'s actual root font-size for correct rem emission on non-16px-root sites). Mutually exclusive with value.',
     inputSchema: {
         type: z
             .enum(["colors", "numbers", "strings", "images", "links", "fonts"])
@@ -1304,20 +1304,29 @@ server.registerTool("diviops_create_variable", {
         min: z
             .string()
             .optional()
-            .describe('Fluid minimum value in px (e.g. "20px"). Paired with max. Anchors default to 320px/1920px. type="numbers" only. Rem not supported — convert to px (1rem=16px) before calling.'),
+            .describe('Fluid minimum value (e.g. "20px" or "1.25rem"). Paired with max. Anchors default to 320px/1920px. Rem inputs require explicit opt-in via output_unit or root_font_size_px. type="numbers" only.'),
         max: z
             .string()
             .optional()
-            .describe('Fluid maximum value in px (e.g. "60px"). Paired with min.'),
+            .describe('Fluid maximum value (e.g. "60px" or "3.75rem"). Paired with min.'),
         targets: z
             .record(z.string(), z.string())
             .refine((m) => !m || Object.keys(m).length === 2, {
             message: "targets must contain exactly 2 viewport entries",
         })
             .optional()
-            .describe('Explicit two-anchor fluid spec, px only. Example: {"320px":"20px","1920px":"60px"} → clamp(20px, 12px + 2.5vw, 60px). Exactly 2 entries required. type="numbers" only. Mutually exclusive with min/max.'),
+            .describe('Explicit two-anchor fluid spec, object keyed by viewport width (px only). Example: {"320px":"20px","1920px":"60px"} → clamp(20px, 12px + 2.5vw, 60px). Exactly 2 entries required. type="numbers" only. Mutually exclusive with min/max. Rem values require explicit opt-in via output_unit or root_font_size_px.'),
+        output_unit: z
+            .enum(["rem", "px"])
+            .optional()
+            .describe('Unit for generated clamp formula. Omit for all-px inputs (safe default — emits px, root-agnostic). Pass "rem" to emit rem (accepts the 1rem=16px assumption unless root_font_size_px is also passed); required when inputs include rem unless root_font_size_px is passed. Pass "px" to force px output regardless of input unit.'),
+        root_font_size_px: z
+            .number()
+            .positive()
+            .optional()
+            .describe("Site's root font-size in px (positive number), used for correct rem↔px conversion in the generated clamp() formula. Defaults to 16 (standard browser default) when omitted. Pass explicitly for sites that customize `html { font-size }` (e.g. 10 for `html { font-size: 62.5% }`, 20 for `html { font-size: 20px }`). Also counts as an opt-in signal for rem emission — passing it alone (without output_unit) implies rem output. Only applies when min/max/targets is used."),
     },
-}, async ({ type, id, label, value, min, max, targets }) => {
+}, async ({ type, id, label, value, min, max, targets, output_unit, root_font_size_px, }) => {
     const body = { type, label };
     if (value !== undefined)
         body.value = value;
@@ -1329,13 +1338,17 @@ server.registerTool("diviops_create_variable", {
         body.max = max;
     if (targets !== undefined)
         body.targets = targets;
+    if (output_unit !== undefined)
+        body.output_unit = output_unit;
+    if (root_font_size_px !== undefined)
+        body.root_font_size_px = root_font_size_px;
     const result = await wp.request("/variable/create", {
         method: "POST",
         body,
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1358,7 +1371,7 @@ server.registerTool("diviops_delete_variable", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1368,7 +1381,7 @@ server.registerTool("diviops_variables_scan_orphans", {
     const result = await wp.request("/variables-scan-orphans");
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
@@ -1407,7 +1420,7 @@ server.registerTool("diviops_flush_static_cache", {
     });
     return {
         content: [
-            { type: "text", text: JSON.stringify(result, null, 2) },
+            { type: "text", text: JSON.stringify(result) },
         ],
     };
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diviops/mcp-server",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "MCP server exposing Divi 5 Visual Builder as tools for Claude",
   "type": "module",
   "main": "dist/index.js",