npm - @diviops/mcp-server - Versions diffs - 0.2.29 → 1.0.0 - Mend

@diviops/mcp-server 0.2.29 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md CHANGED Viewed

@@ -41,7 +41,7 @@ claude mcp add diviops-mcp \
 > **Use `--env` flags, not the `env` command.** Claude Code's native `--env KEY=VALUE` flags survive copy-paste; the older `-- env KEY=VALUE` form (piping through unix `env`) breaks silently when any value contains a space. Quote any value with spaces (e.g. `--env "WP_PATH=/Users/you/Local Sites/site/app/public"`) — no backslash escaping needed inside quotes.
-**With WP-CLI** (optional — enables `diviops_wp_cli` tool):
+**With WP-CLI** (optional — enables `diviops_meta_wp_cli` tool):
 ```bash
 claude mcp add diviops-mcp \
   --env WP_URL=http://your-site.local \
@@ -101,68 +101,68 @@ The server connects via standard WordPress REST API and works with any environme
 ### Read (30)
 | Tool | Description |
 |------|-------------|
-| `diviops_test_connection` | Test WordPress connection and Divi version |
-| `diviops_server_info` | DiviOps server identity, version, license type, capabilities |
-| `diviops_list_pages` | List pages/posts with Divi status |
-| `diviops_get_page` | Get page details and raw content |
-| `diviops_get_page_layout` | Get parsed block tree (layout structure) |
-| `diviops_get_section` | Get a single section's markup by admin label |
-| `diviops_list_modules` | List all available Divi modules |
-| `diviops_get_module_schema` | Get attribute schema for a module (optimized by default, `raw: true` for full) |
-| `diviops_get_settings` | Get Divi site settings and theme options |
-| `diviops_get_global_colors` | Get global color palette |
-| `diviops_get_global_fonts` | Get global font definitions |
-| `diviops_find_icon` | Search 1,989 icons by keyword (FA + Divi) |
-| `diviops_list_templates` | List available MCP prompt templates |
-| `diviops_get_template` | Get a specific template's block markup |
+| `diviops_meta_ping` | Test WordPress connection and Divi version |
+| `diviops_meta_info` | DiviOps server identity, version, license type, capabilities |
+| `diviops_page_list` | List pages/posts with Divi status |
+| `diviops_page_get` | Get page details and raw content |
+| `diviops_page_get_layout` | Get parsed block tree (layout structure) |
+| `diviops_section_get` | Get a single section's markup by admin label |
+| `diviops_schema_list_modules` | List all available Divi modules |
+| `diviops_schema_get_module` | Get attribute schema for a module (optimized by default, `raw: true` for full) |
+| `diviops_schema_get_settings` | Get Divi site settings and theme options |
+| `diviops_global_color_list` | Get global color palette |
+| `diviops_global_font_list` | Get global font definitions |
+| `diviops_meta_find_icon` | Search 1,989 icons by keyword (FA + Divi) |
+| `diviops_template_list` | List available MCP prompt templates |
+| `diviops_template_get` | Get a specific template's block markup |
 | `diviops_preset_audit` | Audit presets with referenced/unreferenced analysis. Walks both page content and in-registry `groupPresets` chains; exposes `block_ref_count`, `group_ref_count`, `referenced_by_presets`. Also reports `orphan_default_pointers` — per-bucket `default` pointers referencing UUIDs missing from `items[]` (legacy damage from past unsafe deletes; clear via `diviops_preset_set_default` in bucket-addressed mode: `type` + `module` + `unset=true`) |
 | `diviops_preset_scan_orphans` | List page-referenced preset UUIDs missing from the D5 registry (separates dangling orphans from D4-legacy refs) |
-| `diviops_list_library` | List saved Divi Library items |
-| `diviops_get_library_item` | Get a library item's block markup |
+| `diviops_library_list` | List saved Divi Library items |
+| `diviops_library_get` | Get a library item's block markup |
 | `diviops_render_preview` | Render block markup to HTML for preview |
 | `diviops_validate_blocks` | Validate block markup (structure, required attrs, known pitfalls) |
-| `diviops_list_tb_templates` | List Theme Builder templates with conditions and layout IDs |
-| `diviops_get_tb_layout` | Get a Theme Builder layout's block markup (header/body/footer) |
-| `diviops_list_variables` | List design token variables (filter by type or prefix) |
-| `diviops_variables_scan_orphans` | Find `gvid-`/`gcid-` refs with no backing Variable Manager entry (orphans render as invalid CSS) + unused variables (defined, never referenced). Scans pages, Theme Builder layouts (header/body/footer), Divi Library items, canvas pages, and the preset registry |
-| `diviops_variables_used_on_page` | Detect which `gvid-` (numeric/font) IDs a single page emits — the exact set Divi 5.4.0+ uses to scope selective `:root{--gvid-*}` CSS variable emission. Walks the same content stack the frontend assembles (post_content + active TB header/body/footer + appended canvases + presets). `gcid-` colors are out of scope (separate emission path). Use for per-page orphan validation, preflight before bulk variable rename, or to debug why a numeric/font variable doesn't render on a specific page. Read-only |
-| `diviops_list_canvases` | List all canvas pages |
-| `diviops_get_canvas` | Get canvas content |
+| `diviops_tb_template_list` | List Theme Builder templates with conditions and layout IDs |
+| `diviops_tb_layout_get` | Get a Theme Builder layout's block markup (header/body/footer) |
+| `diviops_variable_list` | List design token variables (filter by type or prefix) |
+| `diviops_variable_scan_orphans` | Find `gvid-`/`gcid-` refs with no backing Variable Manager entry (orphans render as invalid CSS) + unused variables (defined, never referenced). Scans pages, Theme Builder layouts (header/body/footer), Divi Library items, canvas pages, and the preset registry |
+| `diviops_variable_used_on_page` | Detect which `gvid-` (numeric/font) IDs a single page emits — the exact set Divi 5.4.0+ uses to scope selective `:root{--gvid-*}` CSS variable emission. Walks the same content stack the frontend assembles (post_content + active TB header/body/footer + appended canvases + presets). `gcid-` colors are out of scope (separate emission path). Use for per-page orphan validation, preflight before bulk variable rename, or to debug why a numeric/font variable doesn't render on a specific page. Read-only |
+| `diviops_canvas_list` | List all canvas pages |
+| `diviops_canvas_get` | Get canvas content |
 | `diviops_scf_status` | Show SCF (Secure Custom Fields) sync status — pending JSON-vs-DB drift across field groups, post types, taxonomies, options pages. Wraps `wp scf json status` |
-| `diviops_scf_list_field_groups` | List all SCF/ACF field groups (post_name = ACF key, post_title, post_status, post_modified). Queries the `acf-field-group` post type via `wp post list` (works on SCF 6.8.4+ and older ACF) |
-| `diviops_scf_get_field_group` | Fetch a single SCF/ACF field-group post by ACF key (`group_abc123` → post_name) or numeric WP post ID. For the parsed/structured field tree, use `diviops_scf_export --field-groups=<key> --stdout` |
+| `diviops_scf_field_group_list` | List all SCF/ACF field groups (post_name = ACF key, post_title, post_status, post_modified). Queries the `acf-field-group` post type via `wp post list` (works on SCF 6.8.4+ and older ACF) |
+| `diviops_scf_field_group_get` | Fetch a single SCF/ACF field-group post by ACF key (`group_abc123` → post_name) or numeric WP post ID. For the parsed/structured field tree, use `diviops_scf_export --field-groups=<key> --stdout` |
 ### Write (31)
 | Tool | Description |
 |------|-------------|
-| `diviops_create_page` | Create a new page with optional Divi content |
-| `diviops_update_page_content` | Full page content rewrite |
-| `diviops_append_section` | Append a section to existing page (start or end) |
-| `diviops_replace_section` | Replace a section by admin label |
-| `diviops_remove_section` | Remove a section by admin label |
-| `diviops_update_module` | Update specific module attributes by label or text match |
-| `diviops_move_module` | Move a block before/after another block (reorder modules, sections) |
-| `diviops_lock_module` | Lock a module so VB users cannot edit it (frontend renders normally) |
-| `diviops_unlock_module` | Unlock a module by removing `attrs.locked` (matches VB's absence convention) |
-| `diviops_clone_module` | Deep-copy a module + insert next to source within the same parent |
-| `diviops_add_global_color` | Add a new global color to Divi's palette (writes canonical shape; closes ET's bundle Zod gap that drops `label`) |
-| `diviops_update_global_color` | Update an existing global color by gcid (only provided fields change) |
-| `diviops_delete_global_color` | Delete a global color (refuses if `usedInPosts` non-empty unless `force=true`; customizer-bound defaults always protected) |
+| `diviops_page_create` | Create a new page with optional Divi content |
+| `diviops_page_update_content` | Full page content rewrite |
+| `diviops_section_append` | Append a section to existing page (start or end) |
+| `diviops_section_replace` | Replace a section by admin label |
+| `diviops_section_remove` | Remove a section by admin label |
+| `diviops_module_update` | Update specific module attributes by label or text match |
+| `diviops_module_move` | Move a block before/after another block (reorder modules, sections) |
+| `diviops_module_lock` | Lock a module so VB users cannot edit it (frontend renders normally) |
+| `diviops_module_unlock` | Unlock a module by removing `attrs.locked` (matches VB's absence convention) |
+| `diviops_module_clone` | Deep-copy a module + insert next to source within the same parent |
+| `diviops_global_color_create` | Add a new global color to Divi's palette (writes canonical shape; closes ET's bundle Zod gap that drops `label`) |
+| `diviops_global_color_update` | Update an existing global color by gcid (only provided fields change) |
+| `diviops_global_color_delete` | Delete a global color (refuses if `usedInPosts` non-empty unless `force=true`; customizer-bound defaults always protected) |
 | `diviops_preset_cleanup` | Remove spam/duplicate presets, bulk rename |
 | `diviops_preset_create` | Write a new preset to the D5 registry (module or group type, supports `divi/column` etc.). Optional `make_default: true` sets it as the bucket's default; optional `priority` controls stack-merge order |
 | `diviops_preset_reassign` | Rewrite `modulePreset` references across pages (dry-run by default; optional `strip_inline` removes redundant inline attrs) |
 | `diviops_preset_update` | Update a specific preset (name, attrs, priority) |
 | `diviops_preset_delete` | Delete a preset by ID. Refuses with HTTP 409 `preset_is_default` when the target is the registered default for its bucket — clear the pointer first via `diviops_preset_set_default` with `unset=true`, or pass `force=true` to delete and clear the pointer in one write |
 | `diviops_preset_set_default` | Set or clear the per-module/group default preset. Two modes: by `preset_id` (UUID-addressed; auto-resolves bucket) or by `type` + `module` + `unset=true` (bucket-addressed clear, used to repair orphan default pointers when the UUID is gone from `items[]`). Defaults apply to NEW instances only — use `diviops_preset_reassign` for retroactive swaps |
-| `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. 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_create_fluid_system` | Batch-emit a fluid typography + spacing + radius variable set in one call. Mirrors Divi 5.4.0's Variable Generator Modal at the algorithm level (clamp() math is identical to `diviops_create_variable`'s fluid mode) but layers profile-selectable anchors over it: `divi-default` (360→1350) matches ET's defaults, `wide` (320→1920) matches the diviops convention, `custom` takes explicit anchors. Each category is independent and optional. Typography uses modular-scale chains (named ratios `major-third`/`perfect-fifth`/`golden`/etc., or raw numbers) — h1 = largest, hN = base. Spacing/radius support `linear` or `geometric` step distributions. `dry_run: true` returns the full plan without persisting; `overwrite: false` (default) skips existing IDs. Single atomic write to the registry — mid-batch failures roll back cleanly |
-| `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 |
-| `diviops_delete_canvas` | Delete a canvas page |
+| `diviops_library_save` | Save block markup to Divi Library |
+| `diviops_tb_layout_update` | Update a Theme Builder layout's block markup |
+| `diviops_tb_template_create` | Create Theme Builder template with header/footer and conditions |
+| `diviops_variable_create` | 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_variable_create_fluid_system` | Batch-emit a fluid typography + spacing + radius variable set in one call. Mirrors Divi 5.4.0's Variable Generator Modal at the algorithm level (clamp() math is identical to `diviops_variable_create`'s fluid mode) but layers profile-selectable anchors over it: `divi-default` (360→1350) matches ET's defaults, `wide` (320→1920) matches the diviops convention, `custom` takes explicit anchors. Each category is independent and optional. Typography uses modular-scale chains (named ratios `major-third`/`perfect-fifth`/`golden`/etc., or raw numbers) — h1 = largest, hN = base. Spacing/radius support `linear` or `geometric` step distributions. `dry_run: true` returns the full plan without persisting; `overwrite: false` (default) skips existing IDs. Single atomic write to the registry — mid-batch failures roll back cleanly |
+| `diviops_variable_delete` | Delete a variable by ID. Returns HTTP 409 when live references exist unless `force=true` (use `diviops_variable_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_canvas_create` | Create a canvas page |
+| `diviops_canvas_update` | Update canvas content |
+| `diviops_canvas_delete` | Delete a canvas page |
 | `diviops_scf_export` | Export SCF schema (field groups, post types, taxonomies, options pages) as JSON to a directory under the safe-root, or to stdout. Wraps `wp scf json export` |
 | `diviops_scf_import` | Import SCF schema from a JSON file (mutates DB; idempotent — existing items are updated). Wraps `wp scf json import <file>` |
 | `diviops_scf_sync` | Apply pending JSON-on-disk SCF changes to the DB. Defaults to `dry_run: true` for safety. Wraps `wp scf json sync` |
@@ -170,12 +170,12 @@ The server connects via standard WordPress REST API and works with any environme
 ### Utility (2)
 | Tool | Description |
 |------|-------------|
-| `diviops_wp_cli` | Run WP-CLI commands (allowlisted, requires `WP_PATH` or `WP_CLI_CMD`) |
-| `diviops_flush_static_cache` | Flush Divi's compiled CSS cache under `wp-content/et-cache/`. `wp cache flush` does NOT touch these files — the frontend can keep serving stale CSS after mutations. Delegates to Divi's native clearer (`ET_Core_PageResource::remove_static_resources`) when available — also clears Theme Builder / archive / taxonomy / home / notfound CSS, object cache, module features cache, post features cache, dynamic assets cache, Google Fonts cache, post meta caches. Falls back to a filesystem walk of numeric-named subdirs when Divi is inactive. Response includes `backend: "divi_native"` or `"fs_fallback"`. Exactly one selector required: `post_id`, `all`, or `after` (unix ts) — no default to `all` |
+| `diviops_meta_wp_cli` | Run WP-CLI commands (allowlisted, requires `WP_PATH` or `WP_CLI_CMD`) |
+| `diviops_meta_flush_cache` | Flush Divi's compiled CSS cache under `wp-content/et-cache/`. `wp cache flush` does NOT touch these files — the frontend can keep serving stale CSS after mutations. Delegates to Divi's native clearer (`ET_Core_PageResource::remove_static_resources`) when available — also clears Theme Builder / archive / taxonomy / home / notfound CSS, object cache, module features cache, post features cache, dynamic assets cache, Google Fonts cache, post meta caches. Falls back to a filesystem walk of numeric-named subdirs when Divi is inactive. Response includes `backend: "divi_native"` or `"fs_fallback"`. Exactly one selector required: `post_id`, `all`, or `after` (unix ts) — no default to `all` |
 ## WP-CLI Security
-The `diviops_wp_cli` tool validates every command against a safety allowlist before execution. Commands not on the list are rejected.
+The `diviops_meta_wp_cli` tool validates every command against a safety allowlist before execution. Commands not on the list are rejected.
 ### Default allowlist (always available)
@@ -257,7 +257,7 @@ The DEFAULT-tier filesystem commands (`wp export`, `acf export <path>`, `acf imp
 ## Safety Patterns
