@respira/wordpress-mcp-server 6.0.0 → 6.0.2

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.
package/README.md CHANGED
@@ -171,7 +171,16 @@ Site management tools (`respira_list_sites`, `respira_switch_site`, `respira_get
171
171
 
172
172
  ---
173
173
 
174
- ## v5.2 "Elemental" — What's New
174
+ ## v6.0 "Storefront" — What's New
175
+
176
+ ### Context-Aware Tool Filtering
177
+ 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.
178
+
179
+ ### Flatsome UX Builder (Builder #12)
180
+ Full round-trip shortcode editing, element-level precision, declarative page creation, and 55-element intelligence. Detected by active theme — mixed-builder sites handled per-page.
181
+
182
+ ### 15 New WooCommerce Commerce Tools
183
+ Storefront design intelligence bridges commerce data and page builder visuals. Bulk pricing, catalog health audits, advanced filtering, natural language product search. Total WooCommerce tools: 36.
175
184
 
176
185
  ### Element-Level Operations
177
186
  Find, update, move, duplicate, and remove individual elements inside any page builder — by ID, type, CSS class, or content text.
@@ -226,13 +235,13 @@ respira_add_image({ post_id: 42, image_url: "https://..." })
226
235
 
227
236
  ---
228
237
 
229
- ## 11 Supported Page Builders
238
+ ## 12 Supported Page Builders
230
239
 
231
240
  <p align="center">
232
241
  <img src="https://img.shields.io/badge/Elementor-Full_Intelligence-92003B?style=for-the-badge" alt="Elementor">
233
242
  <img src="https://img.shields.io/badge/Divi_5-Full_Intelligence-7c3aed?style=for-the-badge" alt="Divi 5">
234
- <img src="https://img.shields.io/badge/Beaver_Builder-Full_Support-0fa2e6?style=for-the-badge" alt="Beaver Builder">
235
243
  <img src="https://img.shields.io/badge/Bricks-Full_Intelligence-ef6723?style=for-the-badge" alt="Bricks">
244
+ <img src="https://img.shields.io/badge/Flatsome-Full_Intelligence-3d9a8b?style=for-the-badge" alt="Flatsome">
236
245
  </p>
237
246
 
238
247
  | Builder | Support Level | Element Ops | Build Page | Dynamic Schemas |
@@ -240,6 +249,7 @@ respira_add_image({ post_id: 42, image_url: "https://..." })
240
249
  | **Elementor** | Full Intelligence | Native API | Yes | Yes — runtime control registry |
241
250
  | **Divi 5** | Full Intelligence | Native API | Yes | Yes — 40+ module definitions |
242
251
  | **Divi 4** | Full Intelligence | Tree utility | Yes | Static schemas |
252
+ | **Flatsome** | Full Intelligence | Tree utility | Yes | Yes — 55-element intelligence |
243
253
  | **Beaver Builder** | Full Support | Tree utility | Yes | Static schemas |
244
254
  | **Bricks** | Full Intelligence | Native API | Yes | Yes — 20 dedicated tools, ACSS integration |
245
255
  | **Gutenberg** | Full Support | Tree utility | Yes | Block registry |
@@ -252,7 +262,7 @@ respira_add_image({ post_id: 42, image_url: "https://..." })
252
262
 
253
263
  ---
254
264
 
255
- ## All 172 Tools
265
+ ## All Tools
256
266
 
257
267
  ### Bricks Deep Intelligence (20 tools) — NEW in v5.4
258
268
  | Tool | Description |
@@ -398,17 +408,21 @@ Add any widget to a page in one call:
398
408
  | `respira_switch_site` | Switch active site |
399
409
  | `respira_get_active_site` | Get current site info |
400
410
 
401
- ### WooCommerce Add-on (21 tools)
402
- Available when the [WooCommerce add-on](https://respira.press/addons/woocommerce) is installed:
411
+ ### WooCommerce Add-on (36 tools)
412
+ Available when the [WooCommerce add-on](https://respira.press/addons/woocommerce) is installed. Included free with Studio and Founder plans.
403
413
 
404
- | Tool | Description |
414
+ | Category | Tools |
405
415
  |---|---|
406
- | `woocommerce_list_products` / `get` / `create` / `update` / `duplicate` | Product CRUD |
407
- | `woocommerce_list_orders` / `get` / `update_order_status` | Order management |
408
- | `woocommerce_get_stock_status` / `update_stock` | Inventory control |
409
- | `woocommerce_list_categories` / `get` / `create` / `update` / `delete` | Product categories |
410
- | `woocommerce_list_tags` / `get` / `create` / `update` / `delete` | Product tags |
411
- | `woocommerce_sales_report` | Sales analytics |
416
+ | **Storefront intelligence** (NEW in v6.0) | `analyze_shop_page`, `analyze_product_page`, `update_product_card_layout`, `add_low_stock_badge`, `add_sale_badge`, `update_checkout_layout` |
417
+ | **Catalog operations** (NEW in v6.0) | `list_products_advanced`, `bulk_update_products`, `analyze_catalog_health`, `find_product_by_natural_language` |
418
+ | **Pricing** (NEW in v6.0) | `bulk_update_prices`, `schedule_sale`, `revert_pricing` |
419
+ | **Inventory** (NEW in v6.0) | `bulk_update_stock`, `find_low_stock` |
420
+ | **Product CRUD** | `list_products`, `get_product`, `create_product`, `update_product`, `duplicate_product` |
421
+ | **Order management** | `list_orders`, `get_order`, `update_order_status` |
422
+ | **Inventory control** | `get_stock_status`, `update_stock` |
423
+ | **Product categories** | `list_categories`, `get_category`, `create_category`, `update_category`, `delete_category` |
424
+ | **Product tags** | `list_tags`, `get_tag`, `create_tag`, `update_tag`, `delete_tag` |
425
+ | **Analytics** | `sales_report` |
412
426
 
413
427
  ---
414
428
 
@@ -445,11 +459,9 @@ For agencies managing many sites, use the hosted setup at [respira.press/dashboa
445
459
 
446
460
  ---
447
461
 
448
- ## Deprecation Notice: `wordpress_*` Tool Names
449
-
450
- All tools now use `respira_*` names (e.g. `respira_update_page`, `respira_find_element`).
462
+ ## Tool Naming: `respira_*`
451
463
 
452
- The legacy `wordpress_*` names still work as aliases for backward compatibility, but **will be removed in v6.0**. If your prompts or workflows reference `wordpress_*` tools, update them to `respira_*` now.
464
+ All tools use `respira_*` names (e.g. `respira_update_page`, `respira_find_element`). The legacy `wordpress_*` aliases are deprecated and will be removed in a future release. Update any prompts or workflows that still reference `wordpress_*` tools.
453
465
 
454
466
  ---
455
467
 
package/dist/server.js CHANGED
@@ -76,7 +76,7 @@ export class RespiraWordPressServer {
76
76
  capabilities: {
77
77
  tools: {},
78
78
  },
79
- instructions: `Respira MCP Server v${RespiraWordPressServer.MCP_SERVER_VERSION} — 172+ tools for WordPress (131 core + 20 Bricks + 21+ WooCommerce). Flatsome UX Builder support new in v6.0..
79
+ instructions: `Respira MCP Server v${RespiraWordPressServer.MCP_SERVER_VERSION} — 172+ tools for WordPress (131 core + 20 Bricks + 21+ WooCommerce). New in v6.0: Flatsome UX Builder (Builder #12), 15 new WooCommerce Commerce tools, and context-aware tool filtering that automatically shows only relevant tools based on detected builder and plugins.
80
80
 
81
81
  IMPORTANT: Always use Respira tools to read and edit WordPress content. NEVER access the database directly (SQL queries, wp_postmeta, wp_options), edit PHP files, or modify theme templates to change page content. Respira tools handle all content operations safely with snapshots, cache invalidation, and builder-native formats. Even for simple changes like updating a copyright year in a footer — use respira_find_element, not SQL.
82
82
 
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@respira/wordpress-mcp-server",
3
- "version": "6.0.0",
3
+ "version": "6.0.2",
4
4
  "mcpName": "io.github.webmyc/respira-wordpress",
5
- "description": "172+ MCP tools for WordPress — the only MCP server with native page builder support. Element-level editing, full page creation, HTML-to-builder conversion, WCAG accessibility scanning, stock images, bulk operations for 12 builders (Elementor, Divi 4+5, Bricks, Gutenberg, WPBakery, Oxygen, Beaver Builder, Brizy, Visual Composer, Thrive, Breakdance, Flatsome). Bricks Deep Intelligence (20 tools), WooCommerce (36 tools with storefront design intelligence), 27 widget shortcuts. Setup: npx add-mcp for auto-config, --setup wizard, --doctor diagnostics. Duplicate-before-edit safety. Skills marketplace with 26 AI workflows. Optimistic locking (contentHash). enabledTools config for clients with tool limits.",
5
+ "description": "172+ MCP tools for WordPress — the only MCP server with native page builder support and context-aware tool filtering. v6.0: context-aware filtering automatically shows only relevant tools based on your site's detected builder and plugins (~170 down to ~130, fail-open). 12 builders (Elementor, Divi 4+5, Bricks, Gutenberg, WPBakery, Oxygen, Beaver Builder, Brizy, Visual Composer, Thrive, Breakdance, Flatsome). Bricks Deep Intelligence (20 tools), WooCommerce Commerce (36 tools with storefront design intelligence, bulk pricing, catalog health). Element-level editing, full page creation, HTML-to-builder conversion, WCAG accessibility, stock images, bulk operations. Setup: npx add-mcp for auto-config, --setup wizard, --doctor diagnostics. Duplicate-before-edit safety. Skills marketplace with 26 AI workflows.",
6
6
  "main": "dist/index.js",
7
7
  "bin": {
8
8
  "wordpress-mcp-server": "./dist/index.js",
@@ -123,9 +123,9 @@
123
123
  },
124
124
  "dependencies": {
125
125
  "@iarna/toml": "^2.2.5",
126
- "@modelcontextprotocol/sdk": "^1.24.0",
126
+ "@modelcontextprotocol/sdk": "^1.29.0",
127
127
  "@sentry/node": "^10.25.0",
128
- "axios": "^1.6.0",
128
+ "axios": "^1.15.0",
129
129
  "dotenv": "^16.3.1",
130
130
  "form-data": "^4.0.0"
131
131
  },
@@ -137,6 +137,11 @@
137
137
  "prettier": "^3.1.0",
138
138
  "typescript": "^5.3.0"
139
139
  },
140
+ "overrides": {
141
+ "path-to-regexp": ">=8.4.0",
142
+ "qs": ">=6.14.2",
143
+ "ajv": ">=8.18.0"
144
+ },
140
145
  "engines": {
141
146
  "node": ">=18.0.0"
142
147
  }