@respira/wordpress-mcp-server 8.3.4 → 8.3.6

package/dist/server.js

@@ -3217,7 +3217,15 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] },
                         id: { type: 'string' },
                         name: { type: 'string' },
-                        value: {},
+                        value: {
+                            // Typed on purpose. An empty schema is valid JSON Schema and a
+                            // strict MCP validator rejects it: ChatGPT refused the whole
+                            // catalogue over this, so one untyped property took every tool
+                            // down. The plugin's own ability schema was fixed in 8.6.6; this
+                            // is the same fix in the npm lane, which still shipped it.
+                            type: ['string', 'number', 'object'],
+                            description: 'Token value: a CSS string for color and spacing ("#0f7b5f", "1.5rem"), a number, or an object for typography (fontFamily, fontSize, fontWeight, lineHeight).',
+                        },
                         expected_fingerprint: { type: 'string', description: 'Optional document revision returned by wordpress_list_design_tokens.' },
                         approval_token: { type: 'string' },
                         dry_run: { type: 'boolean' },
@@ -3235,7 +3243,15 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] },
                         id: { type: 'string' },
                         name: { type: 'string' },
-                        value: {},
+                        value: {
+                            // Typed on purpose. An empty schema is valid JSON Schema and a
+                            // strict MCP validator rejects it: ChatGPT refused the whole
+                            // catalogue over this, so one untyped property took every tool
+                            // down. The plugin's own ability schema was fixed in 8.6.6; this
+                            // is the same fix in the npm lane, which still shipped it.
+                            type: ['string', 'number', 'object'],
+                            description: 'Token value: a CSS string for color and spacing ("#0f7b5f", "1.5rem"), a number, or an object for typography (fontFamily, fontSize, fontWeight, lineHeight).',
+                        },
                         expected_fingerprint: { type: 'string' },
                         approval_token: { type: 'string' },
                         dry_run: { type: 'boolean' },
@@ -5159,6 +5175,26 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 },
                 destructiveHint: true,
             },
+            {
+                name: 'wordpress_purge_cache',
+                description: 'Purge page and object caches, and report exactly which caching layers were touched.\n\nEvery Respira write already purges what it changed, so you rarely need this. Reach for it when something changed outside Respira (a plugin update, a theme edit, a CDN holding a copy) or when a page still looks stale after an edit.\n\nPass post_id to purge one page or post. Omit it for a site-wide purge. The response lists every caching plugin Respira knows, split into `purged` (with the exact function or hook called) and `not_found` (with what was looked for), so a quiet result is never ambiguous.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        post_id: {
+                            type: 'number',
+                            description: 'Purge just this page or post. Omit for a site-wide purge.',
+                        },
+                        scope: {
+                            type: 'string',
+                            enum: ['post', 'site'],
+                            description: 'Force a scope. Defaults to post when post_id is given, site otherwise.',
+                        },
+                    },
+                    required: [],
+                },
+                idempotentHint: true,
+            },
             // Media enhancements
             {
                 name: 'wordpress_get_media',
@@ -5913,7 +5949,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_list_orders',
-                description: 'List WooCommerce orders.',
+                description: 'List WooCommerce orders. Every order carries customer_ip_address and customer_user_agent (the request fingerprint WooCommerce recorded, null when it recorded nothing) plus meta_data as a key/value list, so a card-testing run can be triaged from one call. Meta keys whose name matches a credential pattern (token, secret, key, password, hash, nonce, auth) are withheld; meta_data_withheld_count and meta_data_withheld_keys say which. Meta values over 500 characters are cut and the entry is marked truncated. The fingerprint fields are personal data and stay in this response: Respira telemetry never records tool results.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5926,7 +5962,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_get_order',
-                description: 'Get detailed information for a single WooCommerce order.',
+                description: 'Get detailed information for a single WooCommerce order, including customer_ip_address, customer_user_agent and meta_data as a key/value list. Meta keys whose name matches a credential pattern (token, secret, key, password, hash, nonce, auth) are withheld and reported in meta_data_withheld_count and meta_data_withheld_keys, so filtered data never looks like missing data.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -7950,6 +7986,8 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.updateOption(args.option, args.value);
             case 'wordpress_delete_option':
                 return await client.deleteOption(args.option, args.approval_token);
+            case 'wordpress_purge_cache':
+                return await client.purgeCache(args.post_id !== undefined ? Number(args.post_id) : undefined, args.scope);
             // Media enhancements
             case 'wordpress_get_media':
                 return await client.getMedia(args.id);