@respira/wordpress-mcp-server 8.3.14 → 8.3.16

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to Respira WordPress MCP Server will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.3.16] - 2026-08-29
+
+The half-answer in 8.3.15 becomes a whole one.
+
+### Added
+
+- **Divi 5 presets are first-class tools.** wordpress_list_divi_presets, wordpress_upsert_divi_presets (bulk, idempotent by name so a brand-profile installer can re-run safely), wordpress_delete_divi_preset, and wordpress_resolve_divi_preset (preview what a preset id applies before writing). The REST routes existed in the plugin for months; nothing exposed them, so agents only found them by probing, and the first bulk call in a customer's field report failed 22 times over a field name. The bulk tool accepts `module` as an alias for `module_type` now, normalized client-side. Together with plugin 8.8.0 activating Divi's own styling pipeline, a design system can finally live in presets the next person can edit in the Visual Builder, not in a stylesheet.
+
+## [8.3.15] - 2026-08-29
+
+Companion release to plugin 8.8.0: a customer named Bronko rebuilt a 16-page site with Respira and sent a measured field report. These are the client-side pieces of the answer.
+
+### Fixed
+
+- **The phantom "4KB limit" is gone.** Nested Divi 5 payloads over roughly 4KB appeared to arrive truncated, failing with a generic validation error that forced batches to be split and pushed one build toward literal hex colors instead of global-color variables. There was never a size limit. The inject tool's schema declared `content` as an object while every canonical payload shape is an array, so strict validators rejected the array form, and larger payloads are simply more often the nested-array shape. The schema now accepts both.
+- **find_builder_targets works on Divi 5.** Agents pass the generation string the builder info reports (`divi5`), which resolved no adapter, so the tool walked nothing and answered "this page is empty" with a success flag. The generation strings now alias to the right adapter.
+- **get_page_outline accepts `id`.** Every sibling read tool calls it `id`; this one demanded `page_id` and rejected the rest. Both work now.
+- **batch_update stops advertising a duplicate action the server rejects.** The schema promised it, the server 400ed the entire batch. The schema now tells the truth and points at duplicate_element.
+- **Every add_* shortcut states its contract up front.** They append at the end of the page, always. That used to be revealed only after a positioning parameter was silently ignored; the tool descriptions now say it before you build, along with the move_element recipe.
+
 ## [8.3.12] - 2026-08-25
 
 ### Fixed

package/README.md

@@ -7,14 +7,14 @@
 <h1 align="center">Respira WordPress MCP Server</h1>
 
 <p align="center">
-  <strong>214 MCP tools, 319 with the WooCommerce add-on. 17 page builders and the native Site Editor. MCP 2026-07-28 with legacy-client support.</strong><br>
+  <strong>218 MCP tools, 323 with the WooCommerce add-on. 17 page builders and the native Site Editor. MCP 2026-07-28 with legacy-client support.</strong><br>
   Element-level editing, full page creation, HTML-to-builder conversion with rendering fidelity validation, per-site tool governance, storefront design intelligence, stock images, bulk operations — all through one MCP server.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@respira/wordpress-mcp-server"><img src="https://img.shields.io/npm/v/@respira/wordpress-mcp-server.svg?style=flat-square&color=10b981" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/@respira/wordpress-mcp-server"><img src="https://img.shields.io/npm/dm/@respira/wordpress-mcp-server.svg?style=flat-square" alt="npm downloads"></a>
-  <img src="https://img.shields.io/badge/tools-319-10b981?style=flat-square" alt="318 Tools with WooCommerce">
+  <img src="https://img.shields.io/badge/tools-323-10b981?style=flat-square" alt="323 Tools with WooCommerce">
   <img src="https://img.shields.io/badge/builders-17-10b981?style=flat-square" alt="17 Page Builders">
   <img src="https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
 </p>
@@ -247,7 +247,7 @@ Or run the interactive setup wizard: `npx @respira/wordpress-mcp-server --setup`
 
 ### Tool Limit? Use `enabledTools`
 
