@respira/wordpress-mcp-server 7.2.1 → 7.2.2

package/README.md

@@ -7,14 +7,14 @@
 <h1 align="center">Respira WordPress MCP Server</h1>
 
 <p align="center">
-  <strong>180+ MCP tools. 16 page builders. Context-aware tool filtering. The AI infrastructure layer for WordPress.</strong><br>
+  <strong>200+ MCP tools (275+ with add-ons). 16 page builders. Context-aware tool filtering. The AI infrastructure layer for WordPress.</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-172+-10b981?style=flat-square" alt="172+ Tools">
+  <img src="https://img.shields.io/badge/tools-200+-10b981?style=flat-square" alt="200+ Tools">
   <img src="https://img.shields.io/badge/builders-16-10b981?style=flat-square" alt="16 Page Builders">
   <img src="https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
 </p>
@@ -40,12 +40,12 @@ Respira includes a WordPress plugin that gives AI **native access** to 16 page b
 The biggest release since launch.
 
 - **Four new page builders.** Spectra, Kadence Blocks, and GenerateBlocks join with full read + write; SeedProd ships read + audit. Supported builders go from 12 to 16.
-- **Make any builder responsive in one call** across Bricks, Elementor, Divi 4, Beaver Builder, and WPBakery.
+- **Make a page responsive in one call** on Bricks, Elementor, Divi 4, Beaver Builder, and WPBakery.
 - **Playbooks.** Teach an agent a multi-step workflow once and rerun it as a single callable WordPress Ability. Five tools (create / list / get / update / delete), with static cycle detection and a runtime depth cap.
 - **Agent-creatable Custom Post Types, taxonomies, and ACF field groups** (twelve tools), stored in options and registered on `init`. No PHP files, server-side slug allowlist, conservative deletes that report orphans.
 - **Native in-WP MCP endpoint.** Point a client straight at `your-site/?respira=mcp` (Streamable HTTP, JSON-RPC) with an API key, no npx process required. One-click connect-by-link mints and installs the key for you.
 - **System certificate-store trust.** The connector trusts the OS certificate store at startup (verification stays on) with a bundled Mozilla CA fallback, so valid public certs stop being rejected on Claude Desktop's bundled Node.
-- **Bricks design-token import + section presets**, the **Elementor 4 atomic write path**, and **`respira_generate_activity_report`** for client-ready reports.
+- **Bricks design-token import + section presets**, the **Elementor 4 atomic write path** (partial: 20 atomic element types with `$$type` envelopes, per-breakpoint + per-state styling, and a clear 422 on unsupported types instead of a silent drop), and **`respira_generate_activity_report`** for client-ready reports.
 
 ### New in v6.17.0: an MCP that knows how to behave
 
@@ -71,20 +71,20 @@ Every successful tool response includes `structuredContent`, the raw JSON object
 
 The MCP server automatically filters the tool list based on your site's detected builder and active plugins. A Divi site without WooCommerce sees ~130 tools instead of ~170. Less noise, faster AI responses, lower token usage. Fail-open: if detection fails, the full list is returned.
 
-| Capability | Respira | Other MCP Servers |
+| Capability | Respira | Typical WordPress MCP servers |
 |---|---|---|
-| Page builder support | **16 builders** (incl. Spectra, Kadence, GenerateBlocks) | None |
+| Page builder support | **16 builders** (incl. Spectra, Kadence, GenerateBlocks) | None, or a single builder |
 | Element-level find/update/move/remove | **Yes** | No |
 | Build full pages from structure | **Yes** | No |
 | Convert HTML to native builder | **Yes** | No |
-| Stock image search + sideload | **Yes** | No |
+| Stock image search + sideload | **Yes** | Rare |
 | Bulk operations (100 pages/call) | **Yes** | No |
 | 27 widget shortcuts (add_heading, etc.) | **Yes** | No |
-| Duplicate-before-edit safety | **Yes** | No |
-| Snapshot rollback | **Yes** | No |
-| SEO / Core Web Vitals / AEO analysis | **Yes** | No |
-| WooCommerce (products, orders, inventory) | **Yes** (add-on) | No |
-| Tool governance (per-tool enable/disable) | **Yes** | No |
+| Duplicate-before-edit safety | **Yes** | Rare |
+| Snapshot rollback | **Yes**, builder-aware | Rare, post content only |
+| SEO / Core Web Vitals / AEO analysis | **Yes** | Rare |
+| WooCommerce (products, orders, inventory) | **Yes** (add-on) | Rare |
+| Tool governance (per-tool enable/disable) | **Yes** | Rare |
 
 ---
 
@@ -450,7 +450,7 @@ Add any widget to a page in one call:
 | `respira_switch_site` | Switch active site |
 | `respira_get_active_site` | Get current site info |
 
