@respira/wordpress-mcp-server 3.3.6 → 4.0.1

package/README.md

@@ -62,7 +62,7 @@
 | Inventory and stock tools | Yes (add-on) | No |
 | Sales reports and inventory intelligence | Yes (add-on) | No |
 
-### Tool Inventory (v3.3)
+### Tool Inventory (v4.0)
 
 - `82` always-on `wordpress_*` tools
 - `21` conditional `woocommerce_*` tools (only when WooCommerce add-on is installed and licensed)
@@ -116,6 +116,8 @@ WooCommerce add-on details: [respira.press/addons/woocommerce](https://respira.p
 
 ### Step 2: Configure Your AI Tool
 
+For agencies or anyone managing multiple connected sites, use the dedicated hosted setup page at [respira.press/dashboard/mcp](https://www.respira.press/dashboard/mcp). It generates the all-sites config, one-time install command, and AI setup prompt from your account inventory.
+
 <details>
 <summary><b>Cursor</b></summary>
 
@@ -184,7 +186,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 </details>
 
-### Step 3: Add Your Site
+### Step 3: Add Your Site (Manual / Advanced)
 
 Create `~/.respira/config.json`:
 ```json
@@ -203,6 +205,13 @@ Create `~/.respira/config.json`:
 
 **Done!** Restart your AI tool and start editing.
 
+### Guided Agency Setup
+
+- Download client-specific config from [respira.press/dashboard/mcp](https://www.respira.press/dashboard/mcp)
+- Or copy the one-time installer command:
+  - `npx -y @respira/wordpress-mcp-server --install-config --client codex --install-token <token>`
+- Treat exported configs and install commands like passwords. They grant access to connected sites. Never commit them to git or paste them into public chats or tickets.
+
 ---
 
 ## Safe Editing (Unique to Respira)
@@ -412,6 +421,34 @@ npx -y @respira/wordpress-mcp-server
 npx -y @smithery/cli install @respira/wordpress-mcp-server --client claude
 ```
 
+### Publish on Smithery
+
+Use Smithery's **GitHub / local deployment** flow for this repo, not the external URL form. Respira is a stdio-first MCP package, and Smithery can host the transport layer directly from the repository.
+
+Respira's longer-term Smithery architecture is a separate **remote MCP** hosted on `mcp.respira.press` with Respira OAuth and server-side entitlement checks. That remote path is the official commercial direction for Smithery because it keeps the paywall on the server. The local/package-hosted Smithery path in this repo remains the manual fallback and development path until the remote service is live.
+
+Recommended Smithery settings for this monorepo:
+
+1. Repository: `webmyc/respira-wordpress`
+2. Base directory: `mcp-server`
+3. Config file: `mcp-server/smithery.yaml`
+4. Runtime: `typescript` (picked up from `smithery.yaml`)
+
+Smithery session config fields:
+
+- `wordpressUrl` - normal single-site setup
+- `apiKey` - Respira plugin key (`respira_...`) or dashboard site token (`respira_site_...`)
+- `siteName` - optional display label
+- `siteId` - optional stable site identifier
+- `respiraConfigB64` - advanced dashboard export for multi-site setups
+
+Notes:
+
+- Smithery is best treated as a single-site connection for Respira today.
+- For agency multi-site work, use the dedicated export flow at [respira.press/dashboard/mcp](https://www.respira.press/dashboard/mcp).
+- Treat Smithery config values like passwords. They grant access to connected WordPress sites.
+- When the remote Smithery service launches, prefer the OAuth-backed `mcp.respira.press` connection over pasted site tokens.
+
 ### Interactive Setup Wizard
 ```bash
 npx @respira/wordpress-mcp-server --setup
@@ -441,8 +478,8 @@ npx @respira/wordpress-mcp-server --help    # Show help
 
 ### Environment Variables (Alternative to config file)
 ```bash
-export WP_SITE_URL=https://your-site.com
-export WP_API_KEY=respira_your-api-key
+export WORDPRESS_URL=https://your-site.com
+export WORDPRESS_API_KEY=respira_your-api-key
 ```
 
 ---

package/dist/config.d.ts

@@ -2,15 +2,34 @@
  * Configuration management
  */
 import type { RespiraConfig, WordPressSiteConfig } from './types/index.js';
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare function validateAndFixSiteUrl(url: string): {
+    url: string;
+    fixed: boolean;
+};
+export declare function normalizeConfig(config: RespiraConfig, sourceLabel: string, persistPath?: string): RespiraConfig;
+export declare function readConfigFromBase64(encoded: string): RespiraConfig;
 /**
- * Load configuration from file or environment variables.
- * When WORDPRESS_URL and WORDPRESS_API_KEY are set (e.g. from MCP client env), use those.
+ * Load configuration from inline base64, explicit file path, default file, or env vars.
+ *
+ * Precedence by default:
+ * 1. RESPIRA_CONFIG_B64
+ * 2. RESPIRA_CONFIG_FILE
+ * 3. ~/.respira/config.json
+ * 4. WORDPRESS_URL + WORDPRESS_API_KEY
+ *
+ * Set RESPIRA_CONFIG_MODE=env to force env-only mode for single-site setups.
  */
 export declare function loadConfig(): RespiraConfig;
 /**
- * Save configuration to file
+ * Save configuration to the default Respira config file.
  */
 export declare function saveConfig(config: RespiraConfig): void;
+/**
+ * Save configuration to an explicit file path.
+ */
+export declare function saveConfigToPath(config: RespiraConfig, path: string): void;
 /**
  * Add a new site to configuration
  */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAa3E;;;GAGG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAoL1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAWtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAevD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAgB/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiBnD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,eAAO,MAAM,UAAU,QAA8B,CAAC;AACtD,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAoElF;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CA0Cf;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAInE;AAiED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,aAAa,CA2C1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAOtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO1E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAavD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAe/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYnD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBlE"}

package/dist/config.js

@@ -2,205 +2,250 @@
  * Configuration management
  */
 import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { homedir } from 'os';
-const CONFIG_DIR = join(homedir(), '.respira');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
-const DEFAULT_CONFIG = {
-    sites: [],
-    preferences: {
-        autoDuplicate: true,
-        securityChecks: true,
-    },
-};
-/**
- * Load configuration from file or environment variables.
- * When WORDPRESS_URL and WORDPRESS_API_KEY are set (e.g. from MCP client env), use those.
- */
-export function loadConfig() {
-    const envUrl = process.env.WORDPRESS_URL?.trim();
-    const envKey = process.env.WORDPRESS_API_KEY?.trim();
-    if (envUrl && envKey && envKey.startsWith('respira_')) {
-        const url = envUrl.replace(/\/$/, '');
+export const CONFIG_DIR = join(homedir(), '.respira');
+export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export function validateAndFixSiteUrl(url) {
+    let fixedUrl = (url || '').trim();
+    let fixed = false;
+    const dupProtocolMatch = fixedUrl.match(/^(https?:\/\/){2,}/i);
+    if (dupProtocolMatch) {
+        const firstProtocol = fixedUrl.startsWith('https') ? 'https://' : 'http://';
+        fixedUrl = fixedUrl.replace(/^(https?:\/\/)+/i, firstProtocol);
+        fixed = true;
+    }
+    if (fixedUrl.match(/^http:\/\/https:\/\//i)) {
+        fixedUrl = fixedUrl.replace(/^http:\/\/https:\/\//i, 'https://');
+        fixed = true;
+    }
+    if (fixedUrl.match(/^https:\/\/http:\/\//i)) {
+        fixedUrl = fixedUrl.replace(/^https:\/\/http:\/\//i, 'https://');
+        fixed = true;
+    }
+    if (fixedUrl.match(/^(https?)\/\//i)) {
+        fixedUrl = fixedUrl.replace(/^(https?)\/\//i, '$1://');
+        fixed = true;
+    }
+    if (fixedUrl.match(/^(https?:\/\/)\//)) {
+        fixedUrl = fixedUrl.replace(/^(https?:\/\/)\//, '$1');
+        fixed = true;
+    }
+    const protocolMatch = fixedUrl.match(/^(https?:\/\/)(.*)$/i);
+    if (protocolMatch) {
+        const protocol = protocolMatch[1];
+        const path = protocolMatch[2];
+        const fixedPath = path.replace(/\/+/g, '/');
+        fixedUrl = protocol + fixedPath;
+        if (path !== fixedPath) {
+            fixed = true;
+        }
+    }
+    if (!fixedUrl.match(/^https?:\/\//i)) {
+        const host = fixedUrl.split('/')[0]?.split(':')[0] || '';
+        const isLocal = /^(localhost|127\.0\.0\.1|.*\.local|.*\.localdomain|.*\.lndo\.site)$/i.test(host);
+        fixedUrl = `${isLocal ? 'http' : 'https'}://${fixedUrl}`;
+        fixed = true;
+    }
+    const urlObj = new URL(fixedUrl);
+    if (urlObj.protocol !== 'http:' && urlObj.protocol !== 'https:') {
+        throw new Error(`Invalid URL protocol: ${urlObj.protocol}`);
+    }
+    if (!urlObj.hostname || urlObj.hostname.length === 0) {
+        throw new Error('Invalid hostname');
+    }
+    if (urlObj.port === '80' && urlObj.protocol === 'http:') {
+        urlObj.port = '';
+    }
+    if (urlObj.port === '443' && urlObj.protocol === 'https:') {
+        urlObj.port = '';
+    }
+    return {
+        url: urlObj.toString().replace(/\/$/, ''),
+        fixed,
+    };
+}
+export function normalizeConfig(config, sourceLabel, persistPath) {
+    if (!config?.sites || config.sites.length === 0) {
+        throw new Error(`No WordPress sites configured in ${sourceLabel}`);
+    }
+    let changed = false;
+    const normalizedSites = config.sites.map((site, index) => {
+        if (!site.id || !site.name || !site.url || !site.apiKey) {
+            throw new Error(`Site ${index + 1} is missing required fields (id, name, url, apiKey)`);
+        }
+        const validated = validateAndFixSiteUrl(site.url);
+        if (validated.fixed) {
+            changed = true;
+            console.warn(`Warning: Site "${site.name}" had malformed URL: ${site.url}`);
+            console.warn(`  Auto-fixed to: ${validated.url}`);
+        }
+        if (!site.apiKey.startsWith('respira_')) {
+            console.warn(`Warning: API key for "${site.name}" doesn't start with "respira_" prefix`);
+        }
         return {
-            sites: [
-                {
-                    id: 'env-site',
-                    name: 'WordPress (from env)',
-                    url,
-                    apiKey: envKey,
-                    default: true,
-                },
-            ],
-            preferences: {
-                autoDuplicate: true,
-                securityChecks: true,
-            },
+            ...site,
+            url: validated.url,
         };
+    });
+    const normalizedConfig = {
+        ...config,
+        sites: normalizedSites,
+        preferences: {
+            autoDuplicate: config.preferences?.autoDuplicate ?? true,
+            securityChecks: config.preferences?.securityChecks ?? true,
+        },
+    };
+    if (changed && persistPath) {
+        writeConfig(normalizedConfig, persistPath);
     }
-    if (!existsSync(CONFIG_FILE)) {
-        console.error('No configuration file found. Creating default configuration...');
-        console.error(`Please edit ${CONFIG_FILE} to add your WordPress sites.`);
-        // Create directory if it doesn't exist
-        if (!existsSync(CONFIG_DIR)) {
-            mkdirSync(CONFIG_DIR, { recursive: true });
-        }
-        // Create default config
-        const exampleConfig = {
-            sites: [
-                {
-                    id: 'example-site',
-                    name: 'My WordPress Site',
-                    url: 'https://example.com',
-                    apiKey: 'respira_your-api-key-here',
-                    default: true,
-                },
-            ],
-            preferences: {
-                autoDuplicate: true,
-                securityChecks: true,
+    return normalizedConfig;
+}
+function readConfigFromPath(path, sourceLabel, persistFixes = false) {
+    const configData = readFileSync(path, 'utf-8');
+    const parsed = JSON.parse(configData);
+    return normalizeConfig(parsed, sourceLabel, persistFixes ? path : undefined);
+}
+export function readConfigFromBase64(encoded) {
+    const raw = Buffer.from(encoded, 'base64').toString('utf8');
+    const parsed = JSON.parse(raw);
+    return normalizeConfig(parsed, 'RESPIRA_CONFIG_B64');
+}
+function ensureDefaultConfigFile() {
+    console.error('No configuration file found. Creating default configuration...');
+    console.error(`Please edit ${CONFIG_FILE} to add your WordPress sites.`);
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    saveConfig({
+        sites: [
+            {
+                id: 'example-site',
+                name: 'My WordPress Site',
+                url: 'https://example.com',
+                apiKey: 'respira_your-api-key-here',
+                default: true,
             },
-        };
-        saveConfig(exampleConfig);
-        throw new Error(`Configuration file created at ${CONFIG_FILE}\n` +
-            'Please update it with your WordPress site URL and API key, then run again.');
+        ],
+        preferences: {
+            autoDuplicate: true,
+            securityChecks: true,
+        },
+    });
+    throw new Error(`Configuration file created at ${CONFIG_FILE}\n` +
+        'Please update it with your WordPress site URL and API key, then run again.');
+}
+function loadEnvSingleSiteConfig() {
+    const envUrl = process.env.WORDPRESS_URL?.trim();
+    const envKey = process.env.WORDPRESS_API_KEY?.trim();
+    if (!envUrl || !envKey) {
+        return null;
+    }
+    const validated = validateAndFixSiteUrl(envUrl);
+    return {
+        sites: [
+            {
+                id: 'env-site',
+                name: 'WordPress (from env)',
+                url: validated.url,
+                apiKey: envKey,
+                default: true,
+            },
+        ],
+        preferences: {
+            autoDuplicate: true,
+            securityChecks: true,
+        },
+    };
+}
+function writeConfig(config, path) {
+    const targetDir = dirname(path);
+    if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
     }
+    writeFileSync(path, JSON.stringify(config, null, 2));
+}
+/**
+ * Load configuration from inline base64, explicit file path, default file, or env vars.
+ *
+ * Precedence by default:
+ * 1. RESPIRA_CONFIG_B64
+ * 2. RESPIRA_CONFIG_FILE
+ * 3. ~/.respira/config.json
+ * 4. WORDPRESS_URL + WORDPRESS_API_KEY
+ *
+ * Set RESPIRA_CONFIG_MODE=env to force env-only mode for single-site setups.
+ */
+export function loadConfig() {
+    const forcedMode = process.env.RESPIRA_CONFIG_MODE?.trim();
     try {
-        const configData = readFileSync(CONFIG_FILE, 'utf-8');
-        const config = JSON.parse(configData);
-        // Validate configuration
-        if (!config.sites || config.sites.length === 0) {
-            throw new Error('No WordPress sites configured in config.json');
-        }
-        // Validate each site
-        config.sites.forEach((site, index) => {
-            if (!site.id || !site.name || !site.url || !site.apiKey) {
-                throw new Error(`Site ${index + 1} is missing required fields (id, name, url, apiKey)`);
-            }
-            if (!site.apiKey.startsWith('respira_')) {
-                console.warn(`Warning: API key for "${site.name}" doesn't start with "respira_" prefix`);
-            }
-            // Validate and fix URL
-            let fixedUrl = site.url.trim();
-            let urlFixed = false;
-            // Fix duplicate protocols (https://https://, http://http://, etc.) - preserve original protocol
-            const dupProtocolMatch = fixedUrl.match(/^(https?:\/\/){2,}/i);
-            if (dupProtocolMatch) {
-                const firstProtocol = fixedUrl.startsWith('https') ? 'https://' : 'http://';
-                fixedUrl = fixedUrl.replace(/^(https?:\/\/)+/i, firstProtocol);
-                urlFixed = true;
-            }
-            // Fix mixed protocols (http://https://, https://http://)
-            if (fixedUrl.match(/^http:\/\/https:\/\//i)) {
-                fixedUrl = fixedUrl.replace(/^http:\/\/https:\/\//i, 'https://');
-                urlFixed = true;
-            }
-            if (fixedUrl.match(/^https:\/\/http:\/\//i)) {
-                fixedUrl = fixedUrl.replace(/^https:\/\/http:\/\//i, 'https://');
-                urlFixed = true;
-            }
-            // Fix malformed protocols (https//, http//)
-            if (fixedUrl.match(/^(https?)\/\//i)) {
-                fixedUrl = fixedUrl.replace(/^(https?)\/\//i, '$1://');
-                urlFixed = true;
-            }
-            // Fix triple slashes (https:///example.com)
-            if (fixedUrl.match(/^(https?:\/\/)\//)) {
-                fixedUrl = fixedUrl.replace(/^(https?:\/\/)\//, '$1');
-                urlFixed = true;
+        if (forcedMode === 'env') {
+            const envConfig = loadEnvSingleSiteConfig();
+            if (!envConfig) {
+                throw new Error('RESPIRA_CONFIG_MODE=env requires WORDPRESS_URL and WORDPRESS_API_KEY.');
             }
-            // Remove multiple consecutive slashes (except after protocol)
-            // Split by protocol, fix slashes in path, then rejoin
-            const protocolMatch = fixedUrl.match(/^(https?:\/\/)(.*)$/i);
-            if (protocolMatch) {
-                const protocol = protocolMatch[1];
-                const path = protocolMatch[2];
-                const fixedPath = path.replace(/\/+/g, '/');
-                fixedUrl = protocol + fixedPath;
-                if (path !== fixedPath) {
-                    urlFixed = true;
-                }
-            }
-            // Validate URL format
-            try {
-                // Add protocol if missing - use http for local dev (Local, Lando, etc.)
-                if (!fixedUrl.match(/^https?:\/\//i)) {
-                    const host = fixedUrl.split('/')[0]?.split(':')[0] || '';
-                    const isLocal = /^(localhost|127\.0\.0\.1|.*\.local|.*\.localdomain|.*\.lndo\.site)$/i.test(host);
-                    fixedUrl = `${isLocal ? 'http' : 'https'}://${fixedUrl}`;
-                    urlFixed = true;
-                }
-                const urlObj = new URL(fixedUrl);
-                // Ensure protocol is http or https
-                if (urlObj.protocol !== 'http:' && urlObj.protocol !== 'https:') {
-                    throw new Error(`Site ${index + 1} ("${site.name}") has invalid URL protocol: ${urlObj.protocol}`);
-                }
-                // Validate hostname
-                if (!urlObj.hostname || urlObj.hostname.length === 0) {
-                    throw new Error(`Site ${index + 1} ("${site.name}") has invalid hostname`);
-                }
-                // Remove default ports
-                if (urlObj.port === '80' && urlObj.protocol === 'http:') {
-                    urlObj.port = '';
-                }
-                if (urlObj.port === '443' && urlObj.protocol === 'https:') {
-                    urlObj.port = '';
-                }
-                // Update site URL if it was fixed
-                if (urlFixed) {
-                    const normalizedUrl = urlObj.toString().replace(/\/$/, '');
-                    console.warn(`Warning: Site "${site.name}" had malformed URL: ${site.url}`);
-                    console.warn(`  Auto-fixed to: ${normalizedUrl}`);
-                    site.url = normalizedUrl;
-                    // Save fixed config back
-                    saveConfig(config);
-                }
-            }
-            catch (e) {
-                if (e instanceof TypeError && e.message.includes('Invalid URL')) {
-                    throw new Error(`Site ${index + 1} ("${site.name}") has invalid URL: ${site.url}`);
-                }
-                throw e;
+            return envConfig;
+        }
+        const inlineConfig = process.env.RESPIRA_CONFIG_B64?.trim();
+        if (inlineConfig) {
+            return readConfigFromBase64(inlineConfig);
+        }
+        const explicitPath = process.env.RESPIRA_CONFIG_FILE?.trim();
+        if (explicitPath) {
+            if (!existsSync(explicitPath)) {
+                throw new Error(`RESPIRA_CONFIG_FILE points to a missing file: ${explicitPath}`);
             }
-        });
-        return config;
+            return readConfigFromPath(explicitPath, explicitPath, true);
+        }
+        if (existsSync(CONFIG_FILE)) {
+            return readConfigFromPath(CONFIG_FILE, CONFIG_FILE, true);
+        }
+        const envConfig = loadEnvSingleSiteConfig();
+        if (envConfig) {
+            return envConfig;
+        }
+        return ensureDefaultConfigFile();
     }
     catch (error) {
-        if (error.code === 'ENOENT') {
-            return DEFAULT_CONFIG;
-        }
         if (error instanceof SyntaxError) {
-            throw new Error(`Invalid JSON in config file: ${CONFIG_FILE}\n${error.message}`);
+            throw new Error(`Invalid JSON in configuration: ${error.message}`);
         }
         const errorMessage = error?.message || error?.toString() || 'Unknown error';
-        throw new Error(`Failed to load configuration from ${CONFIG_FILE}: ${errorMessage}`);
+        throw new Error(`Failed to load Respira configuration: ${errorMessage}`);
     }
 }
 /**
- * Save configuration to file
+ * Save configuration to the default Respira config file.
  */
 export function saveConfig(config) {
     try {
-        if (!existsSync(CONFIG_DIR)) {
-            mkdirSync(CONFIG_DIR, { recursive: true });
-        }
-        writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+        writeConfig(config, CONFIG_FILE);
         console.error(`Configuration saved to ${CONFIG_FILE}`);
     }
     catch (error) {
         throw new Error(`Failed to save configuration: ${error.message}`);
     }
 }
+/**
+ * Save configuration to an explicit file path.
+ */
+export function saveConfigToPath(config, path) {
+    try {
+        writeConfig(config, path);
+        console.error(`Configuration saved to ${path}`);
+    }
+    catch (error) {
+        throw new Error(`Failed to save configuration to ${path}: ${error.message}`);
+    }
+}
 /**
  * Add a new site to configuration
  */
 export function addSite(site) {
     const config = loadConfig();
-    // Check for duplicate ID
-    if (config.sites.some((s) => s.id === site.id)) {
+    if (config.sites.some((existing) => existing.id === site.id)) {
         throw new Error(`Site with ID "${site.id}" already exists`);
     }
-    // If this is the first site, make it default
     if (config.sites.length === 0) {
         site.default = true;
     }
@@ -212,13 +257,12 @@ export function addSite(site) {
  */
 export function removeSite(siteId) {
     const config = loadConfig();
-    const index = config.sites.findIndex((s) => s.id === siteId);
+    const index = config.sites.findIndex((site) => site.id === siteId);
     if (index === -1) {
         throw new Error(`Site with ID "${siteId}" not found`);
     }
     config.sites.splice(index, 1);
-    // If we removed the default site, make the first site default
-    if (config.sites.length > 0 && !config.sites.some((s) => s.default)) {
+    if (config.sites.length > 0 && !config.sites.some((site) => site.default)) {
         config.sites[0].default = true;
     }
     saveConfig(config);
@@ -228,15 +272,13 @@ export function removeSite(siteId) {
  */
 export function setDefaultSite(siteId) {
     const config = loadConfig();
-    const site = config.sites.find((s) => s.id === siteId);
+    const site = config.sites.find((candidate) => candidate.id === siteId);
     if (!site) {
         throw new Error(`Site with ID "${siteId}" not found`);
     }
-    // Remove default from all sites
-    config.sites.forEach((s) => {
-        s.default = false;
+    config.sites.forEach((candidate) => {
+        candidate.default = false;
     });
-    // Set new default
     site.default = true;
     saveConfig(config);
 }
@@ -245,7 +287,7 @@ export function setDefaultSite(siteId) {
  */
 export async function testConnection(siteId) {
     const config = loadConfig();
-    const site = config.sites.find((s) => s.id === siteId);
+    const site = config.sites.find((candidate) => candidate.id === siteId);
     if (!site) {
         throw new Error(`Site with ID "${siteId}" not found`);
     }

package/dist/config.js.map

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

package/dist/discovery/abilities.js

@@ -71,12 +71,12 @@ export async function discoverAbilities(siteUrl, apiKey) {
         result.message =
             'This site has the WordPress Abilities API and MCP Adapter installed. ' +
                 'Respira abilities are registered and discoverable through the official adapter. ' +
-                'You can use either this standalone MCP server or the WordPress MCP Adapter path.';
+                'You can use the standalone MCP server, the adapter default/public server, or the dedicated Respira adapter server side by side.';
     }
     else if (result.abilitiesApiAvailable && !result.respiraAbilitiesRegistered) {
         result.message =
             'This site has the WordPress Abilities API but Respira abilities are not registered. ' +
-                'Update the Respira plugin to v2.0+ to register abilities automatically.';
+                'Update the Respira plugin to a current 4.x build so abilities are registered automatically.';
     }
     else if (result.abilitiesApiAvailable) {
         result.message =