-Some MCP clients (Antigravity, etc.) have a hard limit on active tools (often 100). Respira can expose up to 319 tools when the WooCommerce add-on is active. To stay under the limit, add `enabledTools` to your config — only those tools will appear in the listing:
+Some MCP clients (Antigravity, etc.) have a hard limit on active tools (often 100). Respira can expose up to 323 tools when the WooCommerce add-on is active. To stay under the limit, add `enabledTools` to your config — only those tools will appear in the listing:
 
 ```json
 {
@@ -856,6 +856,6 @@ MIT © [Respira](https://respira.press)
 ---
 
 <p align="center">
-  <strong>214 core tools, 319 with WooCommerce. 17 builders. The AI infrastructure layer for WordPress.</strong><br>
+  <strong>218 core tools, 323 with WooCommerce. 17 builders. The AI infrastructure layer for WordPress.</strong><br>
   <a href="https://respira.press">respira.press</a>
 </p>

package/SOUL.md

@@ -48,6 +48,7 @@ What agents always and never do.
 - **Never edit theme PHP, `wp_postmeta`, or the WordPress database directly.** All edits go through the builder-native tools. If the customer asks for a direct edit, refuse and explain why the safer path produces the same outcome.
 - **Always pass `site_id` per call in Cowork and multi-site contexts.** Switching context silently is how cross-site mistakes happen.
 - **Always read `inline_schemas` before injecting WPBakery, Uncode, or Visual Composer shortcodes.** The schemas are the contract. Guessing produces broken output.
+- **When the customer asks for a preview link to a staged change, quote `preview_url`, never the plain page url.** Every duplicate and staged write returns a signed `preview_url` (and repeats it in the response message): it renders that one draft to anyone, no WordPress login, and dies when the change is rejected. The plain `url` field is login-gated while the post is a draft, so handing it to a client is handing them a 404.
 - **When stuck: retry once with the structured hint, then run `respira_diagnose_connection`, then ASK the customer if they want to file a bug via `respira_report_issue`.** Never auto-file. The customer decides what to surface.
 - **Beautiful, accurate, fast.** Every output is judged on three axes in this order. Beautiful means it reads well and the page renders well. Accurate means it does exactly what was asked. Fast means it consumed the minimum tokens necessary.
 

package/TOOL_CATALOG.md

@@ -2,7 +2,7 @@
 
 <!-- Generated by scripts/check-tool-registry-parity.mjs. Do not edit by hand. -->
 
-Generated catalog: **187 core tools**, **105 WooCommerce tools**, **292 total**.
+Generated catalog: **191 core tools**, **105 WooCommerce tools**, **296 total**.
 
 The runtime applies site context and per-site governance, so an individual connection may expose a smaller relevant subset.
 
@@ -58,6 +58,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_delete_custom_post` — write; native + hosted
 - `wordpress_delete_design_direction` — write; native + hosted
 - `wordpress_delete_design_token` — write; native + hosted
+- `wordpress_delete_divi_preset` — write; hosted/stdio
 - `wordpress_delete_media` — write; native + hosted
 - `wordpress_delete_menu` — write; native + hosted
 - `wordpress_delete_menu_item` — write; native + hosted
@@ -123,6 +124,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_list_custom_taxonomies` — read; hosted/stdio
 - `wordpress_list_design_directions` — read; native + hosted
 - `wordpress_list_design_tokens` — read; native + hosted
+- `wordpress_list_divi_presets` — read; hosted/stdio
 - `wordpress_list_media` — read; native + hosted
 - `wordpress_list_memory` — read; native + hosted
 - `wordpress_list_menu_items` — read; native + hosted
@@ -156,6 +158,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_reorder_elements` — write; native + hosted
 - `wordpress_report_issue` — read; hosted/stdio
 - `wordpress_reset_site_template` — write; native + hosted
+- `wordpress_resolve_divi_preset` — read; hosted/stdio
 - `wordpress_restore_session` — write; hosted/stdio
 - `wordpress_restore_snapshot` — write; native + hosted
 - `wordpress_run_pagespeed_audit` — read; hosted/stdio
@@ -193,6 +196,7 @@ The runtime applies site context and per-site governance, so an individual conne
 - `wordpress_update_translation` — write; native + hosted
 - `wordpress_update_user` — write; native + hosted
 - `wordpress_upload_media` — write; native + hosted
+- `wordpress_upsert_divi_presets` — read; hosted/stdio
 - `wordpress_validate_security` — read; native + hosted
 - `wordpress_write_theme_file` — read; hosted/stdio
 

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -2196,6 +2196,88 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                     openWorldHint: false,
                 },
             },
