@respira/wordpress-mcp-server 8.3.15 → 8.3.16

package/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.

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/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":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAwCzE,MAAM,MAAM,eAAe,GAAG;IAC5B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAkBf;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,eAAe,CAUjB;AAqFD;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAoBhF;AA0LD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,aAkB3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,aAW3B,CAAC;AAEH,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAIvE;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAS;IACpC,iFAAiF;IACjF,OAAO,CAAC,iBAAiB,CAAK;IAC9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB,CAMK;IAClC,iFAAiF;IACjF,OAAO,CAAC,mBAAmB,CAAgC;IAC3D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEhE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAgWvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IAiCrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IA2CxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IA4OhC;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAgE7B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;YACW,qBAAqB;IAkBnC;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;YAiCnB,kBAAkB;IAwGhC,yFAAyF;IACzF,OAAO,CAAC,gBAAgB;IASxB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,6BAA6B;IA6CrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAoTP,kBAAkB;YAsClB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IAkyJtB;;;;;;OAMG;IACH;;;;;;;;;;;;;oDAagD;IAChD,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IAC1D;;mDAE+C;IAC/C,OAAO,CAAC,0BAA0B,CAAoC;IAEtE;;;;;;;;OAQG;YACW,0BAA0B;YAyC1B,oBAAoB;YA6CpB,2BAA2B;IAQzC;;;;OAIG;YACW,cAAc;IAQ5B,OAAO,CAAC,mBAAmB;IA4mE3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IA8H5B,oEAAoE;IACpE,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAk/C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsgBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkWxB,GAAG;CA+CV"}

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. ' +
@@ -9487,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':