@respira/wordpress-mcp-server 3.3.3 → 3.3.5

package/README.md

@@ -9,22 +9,22 @@
 <p align="center">
   <strong>The only WordPress MCP with page builder support.</strong><br>
   Edit Divi, Elementor, Bricks & 8 more builders with Cursor, Claude Code & Windsurf.<br>
-  88 total tools: 77 WordPress core + 11 conditional WooCommerce tools.
+  103 total tools: 82 WordPress core + 21 conditional WooCommerce tools.
 </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=blue" 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/page%20builders-11-green?style=flat-square" alt="11 Page Builders">
-  <img src="https://img.shields.io/badge/tools-88-purple?style=flat-square" alt="88 Tools">
-  <img src="https://img.shields.io/badge/WooCommerce%20add--on-11%20conditional%20tools-7F54B3?style=flat-square" alt="WooCommerce conditional tools">
+  <img src="https://img.shields.io/badge/tools-103-purple?style=flat-square" alt="103 Tools">
+  <img src="https://img.shields.io/badge/WooCommerce%20add--on-21%20conditional%20tools-7F54B3?style=flat-square" alt="WooCommerce conditional tools">
   <img src="https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
   <a href="https://respira.press"><img src="https://img.shields.io/badge/website-respira.press-orange?style=flat-square" alt="Website"></a>
 </p>
 
 <p align="center">
   <a href="https://respira.press">Website</a> •
-  <a href="https://respira.press/documentation">Documentation</a> •
+  <a href="https://respira.press/docs">Documentation</a> •
   <a href="https://respira.press/releases">Download Plugin</a> •
   <a href="https://respira.press/support">Support</a>
 </p>
@@ -60,13 +60,13 @@
 | Product management tools | Yes (add-on) | No |
 | Order status and operations | Yes (add-on) | No |
 | Inventory and stock tools | Yes (add-on) | No |
-| Sales reports and coupons | Yes (add-on) | No |
+| Sales reports and inventory intelligence | Yes (add-on) | No |
 
 ### Tool Inventory (v3.3)
 
-- `77` always-on `wordpress_*` tools
-- `11` conditional `woocommerce_*` tools (only when WooCommerce add-on is installed and licensed)
-- `88` total MCP tools when WooCommerce add-on is active
+- `82` always-on `wordpress_*` tools
+- `21` conditional `woocommerce_*` tools (only when WooCommerce add-on is installed and licensed)
+- `103` total MCP tools when WooCommerce add-on is active
 - Automatic `respira/v2` capability negotiation with `respira/v1` fallback for backward compatibility
 
 ### Supported Page Builders
@@ -94,10 +94,11 @@
 
 Respira MCP can expose WooCommerce tools when the WooCommerce add-on is installed and licensed:
 
-- Product operations: list/get/create/update/duplicate, variations, categories
+- Product operations: list/get/create/update/duplicate plus category and tag taxonomy operations
 - Order operations: list/get/update status, safe order updates
 - Inventory operations: stock status overview, stock quantity updates