+            {
+                name: 'wordpress_list_divi_presets',
+                description: 'List Divi 5 global presets on the active site (module presets and cross-cutting group presets). ' +
+                    'Presets are the reusable design objects the Divi Visual Builder shows as "Preset: <name>"; reference one from any write via `_presetId`. ' +
+                    'Optionally filter by module_type (e.g. divi/heading) or scope.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        module_type: { type: 'string', description: 'Filter to presets for one module type, e.g. "divi/button".' },
+                        scope: { type: 'string', description: 'Optional preset scope filter.' },
+                    },
+                },
+                annotations: {
+                    title: 'List Divi Presets',
+                    readOnlyHint: true,
+                    destructiveHint: false,
+                    idempotentHint: true,
+                    openWorldHint: false,
+                },
+            },
+            {
+                name: 'wordpress_upsert_divi_presets',
+                description: 'Create or update Divi 5 global presets in bulk. Each preset: {name, kind: "module"|"group", module_type, is_default?, attrs}. ' +
+                    '`module` is accepted as an alias for `module_type`. Upsert key is (kind, module_type, name), so re-running a brand-profile installer is idempotent: same names update in place, no duplicates. ' +
+                    'This is how a design system becomes editable by the next person in the Visual Builder instead of living in child-theme CSS.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        presets: {
+                            type: 'array',
+                            description: 'Presets to create or update.',
+                            items: { type: 'object' },
+                        },
+                    },
+                    required: ['presets'],
+                },
+                annotations: {
+                    title: 'Upsert Divi Presets',
+                    readOnlyHint: false,
+                    destructiveHint: false,
+                    idempotentHint: true,
+                    openWorldHint: false,
+                },
+            },
+            {
+                name: 'wordpress_delete_divi_preset',
+                description: 'Delete one Divi 5 global preset by its preset id. Modules referencing it keep their materialized attributes.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        preset_id: { type: 'string', description: 'Preset id (from wordpress_list_divi_presets).' },
+                    },
+                    required: ['preset_id'],
+                },
+                annotations: {
+                    title: 'Delete Divi Preset',
+                    readOnlyHint: false,
+                    destructiveHint: true,
+                    idempotentHint: true,
+                    openWorldHint: false,
+                },
+            },
+            {
+                name: 'wordpress_resolve_divi_preset',
+                description: 'Preview what a Divi 5 preset would apply: returns the resolved attribute groups for a `_presetId` without writing anything. ' +
+                    'Use before a write to check a preset id is valid for the target module type; an unknown id returns the closest match.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        preset_id: { type: 'string', description: 'Preset id to resolve.' },
+                        module_type: { type: 'string', description: 'Target module type, e.g. "divi/heading".' },
+                    },
+                    required: ['preset_id'],
+                },
+                annotations: {
+                    title: 'Resolve Divi Preset',
+                    readOnlyHint: true,
+                    destructiveHint: false,
+                    idempotentHint: true,
+                    openWorldHint: false,
+                },
+            },
             {
                 name: 'wordpress_search_abilities',
                 description: 'Search the curated WordPress Abilities directory and classify each result as Respira-native, inhaled, unavailable, or replaced by a safer Respira workflow. ' +
@@ -3077,8 +3159,12 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'number',
                             description: 'Page or post ID',
                         },
+                        id: {
+                            type: 'number',
+                            description: 'Alias for page_id (every sibling read tool calls it id, so both are accepted).',
+                        },
                     },