-### WooCommerce Add-on (36 tools)
+### WooCommerce Add-on (21 tools)
 Available when the [WooCommerce add-on](https://respira.press/addons/woocommerce) is installed. Included free with Studio and Founder plans.
 
 | Category | Tools |
@@ -475,7 +475,7 @@ Every mutation creates a snapshot. Roll back anytime.
 1. **Snapshot captured** before every edit
 2. **Duplicate-before-edit** — original stays untouched
 3. **Approval workflow** — review changes in WordPress admin
-4. **Rollback** — restore any snapshot with `respira_restore_snapshot`
+4. **Rollback** — restore snapshots (90-day retention, pinnable) with `respira_restore_snapshot`
 
 ### Tool Governance
 
@@ -735,6 +735,6 @@ MIT © [Respira](https://respira.press)
 ---
 
 <p align="center">
-  <strong>172 tools. 12 builders. The AI infrastructure layer for WordPress.</strong><br>
+  <strong>200+ tools. 16 builders. The AI infrastructure layer for WordPress.</strong><br>
   <a href="https://respira.press">respira.press</a>
 </p>

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAkQzE,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;IAEpC,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;IAqUvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IA2CxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IA0GhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAuPP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IAmvFtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;YAEpC,oBAAoB;YAqDpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;IAwT3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IAqG5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAy2B9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoUzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAkQzE,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;IAEpC,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;IAqUvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IA2CxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IAiHhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAmQP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IA+vFtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;YAEpC,oBAAoB;YAqDpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;IAwT3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IAqG5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAy2B9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwUzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}

package/dist/server.js

@@ -1018,12 +1018,18 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             name: s.name || s.id || 'site',
             url: s.url,
         }));
+        const hasConfigB64 = Boolean(process.env.RESPIRA_CONFIG_B64);
+        const baseMessage = `Connected ${sites.length} site${sites.length === 1 ? '' : 's'} via the Respira Cowork token. The config was written to ~/.respira/config.json. Restart this Cowork chat (or open a new one) so the MCP server picks up the new sites.`;
+        const message = hasConfigB64
+            ? `${baseMessage} IMPORTANT: your MCP server is currently configured via the RESPIRA_CONFIG_B64 environment variable, which takes precedence over the file on disk. To activate the new site, update RESPIRA_CONFIG_B64 in your agent's MCP server config with the base64-encoded contents of the new ~/.respira/config.json file, then restart the agent.`
+            : baseMessage;
         return {
             success: true,
             sites_count: sites.length,
             sites,
             config_path: configPath,
-            message: `Connected ${sites.length} site${sites.length === 1 ? '' : 's'} via the Respira Cowork token. The config was written to ~/.respira/config.json. Restart this Cowork chat (or open a new one) so the MCP server picks up the new sites.`,
+            config_b64_active: hasConfigB64,
+            message,
         };
     }
     /**
@@ -1136,7 +1142,16 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             // respira_* alias to wordpress_* before dispatch.
             const canonical = this.normalizeToolName(name).canonical;
             if (canonical === 'wordpress_redeem_token') {
-                return this.withSiteContext(await this.redeemInstallToken(String(args?.token || '')), args);
+                // redeemInstallToken returns a plain object. Wrap it in the standard
+                // MCP content envelope — the early-exit path bypasses the normal
+                // handleToolCall wrapper, so non-Claude clients (Antigravity, etc.)
+                // would receive a bare object instead of {content:[{type:"text",...}]}
+                // and render it as an empty response.
+                const redeemResult = this.withSiteContext(await this.redeemInstallToken(String(args?.token || '')), args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(redeemResult) }],
+                    structuredContent: redeemResult,
+                };
             }
             if (!this.currentSite) {
                 throw new Error('No WordPress site configured');
@@ -1620,6 +1635,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'object',
                             description: 'Post meta data',
                         },
+                        post_parent: {
+                            type: 'number',
+                            description: 'Parent page ID. Pass 0 to detach from any parent (make a root page). Accepts parent, parent_id, or post_parent.',
+                        },
                         edit_target: {
                             type: 'string',
                             description: 'Choose ask, live, or duplicate when the target is an original page.',
@@ -3614,6 +3633,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'boolean',
                             description: 'When true, auto-create taxonomy terms that do not exist by name. Default false (strict: unknown slug returns 400 and the post is rolled back).',
                         },
+                        post_parent: {
+                            type: 'number',
+                            description: 'Parent post ID. Pass 0 for no parent. Useful when creating sub-pages or nested custom post types.',
+                        },
                         meta: {
                             type: 'object',
                             description: 'Post meta data (map of meta key to value).',
@@ -3695,6 +3718,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'boolean',
                             description: 'When true, append to existing taxonomy terms instead of replacing. Default false (replace).',
                         },
+                        post_parent: {
+                            type: 'number',
+                            description: 'Parent post ID. Pass 0 to detach. Accepts parent, parent_id, or post_parent.',
+                        },
                         meta: {
                             type: 'object',
                             description: 'Post meta data (e.g., { "_et_pb_custom_css": "/* CSS */" })',
@@ -5673,6 +5700,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'string',
                             description: 'Target builder (auto-detected if omitted)',
                         },
+                        post_parent: {
+                            type: 'number',
+                            description: 'Parent page ID. Pass 0 for no parent (root page). The created page will appear nested under the given parent in Page Attributes.',
+                        },
                     },
                     required: ['title', 'structure'],
                 },