-High-risk or bulk destructive tools follow one of two conventions to guard against unintended mutation. Both are stateless (no session tokens between calls), but they guard differently: Pattern A is a **stateless gate** — the first call mutates when the safety check passes, refuses with an explanatory error when it fires. Pattern B is **preview-before-commit** — the first call never mutates; an explicit apply step is required. Tools without a gate (e.g., `diviops_update_page_content`) execute their mutation directly — whether to adopt a pattern is a per-tool design decision, not a retrofit requirement.
+High-risk or bulk destructive tools follow one of two conventions to guard against unintended mutation. Both are stateless (no session tokens between calls), but they guard differently: Pattern A is a **stateless gate** — the first call mutates when the safety check passes, refuses with an explanatory error when it fires. Pattern B is **preview-before-commit** — the first call never mutates; an explicit apply step is required. Tools without a gate (e.g., `diviops_page_update_content`) execute their mutation directly — whether to adopt a pattern is a per-tool design decision, not a retrofit requirement.
 ### Pattern A — `force: false/true` (refuse-with-override)
@@ -272,7 +272,7 @@ Tool refuses the operation with an explanatory error when a safety check fails;
 **Current tools:**
 | Tool | Guard | Override |
 |------|-------|----------|
-| `diviops_delete_variable` | HTTP 409 when live references exist | `force=true` |
+| `diviops_variable_delete` | HTTP 409 when live references exist | `force=true` |
 | `diviops_preset_delete` | HTTP 409 `preset_is_default` when target is the registered default for its bucket | `force=true` (deletes + clears the `default` pointer in the same write) |
 ### Pattern B — `mode: "dry-run"/"apply"` (preview-then-commit)