-                    required: ['page_id'],
+                    required: [],
                 },
                 annotations: {
                     title: "Page Outline",
@@ -3129,8 +3215,14 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             description: 'Page ID',
                         },
                         content: {
-                            type: 'object',
-                            description: 'Structured content to inject in simplified format. In "replace" mode (default), this REPLACES all existing content. In "append" mode, this is added after existing content. For Gutenberg: array of blocks [{type: "core/heading", attrs: {level: 2}, content: "Hello"}, {type: "core/paragraph", attrs: {}, content: "Text here"}]. For Beaver Builder: {rows: [{cols: [{modules: [{type: "rich-text", settings: {text: "..."}}]}]}]}. For Elementor: array of widget objects. For Divi: Divi shortcode or block structure. Use extract_builder_content to see the format for any builder.',
+                            // F5 (Bronko's field report): this was `type: 'object'`, while the
+                            // canonical Divi 5 / Gutenberg / Elementor payloads are ARRAYS.
+                            // Strict client-side validators rejected the array shape with a
+                            // generic InputValidationError that looked like a size limit
+                            // (larger payloads are simply more often the nested-array form,
+                            // so the failures correlated with ~4KB and read as truncation).
+                            type: ['array', 'object'],
+                            description: 'Structured content to inject in simplified format. In "replace" mode (default), this REPLACES all existing content. In "append" mode, this is added after existing content. For Gutenberg: array of blocks [{type: "core/heading", attrs: {level: 2}, content: "Hello"}, {type: "core/paragraph", attrs: {}, content: "Text here"}]. For Beaver Builder: {rows: [{cols: [{modules: [{type: "rich-text", settings: {text: "..."}}]}]}]}. For Elementor: array of widget objects. For Divi 5: array of section nodes (see the canonical nested shape in this tool\'s description). Use extract_builder_content to see the format for any builder.',
                         },
                         mode: {
                             type: 'string',
@@ -9477,6 +9569,14 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.getBuilderInfo({ debug: Boolean(args?.debug) });
             case 'wordpress_get_divi_migration_readiness':
                 return await client.getDiviMigrationReadiness();
+            case 'wordpress_list_divi_presets':
+                return await client.listDiviPresets(args.module_type, args.scope);
+            case 'wordpress_upsert_divi_presets':
+                return await client.upsertDiviPresets(args.presets);
+            case 'wordpress_delete_divi_preset':
+                return await client.deleteDiviPreset(args.preset_id);
+            case 'wordpress_resolve_divi_preset':
+                return await client.resolveDiviPreset(args.preset_id, args.module_type);
             case 'wordpress_abilities_gap_report':
                 return await client.getAbilitiesGapReport();
             case 'wordpress_search_abilities':
@@ -9644,8 +9744,15 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.extractBuilderContent(args.builder, args.page_id);
             case 'wordpress_find_builder_targets':
                 return await client.findBuilderTargets(args.builder, args.page_id, args.query, args.limit, args.offset);
-            case 'wordpress_get_page_outline':
-                return await client.getPageOutline(args.builder, args.page_id);
+            case 'wordpress_get_page_outline': {
+                // F9: every sibling read tool takes `id`; agents pass it here too and
+                // used to get a schema error. Accept both.
+                const outlineId = args.page_id ?? args.id;
+                if (outlineId === undefined || outlineId === null) {
+                    throw new Error('get_page_outline needs page_id (or its alias id).');
+                }
+                return await client.getPageOutline(args.builder, outlineId);
+            }
             case 'wordpress_get_builder_inline_schemas':
                 return await client.getBuilderInlineSchemas(args.builder, args.types);
             case 'wordpress_inject_builder_content':
@@ -10819,12 +10926,12 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         post_id: { type: 'number', description: 'Page/post ID' },
                         operations: {
                             type: 'array',
-                            description: 'Array of operations applied in order. Each op: {action: "update"|"remove"|"move"|"duplicate", identifier_type: "id"|"admin_label"|"type"|"path", identifier_value: string, updates?: object, target_container_path?: string, position?: number, match_content?: string}.',
+                            description: 'Array of operations applied in order. Each op: {action: "update"|"remove"|"move", identifier_type: "id"|"admin_label"|"type"|"path", identifier_value: string, updates?: object, target_container_path?: string, position?: number, match_content?: string}. To duplicate an element, use wordpress_duplicate_element (batch duplicate is not implemented server-side; the schema used to advertise it and the server rejected the whole batch).',
                             items: {
                                 type: 'object',
                                 required: ['action', 'identifier_type', 'identifier_value'],
                                 properties: {
-                                    action: { type: 'string', enum: ['update', 'remove', 'move', 'duplicate'] },
+                                    action: { type: 'string', enum: ['update', 'remove', 'move'] },
                                     identifier_type: { type: 'string', enum: ['id', 'admin_label', 'type', 'widget_type', 'path', 'content'] },
                                     identifier_value: { type: 'string' },
                                     updates: { type: 'object', description: 'For action=update: flat settings patch OR nested attrs bucket. See respira_update_element for shape.' },
@@ -11387,7 +11494,11 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
         ];
         return shortcuts.map((s) => ({
             name: `wordpress_${s.name}`,
-            description: s.description,
+            // F6 (Bronko's field report): the append-only behavior was only surfaced
+            // AFTER a positioning param was silently ignored, so agents built whole
+            // pages in content→form→rest order to control placement. State the
+            // contract and the supported recipe up front.
+            description: `${s.description} Appends at the END of the page (no positioning params). To place it elsewhere, call wordpress_move_element with the returned element_id.`,
             inputSchema: {
                 type: 'object',
                 properties: {