-- Commerce operations: coupons, customers, sales reports
+- Taxonomy operations: product categories and tags (list/get/create/update/delete)
+- Commerce reporting: sales reports
 - Add-on gating: tools auto-register only when add-on is active + licensed
 
 WooCommerce add-on details: [respira.press/addons/woocommerce](https://respira.press/addons/woocommerce)
@@ -230,17 +231,17 @@ Your live site is never at risk.
 
 Respira works alongside the official WordPress AI building blocks:
 
-- **WordPress Abilities API** (WP 6.9+): Respira plugin 3.3 registers all MCP tools as WordPress Abilities under `respira` and `respira-woocommerce` categories with rebased IDs (`respira/{tool-name}`)
-- **WordPress MCP Adapter**: Exposes Respira abilities alongside core WordPress tools automatically (dynamic 77/88 list)
+- **WordPress Abilities API** (WP 6.9+): Respira plugin 4.0 registers all MCP tools as WordPress Abilities under `respira` and `respira-woocommerce` categories with rebased IDs (`respira/{tool-name}`)
+- **WordPress MCP Adapter**: Exposes Respira abilities alongside core WordPress tools automatically (dynamic 82/103 list)
 - **Standalone MCP server** (this package): Quick start path — works without the Abilities API
-- **BrowserMCP/WebMCP**: Respira plugin 3.3 bundles the browser bridge directly, so Chrome can discover and run the same Respira abilities without a separate plugin install
+- **BrowserMCP/WebMCP**: Respira plugin 4.0 bundles the browser bridge directly, so Chrome can discover and run the same Respira abilities without a separate plugin install
 
 ### Two Access Paths
 
 | Path | How it works | Requirements |
 |------|-------------|--------------|
 | **Standalone** (this npm package) | Install via npm, configure in your AI tool | Node 18+, Respira plugin |
-| **WordPress MCP Adapter** | Abilities auto-discovered via WP-CLI STDIO | WP 6.9+, MCP Adapter plugin, Respira plugin v3.3+ |
+| **WordPress MCP Adapter** | Abilities auto-discovered via WP-CLI STDIO | WP 6.9+, MCP Adapter plugin, Respira plugin v4.0+ |
 
 Both paths are supported. Use whichever fits your setup.
 
@@ -257,7 +258,7 @@ wp mcp-adapter serve respira-press --user=admin
 
 ---
 
-## 77 Core Tools + 11 Conditional WooCommerce Tools (88 Total)
+## 82 Core Tools + 21 Conditional WooCommerce Tools (103 Total)
 
 ### Page Builder Tools
 | Tool | What it does |
@@ -299,6 +300,10 @@ wp mcp-adapter serve respira-press --user=admin
 | `woocommerce_list_products` / `woocommerce_get_product` | Browse and inspect products |
 | `woocommerce_create_product` / `woocommerce_update_product` | Create and update products |
 | `woocommerce_duplicate_product` | Duplicate products safely before edits |
+| `woocommerce_list_categories` / `woocommerce_get_category` | Browse and inspect product categories |
+| `woocommerce_create_category` / `woocommerce_update_category` / `woocommerce_delete_category` | Create, update, and delete product categories |
+| `woocommerce_list_tags` / `woocommerce_get_tag` | Browse and inspect product tags |
+| `woocommerce_create_tag` / `woocommerce_update_tag` / `woocommerce_delete_tag` | Create, update, and delete product tags |
 | `woocommerce_list_orders` / `woocommerce_get_order` | List and inspect orders |
 | `woocommerce_update_order_status` | Update order status with WooCommerce flows |
 | `woocommerce_get_stock_status` / `woocommerce_update_stock` | Inventory and stock management |
@@ -308,7 +313,7 @@ wp mcp-adapter serve respira-press --user=admin
 
 Full CRUD operations for all WordPress content types.
 
-[Full Tool Reference](https://respira.press/documentation/tools)
+[Full Tool Reference](https://respira.press/docs/tools)
 
 ---
 
@@ -459,7 +464,7 @@ See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for how to add builder support, n
 ## Links
 
 - [Website](https://respira.press)
-- [Documentation](https://respira.press/documentation)
+- [Documentation](https://respira.press/docs)
 - [Download Plugin](https://respira.press/releases)
 - [Support](https://respira.press/support)
 

package/dist/agent-signature.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Respira agent signature helpers.
+ *
+ * Adds best-effort metadata so WordPress + telemetry can identify
+ * which coding assistant is driving MCP traffic.
+ */
+export interface RespiraAgentSignature {
+    client: string;
+    version: string | null;
+    transport: string;
+    source: 'env' | 'heuristic' | 'default';
+}
+export declare function detectRespiraAgentSignature(): RespiraAgentSignature;
+export declare function getRespiraAgentHeaders(): Record<string, string>;
+//# sourceMappingURL=agent-signature.d.ts.map

package/dist/agent-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-signature.d.ts","sourceRoot":"","sources":["../src/agent-signature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;CACzC;AAmFD,wBAAgB,2BAA2B,IAAI,qBAAqB,CAgBnE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa/D"}

package/dist/agent-signature.js

@@ -0,0 +1,113 @@
+/**
+ * Respira agent signature helpers.
+ *
+ * Adds best-effort metadata so WordPress + telemetry can identify
+ * which coding assistant is driving MCP traffic.
+ */
+import { execSync } from 'node:child_process';
+const MAX_HEADER_VALUE = 64;
+function sanitizeHeaderToken(value, fallback = null) {
+    if (typeof value !== 'string') {
+        return fallback;
+    }
+    const cleaned = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._+\-/]/g, '')
+        .slice(0, MAX_HEADER_VALUE);
+    if (!cleaned) {
+        return fallback;
+    }
+    return cleaned;
+}
+function readParentCommand() {
+    try {
+        const output = execSync(`ps -o command= -p ${process.ppid}`, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return String(output || '').trim().toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
+function detectClientFromHeuristics() {
+    const parentCommand = readParentCommand();
+    const args = process.argv.join(' ').toLowerCase();
+    const envKeys = Object.keys(process.env).join(' ').toLowerCase();
+    const envVals = [
+        process.env.TERM_PROGRAM,
+        process.env.TERM_PROGRAM_VERSION,
+        process.env.VSCODE_GIT_IPC_HANDLE,
+        process.env.CURSOR_TRACE_ID,
+        process.env.CURSOR_AGENT,
+        process.env.CLAUDECODE,
+        process.env.CLAUDE_CODE_ENTRYPOINT,
+        process.env.CODEIUM_ENV,
+    ]
+        .filter(Boolean)
+        .join(' ')
+        .toLowerCase();
+    const fingerprint = `${parentCommand} ${args} ${envKeys} ${envVals}`;
+    if (fingerprint.includes('cursor'))
+        return 'cursor';
+    if (fingerprint.includes('claude'))
+        return 'claude-code';
+    if (fingerprint.includes('codex'))
+        return 'codex';
+    if (fingerprint.includes('windsurf') || fingerprint.includes('codeium'))
+        return 'windsurf';
+    if (fingerprint.includes('copilot'))
+        return 'copilot';
+    if (fingerprint.includes('gemini'))
+        return 'gemini';
+    return 'unknown';
+}
+function detectVersion(client) {
+    const explicit = sanitizeHeaderToken(process.env.RESPIRA_AGENT_VERSION) ||
+        sanitizeHeaderToken(process.env.MCP_AGENT_VERSION) ||
+        sanitizeHeaderToken(process.env.AI_AGENT_VERSION);
+    if (explicit) {
+        return explicit;
+    }
+    if (client === 'cursor') {
+        return sanitizeHeaderToken(process.env.CURSOR_VERSION);
+    }
+    if (client === 'claude-code') {
+        return sanitizeHeaderToken(process.env.CLAUDE_CODE_VERSION || process.env.CLAUDE_VERSION);
+    }
+    if (client === 'codex') {
+        return sanitizeHeaderToken(process.env.CODEX_VERSION);
+    }
+    if (client === 'windsurf') {
+        return sanitizeHeaderToken(process.env.WINDSURF_VERSION || process.env.CODEIUM_VERSION);
+    }
+    return null;
+}
+export function detectRespiraAgentSignature() {
+    const explicitClient = sanitizeHeaderToken(process.env.RESPIRA_AGENT_CLIENT) ||
+        sanitizeHeaderToken(process.env.MCP_AGENT_CLIENT) ||
+        sanitizeHeaderToken(process.env.AI_AGENT_CLIENT);
+    const client = explicitClient || detectClientFromHeuristics();
+    const transport = sanitizeHeaderToken(process.env.RESPIRA_AGENT_TRANSPORT, 'desktop-mcp') || 'desktop-mcp';
+    return {
+        client,
+        version: detectVersion(client),
+        transport,
+        source: explicitClient ? 'env' : client === 'unknown' ? 'default' : 'heuristic',
+    };
+}
+export function getRespiraAgentHeaders() {
+    const signature = detectRespiraAgentSignature();
+    const headers = {
+        'X-Respira-Agent-Client': signature.client,
+        'X-Respira-Agent-Transport': signature.transport,
+        'X-Respira-Agent-Source': signature.source,
+    };
+    if (signature.version) {
+        headers['X-Respira-Agent-Version'] = signature.version;
+    }
+    return headers;
+}
+//# sourceMappingURL=agent-signature.js.map

package/dist/agent-signature.js.map

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

package/dist/discovery/abilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abilities.d.ts","sourceRoot":"","sources":["../../src/discovery/abilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0BAA0B,EAAE,OAAO,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CA8EnC"}
+{"version":3,"file":"abilities.d.ts","sourceRoot":"","sources":["../../src/discovery/abilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0BAA0B,EAAE,OAAO,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAmFnC"}

package/dist/discovery/abilities.js

@@ -5,6 +5,7 @@
  * MCP Adapter installed, and informs the user about available
  * integration paths.
  */
+import { getRespiraAgentHeaders } from '../agent-signature.js';
 /**
  * Check if the WordPress site supports the Abilities API.
  *
@@ -24,10 +25,13 @@ export async function discoverAbilities(siteUrl, apiKey) {
     // Check for Abilities API
     try {
         const abilitiesUrl = `${baseUrl}/wp-json/wp-abilities/v1/abilities`;
+        const baseHeaders = {
+            'X-Respira-Key': apiKey,
+            'X-Respira-API-Key': apiKey,
+            ...getRespiraAgentHeaders(),
+        };
         const response = await fetch(abilitiesUrl, {
-            headers: {
-                'X-Respira-Key': apiKey,
-            },
+            headers: baseHeaders,
             signal: AbortSignal.timeout(10000),
         });
         if (response.ok) {
@@ -50,6 +54,8 @@ export async function discoverAbilities(siteUrl, apiKey) {
         const response = await fetch(mcpUrl, {
             headers: {
                 'X-Respira-Key': apiKey,
+                'X-Respira-API-Key': apiKey,
+                ...getRespiraAgentHeaders(),
             },
             signal: AbortSignal.timeout(10000),
         });

package/dist/discovery/abilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"abilities.js","sourceRoot":"","sources":["../../src/discovery/abilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,MAAc;IAEd,MAAM,MAAM,GAA6B;QACvC,qBAAqB,EAAE,KAAK;QAC5B,mBAAmB,EAAE,KAAK;QAC1B,0BAA0B,EAAE,KAAK;QACjC,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,GAAG,OAAO,oCAAoC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE;YACzC,OAAO,EAAE;gBACP,eAAe,EAAE,MAAM;aACxB;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACpC,MAAM,CAAC,iBAAiB,GAAG,YAAY,CAAC;YAExC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,4CAA4C;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,0BAA0B,GAAG,SAAS,CAAC,IAAI,CAChD,CAAC,OAAY,EAAE,EAAE,CACf,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ;oBACjC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CACtC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,OAAO,iCAAiC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YACnC,OAAO,EAAE;gBACP,eAAe,EAAE,MAAM;aACxB;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,0BAA0B,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACpE,MAAM,CAAC,OAAO;YACZ,uEAAuE;gBACvE,kFAAkF;gBAClF,kFAAkF,CAAC;IACvF,CAAC;SAAM,IAAI,MAAM,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;QAC9E,MAAM,CAAC,OAAO;YACZ,sFAAsF;gBACtF,yEAAyE,CAAC;IAC9E,CAAC;SAAM,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO;YACZ,6CAA6C;gBAC7C,uGAAuG,CAAC;IAC5G,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO;YACZ,iFAAiF;gBACjF,uDAAuD,CAAC;IAC5D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"abilities.js","sourceRoot":"","sources":["../../src/discovery/abilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAU/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,MAAc;IAEd,MAAM,MAAM,GAA6B;QACvC,qBAAqB,EAAE,KAAK;QAC5B,mBAAmB,EAAE,KAAK;QAC1B,0BAA0B,EAAE,KAAK;QACjC,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,GAAG,OAAO,oCAAoC,CAAC;QACpE,MAAM,WAAW,GAAG;YAClB,eAAe,EAAE,MAAM;YACvB,mBAAmB,EAAE,MAAM;YAC3B,GAAG,sBAAsB,EAAE;SAC5B,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE;YACzC,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACpC,MAAM,CAAC,iBAAiB,GAAG,YAAY,CAAC;YAExC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,4CAA4C;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,0BAA0B,GAAG,SAAS,CAAC,IAAI,CAChD,CAAC,OAAY,EAAE,EAAE,CACf,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ;oBACjC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CACtC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,OAAO,iCAAiC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YACnC,OAAO,EAAE;gBACP,eAAe,EAAE,MAAM;gBACvB,mBAAmB,EAAE,MAAM;gBAC3B,GAAG,sBAAsB,EAAE;aAC5B;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,0BAA0B,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACpE,MAAM,CAAC,OAAO;YACZ,uEAAuE;gBACvE,kFAAkF;gBAClF,kFAAkF,CAAC;IACvF,CAAC;SAAM,IAAI,MAAM,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;QAC9E,MAAM,CAAC,OAAO;YACZ,sFAAsF;gBACtF,yEAAyE,CAAC;IAC9E,CAAC;SAAM,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO;YACZ,6CAA6C;gBAC7C,uGAAuG,CAAC;IAC5G,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO;YACZ,iFAAiF;gBACjF,uDAAuD,CAAC;IAC5D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;gBAEzC,WAAW,EAAE,mBAAmB,EAAE;IA+B9C,OAAO,CAAC,aAAa;YAwGP,kBAAkB;YA6BlB,yBAAyB;YASzB,QAAQ;YAssDR,2BAA2B;IAazC,OAAO,CAAC,mBAAmB;YAmJb,cAAc;IAiYtB,GAAG;CAKV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;gBAEzC,WAAW,EAAE,mBAAmB,EAAE;IA+B9C,OAAO,CAAC,aAAa;YAwGP,kBAAkB;YA6BlB,yBAAyB;YASzB,QAAQ;YAssDR,2BAA2B;IAazC,OAAO,CAAC,mBAAmB;YAwTb,cAAc;IAmatB,GAAG;CAKV"}

package/dist/server.js

@@ -13,7 +13,7 @@ export class RespiraWordPressServer {
     currentSite = null;
     sites = new Map();
     versionChecker;
-    static MCP_SERVER_VERSION = '3.3.3';
+    static MCP_SERVER_VERSION = '3.3.4';
     constructor(siteConfigs) {
         this.server = new Server({
             name: 'respira-wordpress',
@@ -1951,6 +1951,16 @@ export class RespiraWordPressServer {
                         type: { type: 'string', description: 'simple or variable' },
                         regular_price: { type: 'string', description: 'Regular price' },
                         status: { type: 'string', description: 'draft, pending, publish' },
+                        category_ids: {
+                            type: 'array',
+                            items: { type: 'number' },
+                            description: 'Optional category IDs to assign',
+                        },
+                        tag_ids: {
+                            type: 'array',
+                            items: { type: 'number' },
+                            description: 'Optional tag IDs to assign',
+                        },
                     },
                     required: ['name'],
                 },
@@ -1967,6 +1977,26 @@ export class RespiraWordPressServer {
                         sale_price: { type: 'string', description: 'Sale price' },
                         stock_quantity: { type: 'number', description: 'Stock quantity' },
                         stock_status: { type: 'string', description: 'instock, outofstock, onbackorder' },
+                        category_ids: {
+                            type: 'array',
+                            items: { type: 'number' },
+                            description: 'Category IDs to assign',
+                        },
+                        categories: {
+                            type: 'array',
+                            items: {},
+                            description: 'Alternative category payload (IDs, names, slugs, or objects with id/name/slug)',
+                        },
+                        tag_ids: {
+                            type: 'array',
+                            items: { type: 'number' },
+                            description: 'Tag IDs to assign',
+                        },
+                        tags: {
+                            type: 'array',
+                            items: {},
+                            description: 'Alternative tag payload (IDs, names, slugs, or objects with id/name/slug)',
+                        },
                     },
                     required: ['id'],
                 },
@@ -1983,6 +2013,141 @@ export class RespiraWordPressServer {
                     required: ['id'],
                 },
             },
+            {
+                name: 'woocommerce_list_categories',
+                description: 'List WooCommerce product categories.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string', description: 'Search categories by name' },
+                        parent: { type: 'number', description: 'Filter by parent category ID' },
+                        hide_empty: { type: 'boolean', description: 'Hide categories without products' },
+                        per_page: { type: 'number', description: 'Categories per page (1-100)' },
+                        page: { type: 'number', description: 'Page number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_category',
+                description: 'Get detailed information for a single WooCommerce product category.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Category ID' },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_category',
+                description: 'Create a WooCommerce product category.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Category name' },
+                        slug: { type: 'string', description: 'Optional URL slug' },
+                        description: { type: 'string', description: 'Optional category description' },
+                        parent: { type: 'number', description: 'Optional parent category ID' },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'woocommerce_update_category',
+                description: 'Update a WooCommerce product category.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Category ID' },
+                        name: { type: 'string', description: 'Category name' },
+                        slug: { type: 'string', description: 'Optional URL slug' },
+                        description: { type: 'string', description: 'Category description' },
+                        parent: { type: 'number', description: 'Parent category ID (0 to move to root)' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_delete_category',
+                description: 'Delete a WooCommerce product category.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Category ID' },
+                    },
+                    required: ['id'],
+                },
+                destructiveHint: true,
+            },
+            {
+                name: 'woocommerce_list_tags',
+                description: 'List WooCommerce product tags.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string', description: 'Search tags by name' },
+                        hide_empty: { type: 'boolean', description: 'Hide tags without products' },
+                        per_page: { type: 'number', description: 'Tags per page (1-100)' },
+                        page: { type: 'number', description: 'Page number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_tag',
+                description: 'Get detailed information for a single WooCommerce product tag.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Tag ID' },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_tag',
+                description: 'Create a WooCommerce product tag.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Tag name' },
+                        slug: { type: 'string', description: 'Optional URL slug' },
+                        description: { type: 'string', description: 'Optional tag description' },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'woocommerce_update_tag',
+                description: 'Update a WooCommerce product tag.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Tag ID' },
+                        name: { type: 'string', description: 'Tag name' },
+                        slug: { type: 'string', description: 'Optional URL slug' },
+                        description: { type: 'string', description: 'Tag description' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_delete_tag',
+                description: 'Delete a WooCommerce product tag.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Tag ID' },
+                    },
+                    required: ['id'],
+                },
+                destructiveHint: true,
+            },
             {
                 name: 'woocommerce_list_orders',
                 description: 'List WooCommerce orders.',
@@ -2314,6 +2479,30 @@ export class RespiraWordPressServer {
             }
             case 'woocommerce_duplicate_product':
                 return await this.currentSite.woocommerceDuplicateProduct(args.id);
+            case 'woocommerce_list_categories':
+                return await this.currentSite.woocommerceListCategories(args);
+            case 'woocommerce_get_category':
+                return await this.currentSite.woocommerceGetCategory(args.id);
+            case 'woocommerce_create_category':
+                return await this.currentSite.woocommerceCreateCategory(args);
+            case 'woocommerce_update_category': {
+                const { id, ...payload } = args;
+                return await this.currentSite.woocommerceUpdateCategory(id, payload);
+            }
+            case 'woocommerce_delete_category':
+                return await this.currentSite.woocommerceDeleteCategory(args.id);
+            case 'woocommerce_list_tags':
+                return await this.currentSite.woocommerceListTags(args);
+            case 'woocommerce_get_tag':
+                return await this.currentSite.woocommerceGetTag(args.id);
+            case 'woocommerce_create_tag':
+                return await this.currentSite.woocommerceCreateTag(args);
+            case 'woocommerce_update_tag': {
+                const { id, ...payload } = args;
+                return await this.currentSite.woocommerceUpdateTag(id, payload);
+            }
+            case 'woocommerce_delete_tag':
+                return await this.currentSite.woocommerceDeleteTag(args.id);
             case 'woocommerce_list_orders':
                 return await this.currentSite.woocommerceListOrders(args);
             case 'woocommerce_get_order':