@@ -315,7 +315,7 @@ After setup, Claude can:
 Ensure `WP_URL`, `WP_USER`, and `WP_APP_PASSWORD` are all set. Check your `claude mcp add` command.
 ### "Connection failed" error
-- Verify the WP plugin is active: visit `{WP_URL}/wp-json/diviops/v1/settings` in your browser
+- Verify the WP plugin is active: visit `{WP_URL}/wp-json/diviops/v1/schema/settings` in your browser
 - Check Application Password is correct (try with curl first)
 ### "Version mismatch" error
@@ -327,7 +327,7 @@ The MCP server and WP plugin versions are incompatible. Update whichever side is
 ### Testing manually
 ```bash
-curl -u "username:apppassword" http://site.local/wp-json/diviops/v1/settings
+curl -u "username:apppassword" http://site.local/wp-json/diviops/v1/schema/settings
 ```
 ### Preset edits not visible on the frontend

package/dist/compatibility.d.ts CHANGED Viewed

@@ -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.44";
+export declare const MIN_PLUGIN_VERSION = "1.0.0";
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/compatibility.js CHANGED Viewed

@@ -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.44';
+export const MIN_PLUGIN_VERSION = '1.0.0';
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/index.js CHANGED Viewed

@@ -83,7 +83,7 @@ const server = new McpServer({
     version: SERVER_VERSION,
 });
 // ── Read Tools ───────────────────────────────────────────────────────
-server.registerTool("diviops_list_pages", {
+server.registerTool("diviops_page_list", {
     description: "List pages/posts in the WordPress site. Returns title, ID, URL, status, and whether each page uses Divi builder.",
     inputSchema: {
         post_type: z
@@ -99,7 +99,7 @@ server.registerTool("diviops_list_pages", {
         page: z.number().optional().default(1).describe("Page number"),
     },
 }, async ({ post_type, per_page, page }) => {
-    const result = await wp.request("/pages", {
+    const result = await wp.request("/page/list", {
         params: {
             post_type: post_type ?? "page",
             per_page: String(per_page ?? 20),
@@ -112,20 +112,20 @@ server.registerTool("diviops_list_pages", {
         ],
     };
 });
-server.registerTool("diviops_get_page", {
+server.registerTool("diviops_page_get", {
     description: "Get detailed info about a specific page including its raw Divi block content.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
     },
 }, async ({ page_id }) => {
-    const result = await wp.request(`/page/${page_id}`);
+    const result = await wp.request(`/page/get/${page_id}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_page_layout", {
+server.registerTool("diviops_page_get_layout", {
     description: "Get the parsed block tree for a page. Returns slim targeting metadata by default (block names, admin labels, text previews, auto_index). Use full: true for complete attrs (warning: can be very large on complex pages).",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -136,7 +136,7 @@ server.registerTool("diviops_get_page_layout", {
             .describe("Include full block attrs and raw content (default: false for slim mode)"),
     },
 }, async ({ page_id, full }) => {
-    const result = await wp.request(`/page/${page_id}/layout`, {
+    const result = await wp.request(`/page/get-layout/${page_id}`, {
         params: full ? { full: "true" } : {},
     });
     return {
@@ -145,17 +145,17 @@ server.registerTool("diviops_get_page_layout", {
         ],
     };
 });
-server.registerTool("diviops_list_modules", {
+server.registerTool("diviops_schema_list_modules", {
     description: "List all available Divi modules (block types) with their names, titles, and categories. Use this to discover what modules can be used in layouts.",
 }, async () => {
-    const result = await wp.request("/modules");
+    const result = await wp.request("/schema/modules");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_module_schema", {
+server.registerTool("diviops_schema_get_module", {
     description: "Get the attribute schema for a Divi module. Returns optimized schema by default (~70% smaller) with content-relevant fields only. Use raw: true for the full schema including CSS selectors and VB metadata.",
     inputSchema: {
         module_name: z
@@ -168,7 +168,7 @@ server.registerTool("diviops_get_module_schema", {
             .describe("Return full schema including CSS selectors and VB metadata"),
     },
 }, async ({ module_name, raw }) => {
-    const result = await wp.request(`/module/${encodeURIComponent(module_name)}`);
+    const result = await wp.request(`/schema/module/${encodeURIComponent(module_name)}`);
     const output = raw ? result : optimizeSchema(result);
     return {
         content: [
@@ -176,28 +176,28 @@ server.registerTool("diviops_get_module_schema", {
         ],
     };
 });
-server.registerTool("diviops_get_settings", {
+server.registerTool("diviops_schema_get_settings", {
     description: "Get Divi site settings including theme options, site info, and builder version. Useful for understanding the site context before generating content.",
 }, async () => {
-    const result = await wp.request("/settings");
+    const result = await wp.request("/schema/settings");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_global_colors", {
+server.registerTool("diviops_global_color_list", {
     description: "Get the global color palette defined in Divi. Returns all global colors that can be referenced by modules.",
 }, async () => {
-    const result = await wp.request("/global-colors");
+    const result = await wp.request("/global-color/list");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_add_global_color", {
-    description: "Add a new global color to Divi's palette. Server mints a fresh `gcid-<uuid>` ID and writes to the et_global_data option in the canonical Divi shape `{color, folder, label, lastUpdated, status, usedInPosts}`. The color appears in the VB color picker after save and can be referenced via `$variable({type:color,value:{name:gcid-...}})$` tokens. Note: Divi's AI Agent bundle has a Zod schema gap that drops `label` on its own writes — our PHP path goes around that bug by writing directly to the option. CONCURRENCY: this is a read-modify-write on a single WP option with no conflict detection. If a Visual Builder session holds stale global data, its next save can clobber colors written here in the interim. Coordinate writes when VB sessions are active, or have the user reload VB after MCP color writes.",
+server.registerTool("diviops_global_color_create", {
+    description: "Add a new global color to Divi's palette. The plugin mints a fresh `gcid-<uuid>` ID (the server forwards the color entry without an id and the WP-side handler generates one) and writes to the et_global_data option in the canonical Divi shape `{color, folder, label, lastUpdated, status, usedInPosts}`. The color appears in the VB color picker after save and can be referenced via `$variable({type:color,value:{name:gcid-...}})$` tokens. Note: Divi's AI Agent bundle has a Zod schema gap that drops `label` on its own writes — our PHP path goes around that bug by writing directly to the option. CONCURRENCY: this is a read-modify-write on a single WP option with no conflict detection. If a Visual Builder session holds stale global data, its next save can clobber colors written here in the interim. Coordinate writes when VB sessions are active, or have the user reload VB after MCP color writes.",
     inputSchema: {
         color: z
             .string()
@@ -224,18 +224,18 @@ server.registerTool("diviops_add_global_color", {
         colorEntry.folder = folder;
     if (status)
         colorEntry.status = status;
-    const result = await wp.request("/global-colors", {
+    const result = await wp.request("/global-color/upsert", {
         method: "POST",
         body: { colors: [colorEntry], mode: "merge" },
     });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_update_global_color", {
-    description: "Update an existing global color by gcid. Only provided fields are updated; omitted fields are preserved. The lastUpdated timestamp is bumped on every write. Use diviops_get_global_colors first to find the gcid for a color. CONCURRENCY: same VB-session race caveat as diviops_add_global_color — the write is read-modify-write on a single WP option, so an active VB session's next save can clobber this update.",
+server.registerTool("diviops_global_color_update", {
+    description: "Update an existing global color by gcid. Only provided fields are updated; omitted fields are preserved. The lastUpdated timestamp is bumped on every write. Use diviops_global_color_list first to find the gcid for a color. CONCURRENCY: same VB-session race caveat as diviops_global_color_create — the write is read-modify-write on a single WP option, so an active VB session's next save can clobber this update.",
     inputSchema: {
         gcid: z
             .string()
-            .describe('Global color ID, e.g. "gcid-abc123..." (must start with "gcid-"). Get from diviops_get_global_colors.'),
+            .describe('Global color ID, e.g. "gcid-abc123..." (must start with "gcid-"). Get from diviops_global_color_list.'),
         color: z
             .string()
             .optional()
@@ -263,14 +263,14 @@ server.registerTool("diviops_update_global_color", {
         colorEntry.folder = folder;
     if (status)
         colorEntry.status = status;
-    const result = await wp.request("/global-colors", {
+    const result = await wp.request("/global-color/upsert", {
         method: "POST",
         body: { colors: [colorEntry], mode: "merge" },
     });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_delete_global_color", {
-    description: "Delete a global color from the registry by gcid. Refuses by default if the color is tracked as referenced by any post (per Divi's `usedInPosts` index — pass `force: true` to delete anyway; orphan refs will render as invalid CSS until pages are re-saved through VB). Always refuses to delete the 5 customizer-bound defaults (gcid-primary-color, gcid-secondary-color, gcid-heading-color, gcid-body-color, gcid-link-color) regardless of force — those must be edited via WP Customizer. CONCURRENCY: same VB-session race caveat as diviops_add_global_color — an active VB session's next save can re-introduce a color we just deleted if the session held stale data.",
+server.registerTool("diviops_global_color_delete", {
+    description: "Delete a global color from the registry by gcid. Refuses by default if the color is tracked as referenced by any post (per Divi's `usedInPosts` index — pass `force: true` to delete anyway; orphan refs will render as invalid CSS until pages are re-saved through VB). Always refuses to delete the 5 customizer-bound defaults (gcid-primary-color, gcid-secondary-color, gcid-heading-color, gcid-body-color, gcid-link-color) regardless of force — those must be edited via WP Customizer. CONCURRENCY: same VB-session race caveat as diviops_global_color_create — an active VB session's next save can re-introduce a color we just deleted if the session held stale data.",
     inputSchema: {
         gcid: z
             .string()
@@ -285,23 +285,23 @@ server.registerTool("diviops_delete_global_color", {
     const body = { gcid };
     if (force)
         body.force = true;
-    const result = await wp.request("/global-color-delete", {
+    const result = await wp.request("/global-color/delete", {
         method: "POST",
         body,
     });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_get_global_fonts", {
+server.registerTool("diviops_global_font_list", {
     description: "Get the global font definitions from Divi settings.",
 }, async () => {
-    const result = await wp.request("/global-fonts");
+    const result = await wp.request("/global-font/list");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_find_icon", {
+server.registerTool("diviops_meta_find_icon", {
     description: "Search for icons by keyword. Returns matching icons with unicode, type (fa/divi), and weight. Use the returned unicode/type/weight in Blurb icon or Icon module attributes.",
     inputSchema: {
         query: z
@@ -319,7 +319,7 @@ server.registerTool("diviops_find_icon", {
             .describe("Max results (default 10, max 50)"),
     },
 }, async ({ query, type, limit }) => {
-    const result = await wp.request(`/icons/search?q=${encodeURIComponent(query)}&type=${type ?? "all"}&limit=${limit ?? 10}`);
+    const result = await wp.request(`/meta/find-icon?q=${encodeURIComponent(query)}&type=${type ?? "all"}&limit=${limit ?? 10}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
@@ -327,7 +327,7 @@ server.registerTool("diviops_find_icon", {
     };
 });
 // ── Write Tools ──────────────────────────────────────────────────────
-server.registerTool("diviops_update_page_content", {
+server.registerTool("diviops_page_update_content", {
     description: "Update the content of a page with Divi block markup. The content should be valid WordPress block markup using divi/* blocks. IMPORTANT: This overwrites the entire page content.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID to update"),
@@ -338,8 +338,8 @@ server.registerTool("diviops_update_page_content", {
 }, async ({ page_id, content }) => {
     const hits = findForeignVarRefs(content, "content");
     if (hits.length > 0)
-        return isolationErrorResult("diviops_update_page_content", hits);
-    const result = await wp.request(`/page/${page_id}/content`, {
+        return isolationErrorResult("diviops_page_update_content", hits);
+    const result = await wp.request(`/page/update-content/${page_id}`, {
         method: "POST",
         body: { content },
     });
@@ -371,7 +371,7 @@ server.registerTool("diviops_validate_blocks", {
         content: z.string().describe("Divi block markup to validate"),
     },
 }, async ({ content }) => {
-    const result = await wp.request("/validate", {
+    const result = await wp.request("/validate/blocks", {
         method: "POST",
         body: { content },
     });
@@ -381,7 +381,7 @@ server.registerTool("diviops_validate_blocks", {
         ],
     };
 });
-server.registerTool("diviops_append_section", {
+server.registerTool("diviops_section_append", {
     description: "Append a Divi section to an existing page without overwriting other content. Use this to incrementally build pages.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -397,8 +397,8 @@ server.registerTool("diviops_append_section", {
 }, async ({ page_id, content, position }) => {
     const hits = findForeignVarRefs(content, "content");
     if (hits.length > 0)
-        return isolationErrorResult("diviops_append_section", hits);
-    const result = await wp.request(`/page/${page_id}/append`, {
+        return isolationErrorResult("diviops_section_append", hits);
+    const result = await wp.request(`/section/append/${page_id}`, {
         method: "POST",
         body: { content, position: position ?? "end" },
     });
@@ -408,7 +408,7 @@ server.registerTool("diviops_append_section", {
         ],
     };
 });
-server.registerTool("diviops_replace_section", {
+server.registerTool("diviops_section_replace", {
     description: "Replace a section on a page. Target by admin label OR text content. Use occurrence when multiple sections match.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -434,13 +434,13 @@ server.registerTool("diviops_replace_section", {
 }, async ({ page_id, label, match_text, content, occurrence }) => {
     const hits = findForeignVarRefs(content, "content");
     if (hits.length > 0)
-        return isolationErrorResult("diviops_replace_section", hits);
+        return isolationErrorResult("diviops_section_replace", hits);
     const body = { content, occurrence };
     if (label)
         body.label = label;
     if (match_text)
         body.match_text = match_text;
-    const result = await wp.request(`/page/${page_id}/replace-section`, {
+    const result = await wp.request(`/section/replace/${page_id}`, {
         method: "POST",
         body,
     });
@@ -450,7 +450,7 @@ server.registerTool("diviops_replace_section", {
         ],
     };
 });
-server.registerTool("diviops_remove_section", {
+server.registerTool("diviops_section_remove", {
     description: "Remove a section from a page. Target by admin label OR text content. Use occurrence when multiple sections match.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -476,7 +476,7 @@ server.registerTool("diviops_remove_section", {
         body.label = label;
     if (match_text)
         body.match_text = match_text;
-    const result = await wp.request(`/page/${page_id}/remove-section`, {
+    const result = await wp.request(`/section/remove/${page_id}`, {
         method: "POST",
         body,
     });
@@ -486,7 +486,7 @@ server.registerTool("diviops_remove_section", {
         ],
     };
 });
-server.registerTool("diviops_get_section", {
+server.registerTool("diviops_section_get", {
     description: "Get the raw block markup of a section. Target by admin label OR text content. Use occurrence when multiple sections match. Returns total_matches warning when duplicates exist.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -513,14 +513,14 @@ server.registerTool("diviops_get_section", {
     if (match_text)
         params.match_text = match_text;
     const qs = new URLSearchParams(params).toString();
-    const result = await wp.request(`/page/${page_id}/get-section?${qs}`);
+    const result = await wp.request(`/section/get/${page_id}?${qs}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_update_module", {
+server.registerTool("diviops_module_update", {
     description: 'Update specific attributes of a module. Target by auto_index (e.g. "text:5"), admin label, or text content. Uses dot notation for attribute paths. Example: {"content.decoration.headingFont.h2.font.desktop.value.color": "#ff0000"}. For paths whose key segments contain literal dots — notably Composable Settings preset slots like groupPreset["title.decoration.spacing"] — escape the inner dots with `\\.` to keep the segment intact: {"groupPreset.title\\\\.decoration\\\\.spacing.presetId": ["uuid"]}. Priority: auto_index > label > match_text. Use occurrence with label when duplicates exist.',
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -535,7 +535,7 @@ server.registerTool("diviops_update_module", {
         auto_index: z
             .string()
             .optional()
-            .describe('Auto-index target in "type:N" format (e.g. "text:5", "icon:3"). Get from diviops_get_page_layout. Takes priority over label/match_text.'),
+            .describe('Auto-index target in "type:N" format (e.g. "text:5", "icon:3"). Get from diviops_page_get_layout. Takes priority over label/match_text.'),
         occurrence: z
             .number()
             .int()
@@ -550,7 +550,7 @@ server.registerTool("diviops_update_module", {
 }, async ({ page_id, label, match_text, auto_index, occurrence, attrs }) => {
     const hits = scanAttrsForForeignVarRefs(attrs);
     if (hits.length > 0)
-        return isolationErrorResult("diviops_update_module", hits);
+        return isolationErrorResult("diviops_module_update", hits);
     const body = { attrs };
     if (auto_index)
         body.auto_index = auto_index;
@@ -560,7 +560,7 @@ server.registerTool("diviops_update_module", {
         body.match_text = match_text;
     if (occurrence > 1)
         body.occurrence = occurrence;
-    const result = await wp.request(`/page/${page_id}/update-module`, {
+    const result = await wp.request(`/module/update/${page_id}`, {
         method: "POST",
         body,
     });
@@ -570,7 +570,7 @@ server.registerTool("diviops_update_module", {
         ],
     };
 });
-server.registerTool("diviops_move_module", {
+server.registerTool("diviops_module_move", {
     description: 'Move a module to a new position on the page. Specify source and target blocks using auto_index (e.g. "text:3"), admin label, or text content. Position "before" or "after" the target. Works with any block type including sections, rows, and modules. Both blocks are found in the original content, so auto_index values refer to positions before the move.',
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
@@ -634,7 +634,7 @@ server.registerTool("diviops_move_module", {
         body.target_auto_index = target_auto_index;
     if (target_occurrence > 1)
         body.target_occurrence = target_occurrence;
-    const result = await wp.request(`/page/${page_id}/move-module`, {
+    const result = await wp.request(`/module/move/${page_id}`, {
         method: "POST",
         body,
     });
@@ -644,8 +644,8 @@ server.registerTool("diviops_move_module", {
         ],
     };
 });
-server.registerTool("diviops_lock_module", {
-    description: 'Lock a module so VB users cannot edit it. Sets attrs.locked = {desktop: {value: "on"}} per Divi\'s per-breakpoint convention (verified via VB-save probe). Locked modules render normally on frontend; only VB-side editing is gated. Same targeting pattern as diviops_update_module — pick one of label / match_text / auto_index. Use diviops_unlock_module to reverse.',
+server.registerTool("diviops_module_lock", {
+    description: 'Lock a module so VB users cannot edit it. Sets attrs.locked = {desktop: {value: "on"}} per Divi\'s per-breakpoint convention (verified via VB-save probe). Locked modules render normally on frontend; only VB-side editing is gated. Same targeting pattern as diviops_module_update — pick one of label / match_text / auto_index. Use diviops_module_unlock to reverse.',
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
         label: z.string().optional().describe("Admin label of the module to lock (exact match)"),
@@ -663,11 +663,11 @@ server.registerTool("diviops_lock_module", {
         body.auto_index = auto_index;
     if (occurrence && occurrence > 1)
         body.occurrence = occurrence;
-    const result = await wp.request(`/page/${page_id}/lock-module`, { method: "POST", body });
+    const result = await wp.request(`/module/lock/${page_id}`, { method: "POST", body });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_unlock_module", {
-    description: "Unlock a module by removing attrs.locked entirely. Matches Divi VB's convention: unlocked = attribute absent (NOT {value: 'off'}) — VB doesn't write a falsy value on unlock, it removes the field. Same targeting pattern as diviops_lock_module.",
+server.registerTool("diviops_module_unlock", {
+    description: "Unlock a module by removing attrs.locked entirely. Matches Divi VB's convention: unlocked = attribute absent (NOT {value: 'off'}) — VB doesn't write a falsy value on unlock, it removes the field. Same targeting pattern as diviops_module_lock.",
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
         label: z.string().optional().describe("Admin label of the module to unlock (exact match)"),
@@ -685,11 +685,11 @@ server.registerTool("diviops_unlock_module", {
         body.auto_index = auto_index;
     if (occurrence && occurrence > 1)
         body.occurrence = occurrence;
-    const result = await wp.request(`/page/${page_id}/unlock-module`, { method: "POST", body });
+    const result = await wp.request(`/module/unlock/${page_id}`, { method: "POST", body });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_clone_module", {
-    description: 'Clone a module by deep-copying its block JSON and inserting it next to the source within the same parent container. Position controls before/after placement (default "after"). Module IDs are reassigned by Divi at render time from the block tree position, so the clone gets fresh IDs automatically. Same targeting pattern as diviops_lock_module.',
+server.registerTool("diviops_module_clone", {
+    description: 'Clone a module by deep-copying its block JSON and inserting it next to the source within the same parent container. Position controls before/after placement (default "after"). Module IDs are reassigned by Divi at render time from the block tree position, so the clone gets fresh IDs automatically. Same targeting pattern as diviops_module_lock.',
     inputSchema: {
         page_id: z.number().describe("WordPress post/page ID"),
         label: z.string().optional().describe("Admin label of the module to clone (exact match)"),
@@ -710,10 +710,10 @@ server.registerTool("diviops_clone_module", {
         body.occurrence = occurrence;
     if (position)
         body.position = position;
-    const result = await wp.request(`/page/${page_id}/clone-module`, { method: "POST", body });
+    const result = await wp.request(`/module/clone/${page_id}`, { method: "POST", body });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
 });
-server.registerTool("diviops_create_page", {
+server.registerTool("diviops_page_create", {
     description: "Create a new WordPress page, optionally with Divi block content.",
     inputSchema: {
         title: z.string().describe("Page title"),
@@ -732,7 +732,7 @@ server.registerTool("diviops_create_page", {
     if (content) {
         const hits = findForeignVarRefs(content, "content");
         if (hits.length > 0)
-            return isolationErrorResult("diviops_create_page", hits);
+            return isolationErrorResult("diviops_page_create", hits);
     }
     const result = await wp.request("/page/create", {
         method: "POST",
@@ -748,7 +748,7 @@ server.registerTool("diviops_create_page", {
 server.registerTool("diviops_preset_audit", {
     description: "Audit all Divi presets (module + group). Each entry reports `block_ref_count` (page-content refs via modulePreset / groupPreset block markup), `group_ref_count` (in-registry chain refs from other presets — module presets via top-level `groupPresets.<slot>.presetId`, group presets via `attrs.groupPreset.<slot>.presetId`), and `referenced` (true if either > 0). Group presets that are chain-referenced also expose `referenced_by_presets` (UUIDs of the presets that wire them in — typically module presets, but type-agnostic). Use this before deleting — orphan-cleanup based only on page refs would silently wipe load-bearing chain-wired group presets (font, border, box-shadow, spacing, button). Also reports `orphan_default_pointers`: per-bucket `default` pointers that reference a UUID no longer present in `items[]` (caused by past unsafe deletes). Render-safe but blocks Divi's lazy recreate-on-VB-use path; clear via diviops_preset_set_default with unset=true on the affected module/group.",
 }, async () => {
-    const result = await wp.request("/preset-audit");
+    const result = await wp.request("/preset/audit");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
@@ -791,7 +791,7 @@ server.registerTool("diviops_preset_cleanup", {
         body.prefix = prefix;
     if (action === "remove_orphans" && scope)
         body.scope = scope;
-    const result = await wp.request("/preset-cleanup", {
+    const result = await wp.request("/preset/cleanup", {
         method: "POST",
         body,
     });
@@ -824,7 +824,7 @@ server.registerTool("diviops_preset_update", {
         body.attrs = attrs;
     if (typeof priority === "number")
         body.priority = priority;
-    const result = await wp.request("/preset-update", {
+    const result = await wp.request("/preset/update", {
         method: "POST",
         body,
     });
@@ -847,7 +847,7 @@ server.registerTool("diviops_preset_delete", {
     const body = { preset_id };
     if (force !== undefined)
         body.force = force;
-    const result = await wp.request("/preset-delete", {
+    const result = await wp.request("/preset/delete", {
         method: "POST",
         body,
     });
@@ -909,7 +909,7 @@ server.registerTool("diviops_preset_create", {
         body.make_default = true;
     if (typeof priority === "number")
         body.priority = priority;
-    const result = await wp.request("/preset-create", { method: "POST", body });
+    const result = await wp.request("/preset/create", { method: "POST", body });
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
@@ -955,7 +955,7 @@ server.registerTool("diviops_preset_reassign", {
     };
     if (page_ids)
         body.page_ids = page_ids;
-    const result = await wp.request("/preset-reassign", {
+    const result = await wp.request("/preset/reassign", {
         method: "POST",
         body,
     });
@@ -968,7 +968,7 @@ server.registerTool("diviops_preset_reassign", {
 server.registerTool("diviops_preset_scan_orphans", {
     description: "Scan page content for modulePreset UUIDs that are not in the D5 registry. Categorizes as dangling orphans (preset was deleted, reference remains) or D4-legacy candidates (preset exists in the legacy builder_global_presets_ng option but not in D5). Use before diviops_preset_reassign to identify stale UUIDs for consolidation.",
 }, async () => {
-    const result = await wp.request("/preset-scan-orphans");
+    const result = await wp.request("/preset/scan-orphans");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
@@ -1005,7 +1005,7 @@ server.registerTool("diviops_preset_set_default", {
         body.module = module;
     if (unset)
         body.unset = true;
-    const result = await wp.request("/preset-set-default", {
+    const result = await wp.request("/preset/set-default", {
         method: "POST",
         body,
     });
@@ -1016,7 +1016,7 @@ server.registerTool("diviops_preset_set_default", {
     };
 });
 // ── Library Tools ───────────────────────────────────────────────────
-server.registerTool("diviops_list_library", {
+server.registerTool("diviops_library_list", {
     description: "List saved Divi Library items. Filter by layout_type (section, row, module) and scope (global, non_global).",
     inputSchema: {
         layout_type: z
@@ -1041,27 +1041,27 @@ server.registerTool("diviops_list_library", {
         params.scope = scope;
     if (per_page)
         params.per_page = String(per_page);
-    const result = await wp.request("/library", { params });
+    const result = await wp.request("/library/items", { params });
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_library_item", {
-    description: "Get a Divi Library item's content by ID. Returns the raw block markup that can be used with diviops_append_section or diviops_update_page_content.",
+server.registerTool("diviops_library_get", {
+    description: "Get a Divi Library item's content by ID. Returns the raw block markup that can be used with diviops_section_append or diviops_page_update_content.",
     inputSchema: {
         item_id: z.number().describe("Library item ID"),
     },
 }, async ({ item_id }) => {
-    const result = await wp.request(`/library/${item_id}`);
+    const result = await wp.request(`/library/item/${item_id}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_save_to_library", {
+server.registerTool("diviops_library_save", {
     description: 'Save Divi block markup to the Divi Library for reuse. Saved items appear in the VB\'s "Add From Library" panel.',
     inputSchema: {
         title: z.string().describe("Display name for the library item"),
@@ -1096,7 +1096,7 @@ server.registerTool("diviops_save_to_library", {
     };
 });
 // ── Theme Builder Tools ─────────────────────────────────────────────
-server.registerTool("diviops_list_tb_templates", {
+server.registerTool("diviops_tb_template_list", {
     description: "List all Theme Builder templates with their conditions, layout IDs, and enabled status. Shows which template applies to which pages/post types.",
     inputSchema: {
         per_page: z
@@ -1113,36 +1113,36 @@ server.registerTool("diviops_list_tb_templates", {
         params.per_page = String(per_page);
     if (page)
         params.page = String(page);
-    const result = await wp.request("/theme-builder/templates", { params });
+    const result = await wp.request("/theme-builder/template/list", { params });
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_tb_layout", {
-    description: "Get a Theme Builder layout's block markup content (header, body, or footer). Use the layout IDs from diviops_list_tb_templates.",
+server.registerTool("diviops_tb_layout_get", {
+    description: "Get a Theme Builder layout's block markup content (header, body, or footer). Use the layout IDs from diviops_tb_template_list.",
     inputSchema: {
         layout_id: z
             .number()
             .describe("Layout post ID (from template header_layout_id, body_layout_id, or footer_layout_id)"),
     },
 }, async ({ layout_id }) => {
-    const result = await wp.request(`/theme-builder/layout/${layout_id}`);
+    const result = await wp.request(`/theme-builder/layout/get/${layout_id}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_update_tb_layout", {
+server.registerTool("diviops_tb_layout_update", {
     description: "Update a Theme Builder layout's block markup (header, body, or footer). Replaces the full content.",
     inputSchema: {
         layout_id: z.number().describe("Layout post ID to update"),
         content: z.string().describe("New block markup content"),
     },
 }, async ({ layout_id, content }) => {
-    const result = await wp.request(`/theme-builder/layout/${layout_id}`, {
+    const result = await wp.request(`/theme-builder/layout/update/${layout_id}`, {
         method: "PUT",
         body: { content },
     });
@@ -1152,7 +1152,7 @@ server.registerTool("diviops_update_tb_layout", {
         ],
     };
 });
-server.registerTool("diviops_create_tb_template", {
+server.registerTool("diviops_tb_template_create", {
     description: "Create a Theme Builder template with custom header and/or footer. Automatically creates layout posts, sets conditions, and links to Theme Builder.",
     inputSchema: {
         title: z.string().describe('Template name (e.g. "Landing Pages")'),
@@ -1171,7 +1171,7 @@ server.registerTool("diviops_create_tb_template", {
             .describe("Footer block markup (empty = inherit from default template)"),
     },
 }, async ({ title, condition, header_content, footer_content }) => {
-    const result = await wp.request("/theme-builder/template", {
+    const result = await wp.request("/theme-builder/template/create", {
         method: "POST",
         body: { title, condition, header_content, footer_content },
     });
@@ -1182,7 +1182,7 @@ server.registerTool("diviops_create_tb_template", {
     };
 });
 // ── Canvas Tools ────────────────────────────────────────────────────
-server.registerTool("diviops_create_canvas", {
+server.registerTool("diviops_canvas_create", {
     description: "Create a canvas (off-canvas workspace) linked to a page. Used for popups, off-canvas menus, modals. Content uses standard Divi block markup.",
     inputSchema: {
         title: z
@@ -1226,7 +1226,7 @@ server.registerTool("diviops_create_canvas", {
         ],
     };
 });
-server.registerTool("diviops_list_canvases", {
+server.registerTool("diviops_canvas_list", {
     description: "List canvases (off-canvas workspaces). Filter by parent page or list all.",
     inputSchema: {
         parent_page_id: z
@@ -1248,29 +1248,29 @@ server.registerTool("diviops_list_canvases", {
         params.parent_page_id = String(parent_page_id);
     if (per_page)
         params.per_page = String(per_page);
-    const result = await wp.request("/canvases", { params });
+    const result = await wp.request("/canvas/list", { params });
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_get_canvas", {
+server.registerTool("diviops_canvas_get", {
     description: "Get a canvas's block content and metadata.",
     inputSchema: {
         canvas_post_id: z
             .number()
-            .describe("Canvas post ID (from diviops_list_canvases)"),
+            .describe("Canvas post ID (from diviops_canvas_list)"),
     },
 }, async ({ canvas_post_id }) => {
-    const result = await wp.request(`/canvas/${canvas_post_id}`);
+    const result = await wp.request(`/canvas/get/${canvas_post_id}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_update_canvas", {
+server.registerTool("diviops_canvas_update", {
     description: "Update a canvas's content and/or metadata. Content replaces the entire canvas.",
     inputSchema: {
         canvas_post_id: z.number().describe("Canvas post ID"),
@@ -1295,7 +1295,7 @@ server.registerTool("diviops_update_canvas", {
         body.append_to_main = append_to_main;
     if (z_index !== undefined)
         body.z_index = z_index;
-    const result = await wp.request(`/canvas/${canvas_post_id}`, {
+    const result = await wp.request(`/canvas/update/${canvas_post_id}`, {
         method: "POST",
         body,
     });
@@ -1305,14 +1305,14 @@ server.registerTool("diviops_update_canvas", {
         ],
     };
 });
-server.registerTool("diviops_delete_canvas", {
+server.registerTool("diviops_canvas_delete", {
     description: "Delete a canvas. This permanently removes the canvas post.",
     inputSchema: {
         canvas_post_id: z.number().describe("Canvas post ID to delete"),
     },
 }, async ({ canvas_post_id }) => {
-    const result = await wp.request(`/canvas/${canvas_post_id}`, {
-        method: "DELETE",
+    const result = await wp.request(`/canvas/delete/${canvas_post_id}`, {
+        method: "POST",
     });
     return {
         content: [
@@ -1321,7 +1321,7 @@ server.registerTool("diviops_delete_canvas", {
     };
 });
 // ── WP-CLI ──────────────────────────────────────────────────────────
-server.registerTool("diviops_wp_cli", {
+server.registerTool("diviops_meta_wp_cli", {
     description: "Run a WP-CLI command on the WordPress site. Requires WP_PATH env var (LOCAL_SITE_ID auto-detected from Local by Flywheel), or WP_CLI_CMD for containerized wrappers. Commands validated against a safety allowlist. Default tier covers read ops across options/posts/post-types/taxonomies/users/info/core/db, non-destructive writes (post/term create+update, post meta read/write, cache/rewrite/transient flush), ACF/SCF schema ops (`acf export/import/field-group list/get` plus SCF 6.8.4+ `scf json {status,sync,import,export}` and the `acf json …` aliases), and WXR export. Extended tier (requires DIVIOPS_WP_CLI_ALLOW env var) adds destructive or bulk-modifying ops: option update, post/post meta/term delete, search-replace, import, plugin activate/deactivate, eval-file. Filesystem-touching commands (`wp export`, `acf export/import`, `scf|acf json export/import`) are additionally constrained: path arguments must resolve under a safe root (defaults to `<WP_PATH>/.diviops-tmp/`, overridable via DIVIOPS_WP_CLI_SAFE_FS_ROOT, disable via DIVIOPS_WP_CLI_UNSAFE_FS=1); `wp export` and `scf json export` require an explicit `--dir=<path>` (or `--stdout`). In WP_CLI_CMD wrapper mode, DIVIOPS_WP_CLI_SAFE_FS_ROOT is required for FS-sensitive commands. Prefer the typed `diviops_scf_*` wrappers for SCF round-trips — they're easier to invoke and accept the same safe-root scoping. Use --format=json for structured output. Full allowlist + tier rationale + filesystem semantics in the MCP server README.",
     inputSchema: {
         command: z
@@ -1411,7 +1411,7 @@ server.registerTool("diviops_scf_export", {
         field_groups: z
             .string()
             .optional()
-            .describe("Comma-separated field-group ACF keys (`group_abc123`) or admin titles (`My Field Group`). NOT WP post slugs — SCF matches against the def's `key` field or its `title` (case-insensitive). Use `diviops_scf_list_field_groups` to discover keys (post_name column)."),
+            .describe("Comma-separated field-group ACF keys (`group_abc123`) or admin titles (`My Field Group`). NOT WP post slugs — SCF matches against the def's `key` field or its `title` (case-insensitive). Use `diviops_scf_field_group_list` to discover keys (post_name column)."),
         post_types: z
             .string()
             .optional()
@@ -1515,7 +1515,7 @@ server.registerTool("diviops_scf_sync", {
         : `Error: ${result.error}\n${result.output}`;
     return { content: [{ type: "text", text: output }] };
 });
-server.registerTool("diviops_scf_list_field_groups", {
+server.registerTool("diviops_scf_field_group_list", {
     description: "List all SCF/ACF field groups in the database (post_name = ACF key, post_title, post_status, post_modified). Read-only. Queries the underlying `acf-field-group` post type via `wp post list` — works on both SCF 6.8.4+ (which dropped the legacy `wp acf field-group …` family in favor of the `wp scf json` namespace) and older ACF installs.",
 }, async () => {
     const gate = ensureWpCli();
@@ -1535,7 +1535,7 @@ server.registerTool("diviops_scf_list_field_groups", {
         : `Error: ${result.error}\n${result.output}`;
     return { content: [{ type: "text", text: output }] };
 });
-server.registerTool("diviops_scf_get_field_group", {
+server.registerTool("diviops_scf_field_group_get", {
     description: "Fetch a single SCF/ACF field group from the `acf-field-group` post type — by ACF key (`group_abc123`, looked up via `post_name`) or by numeric WP post ID. Returns the WP post fields (post_name, post_title, post_content with serialized fields blob, post_status, post_modified). For the parsed/structured field tree including nested fields, use `diviops_scf_export --field-groups=<key> --stdout` instead. Read-only. SCF 6.8.4 dropped the legacy `wp acf field-group get` command, so this wrapper queries the post type directly via `wp post`.",
     inputSchema: {
         key: z
@@ -1598,7 +1598,7 @@ server.registerTool("diviops_scf_get_field_group", {
             content: [
                 {
                     type: "text",
-                    text: `No field-group found for key "${key}". Use diviops_scf_list_field_groups to see available keys (post_name field).`,
+                    text: `No field-group found for key "${key}". Expected an ACF key (e.g. "group_5f8a1b2c3d4e5") or a numeric WP post ID (e.g. "287"). Use diviops_scf_field_group_list to see available keys (post_name field).`,
                 },
             ],
         };
@@ -1615,7 +1615,7 @@ server.registerTool("diviops_scf_get_field_group", {
     return { content: [{ type: "text", text: output }] };
 });
 // ── Connection ──────────────────────────────────────────────────────
-server.registerTool("diviops_test_connection", {
+server.registerTool("diviops_meta_ping", {
     description: "Test the connection to the WordPress site and verify the Divi MCP plugin is active.",
 }, async () => {
     const result = await wp.testConnection();
@@ -1625,7 +1625,7 @@ server.registerTool("diviops_test_connection", {
         ],
     };
 });
-server.registerTool("diviops_server_info", {
+server.registerTool("diviops_meta_info", {
     description: "Returns DiviOps MCP server identity, version, license type, and available capabilities.",
 }, async () => {
     const info = {
@@ -1724,8 +1724,8 @@ Attributes are JSON in the block comment. Structure:
 - \`divi/cta\` — Call to action blocks
 ## Tips
-1. Always use \`diviops_get_module_schema\` to check exact attribute names before building markup.
-2. Use \`diviops_get_page_layout\` on existing pages to learn the format from real examples.
+1. Always use \`diviops_schema_get_module\` to check exact attribute names before building markup.
+2. Use \`diviops_page_get_layout\` on existing pages to learn the format from real examples.
 3. Use \`diviops_render_preview\` to validate markup before saving.
 `;
 // ── Template Resources ──────────────────────────────────────────────
@@ -1748,7 +1748,7 @@ function loadTemplates() {
 }
 const templates = loadTemplates();
 // Register a list tool so Claude can discover available templates
-server.registerTool("diviops_list_templates", {
+server.registerTool("diviops_template_list", {
     description: "List available Divi page section templates. Each template contains verified block markup patterns that can be used as a base for page generation.",
 }, async () => {
     const list = Array.from(templates.entries()).map(([name, t]) => ({
@@ -1761,7 +1761,7 @@ server.registerTool("diviops_list_templates", {
         content: [{ type: "text", text: JSON.stringify(list) }],
     };
 });
-server.registerTool("diviops_get_template", {
+server.registerTool("diviops_template_get", {
     description: "Get a specific Divi template with verified block markup, customizable variables, and usage notes. Use this to generate pages based on proven patterns.",
     inputSchema: {
         template_name: z
@@ -1788,7 +1788,7 @@ server.registerTool("diviops_get_template", {
     };
 });
 // ── Variable Manager CRUD ─────────────────────────────────────────────
-server.registerTool("diviops_list_variables", {
+server.registerTool("diviops_variable_list", {
     description: "List all design token variables from the Divi Variable Manager. Colors (gcid-*) come from et_global_data, numbers/strings/etc (gvid-*) from et_divi_global_variables. Filter by type or ID prefix.",
     inputSchema: {
         type: z
@@ -1806,14 +1806,14 @@ server.registerTool("diviops_list_variables", {
         params.type = type;
     if (prefix)
         params.prefix = prefix;
-    const result = await wp.request("/variables", { params });
+    const result = await wp.request("/variable/list", { params });
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_create_variable", {
+server.registerTool("diviops_variable_create", {
     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
@@ -1881,8 +1881,8 @@ server.registerTool("diviops_create_variable", {
         ],
     };
 });
-server.registerTool("diviops_create_fluid_system", {
-    description: "Batch-emit a fluid typography + spacing + radius variable set in one call — mirrors Divi 5.4.0's Variable Generator Modal at the algorithm level (clamp() math is identical to diviops_create_variable's fluid mode) but layers profile-selectable anchors over it. Each category is independent and optional. Use for: (1) bootstrapping a design system in one call instead of 20+ individual diviops_create_variable invocations; (2) mirroring ET's variable layout so your tokens coexist with VB-generated ones in the Variable Manager; (3) deterministic preflight via dry_run before committing the registry change. By default, refuses to overwrite existing IDs (returns them in `skipped`) — pass overwrite=true to update in place. Persists in a single atomic write to the variable registry; mid-batch failures roll back cleanly.",
+server.registerTool("diviops_variable_create_fluid_system", {
+    description: "Batch-emit a fluid typography + spacing + radius variable set in one call — mirrors Divi 5.4.0's Variable Generator Modal at the algorithm level (clamp() math is identical to diviops_variable_create's fluid mode) but layers profile-selectable anchors over it. Each category is independent and optional. Use for: (1) bootstrapping a design system in one call instead of 20+ individual diviops_variable_create invocations; (2) mirroring ET's variable layout so your tokens coexist with VB-generated ones in the Variable Manager; (3) deterministic preflight via dry_run before committing the registry change. By default, refuses to overwrite existing IDs (returns them in `skipped`) — pass overwrite=true to update in place. Persists in a single atomic write to the variable registry; mid-batch failures roll back cleanly.",
     inputSchema: {
         profile: z
             .enum(["divi-default", "wide", "custom"])
@@ -2039,7 +2039,7 @@ server.registerTool("diviops_create_fluid_system", {
         body.dry_run = dry_run;
     if (overwrite !== undefined)
         body.overwrite = overwrite;
-    const result = await wp.request("/variables-create-fluid-system", {
+    const result = await wp.request("/variable/create-fluid-system", {
         method: "POST",
         body,
     });
@@ -2049,8 +2049,8 @@ server.registerTool("diviops_create_fluid_system", {
         ],
     };
 });
-server.registerTool("diviops_delete_variable", {
-    description: "Delete a design token variable by ID. Auto-detects storage from ID prefix (gcid-* = colors, gvid-* = numbers/strings/etc). Returns HTTP 409 when live references exist unless force=true — run diviops_variables_scan_orphans to see where the references live. Returns HTTP 403 for Divi's customizer-bound defaults (gcid-primary-color, gcid-secondary-color, gcid-heading-color, gcid-body-color, gcid-link-color); those are managed via WP Customizer theme options and can't be deleted via this tool.",
+server.registerTool("diviops_variable_delete", {
+    description: "Delete a design token variable by ID. Auto-detects storage from ID prefix (gcid-* = colors, gvid-* = numbers/strings/etc). Returns HTTP 409 when live references exist unless force=true — run diviops_variable_scan_orphans to see where the references live. Returns HTTP 403 for Divi's customizer-bound defaults (gcid-primary-color, gcid-secondary-color, gcid-heading-color, gcid-body-color, gcid-link-color); those are managed via WP Customizer theme options and can't be deleted via this tool.",
     inputSchema: {
         id: z
             .string()
@@ -2059,7 +2059,7 @@ server.registerTool("diviops_delete_variable", {
             .boolean()
             .optional()
             .default(false)
-            .describe("Delete even if live references exist. Orphans will remain in page/preset content and render as invalid CSS on the frontend — run diviops_variables_scan_orphans afterwards to audit."),
+            .describe("Delete even if live references exist. Orphans will remain in page/preset content and render as invalid CSS on the frontend — run diviops_variable_scan_orphans afterwards to audit."),
     },
 }, async ({ id, force }) => {
     const result = await wp.request("/variable/delete", {
@@ -2072,18 +2072,18 @@ server.registerTool("diviops_delete_variable", {
         ],
     };
 });
-server.registerTool("diviops_variables_scan_orphans", {
+server.registerTool("diviops_variable_scan_orphans", {
     description: "Scan pages, Theme Builder layouts (header/body/footer), Divi Library items, canvas pages, and the preset registry for gvid-/gcid- references that have no backing entry in the Variable Manager (orphans), plus variables defined but referenced nowhere (unused). Orphans render as invalid CSS on the frontend — the $variable()$ resolver falls through with no fallback. Use after a deletion with force=true, or periodically as a hygiene check. Symmetric to diviops_preset_scan_orphans.",
 }, async () => {
-    const result = await wp.request("/variables-scan-orphans");
+    const result = await wp.request("/variable/scan-orphans");
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_variables_used_on_page", {
-    description: "Detect which numeric/font variable IDs a single page actually emits — the exact set Divi 5.4.0+ uses to scope selective `:root{--gvid-*}` CSS variable emission. Walks the same content stack the frontend assembles: post_content + active Theme Builder header/body/footer template content + appended canvas content (interaction targets etc.), plus presets referenced by that content. NOTE: this is `gvid-*` only — color variables (`gcid-*`) are emitted via a separate path (`GlobalData` color block) that is NOT scoped per-page in 5.4.0; this tool returns gvid IDs only. Use for per-page orphan validation (complements global diviops_variables_scan_orphans), preflight before bulk variable rename (know which pages are affected), or to debug why a numeric/font variable doesn't render on a specific page. Read-only. Returns variable_ids (sorted, deduped), count, and the tb_template_ids resolved for that post.",
+server.registerTool("diviops_variable_used_on_page", {
+    description: "Detect which numeric/font variable IDs a single page actually emits — the exact set Divi 5.4.0+ uses to scope selective `:root{--gvid-*}` CSS variable emission. Walks the same content stack the frontend assembles: post_content + active Theme Builder header/body/footer template content + appended canvas content (interaction targets etc.), plus presets referenced by that content. NOTE: this is `gvid-*` only — color variables (`gcid-*`) are emitted via a separate path (`GlobalData` color block) that is NOT scoped per-page in 5.4.0; this tool returns gvid IDs only. Use for per-page orphan validation (complements global diviops_variable_scan_orphans), preflight before bulk variable rename (know which pages are affected), or to debug why a numeric/font variable doesn't render on a specific page. Read-only. Returns variable_ids (sorted, deduped), count, and the tb_template_ids resolved for that post.",
     inputSchema: {
         post_id: z
             .number()
@@ -2092,14 +2092,14 @@ server.registerTool("diviops_variables_used_on_page", {
             .describe("WordPress post/page ID. The page does not need to be Divi-built — TB templates and canvases attached to non-Divi posts are still scanned."),
     },
 }, async ({ post_id }) => {
-    const result = await wp.request(`/variables-used-on-page/${post_id}`);
+    const result = await wp.request(`/variable/used-on-page/${post_id}`);
     return {
         content: [
             { type: "text", text: JSON.stringify(result) },
         ],
     };
 });
-server.registerTool("diviops_flush_static_cache", {
+server.registerTool("diviops_meta_flush_cache", {
     description: "Flush Divi's compiled static CSS cache under wp-content/et-cache/. wp cache flush does NOT touch these files — the frontend can keep serving stale CSS after a preset/variable/module mutation until the cache is cleared. Delegates to Divi's native ET_Core_PageResource::remove_static_resources when available (response backend: \"divi_native\"), which additionally clears Theme Builder CSS scattered across other post dirs, archive/taxonomy/home/notfound CSS, the object cache, module features cache, post features cache, Google Fonts cache, dynamic assets cache, and post meta caches. Falls back to a targeted filesystem walk of numeric-named et-cache subdirs when the Divi class is absent (backend: \"fs_fallback\"). Provide exactly one selector — no site-wide default to prevent accidental full flush. Idempotent: missing cache root returns 200 with empty list.",
     inputSchema: {
         post_id: z
@@ -2128,7 +2128,7 @@ server.registerTool("diviops_flush_static_cache", {
         body.all = true;
     if (after !== undefined)
         body.after = after;
-    const result = await wp.request("/flush-static-cache", {
+    const result = await wp.request("/meta/flush-cache", {
         method: "POST",
         body,
     });

package/dist/wp-client.js CHANGED Viewed

@@ -26,7 +26,7 @@ import { MIN_PLUGIN_VERSION, compareVersions, } from './compatibility.js';
  *   `0022` into emitted CSS).
  *
  * Under-escape (#409 fix). One form produced when an agent transcribes
- * `get_section` markup (which emits inner quotes as `&quot;` HTML entities) and
+ * `section_get` markup (which emits inner quotes as `&quot;` HTML entities) and
  * a layer in the agent → MCP → WP pipeline strips one level of escaping:
  *   - bare `"` (1 byte) — the inner quote loses its `\` prefix and prematurely
  *     terminates the OUTER block-attrs string at parse time. The WP block
@@ -67,8 +67,8 @@ function normalizeQuoteEscapes(s) {
  */
 const BLOCK_CONTENT_KEYS = new Set([
     'content', // update_page_content, render_preview, validate_blocks,
-    // append_section, replace_section, update_tb_layout,
-    // save_to_library, create_page
+    // section_append, section_replace, update_tb_layout,
+    // library_save, create_page
     'attrs', // update_module — attr values embedded in block JSON
     'header_content', // create_tb_template
     'footer_content', // create_tb_template
@@ -147,7 +147,7 @@ export class WPClient {
      */
     async testConnection() {
         try {
-            const result = await this.request('/settings');
+            const result = await this.request('/schema/settings');
             return {
                 ok: true,
                 message: `Connected to Divi ${result.builder?.version ?? 'unknown'}`,

package/package.json CHANGED Viewed

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