@automattic/mcp-wordpress-remote 0.2.16 → 0.2.18

package/README.md

@@ -45,6 +45,55 @@ Add to your MCP client configuration (e.g., Claude Desktop's `claude_desktop_con
 }
 ```
 
+### Custom Headers
+
+You can add custom headers to all API requests using the `CUSTOM_HEADERS` environment variable. This is useful for API keys, custom authentication, or other header requirements.
+
+#### JSON Format (Recommended):
+```json
+{
+  "mcpServers": {
+    "wordpress": {
+      "command": "npx",
+      "args": ["-y", "@automattic/mcp-wordpress-remote"],
+      "env": {
+        "WP_API_URL": "https://your-wordpress-site.com",
+        "CUSTOM_HEADERS": "{\"X-MCP-API-Key\": \"*Ibo7tweixlbfuwaiufxgakjyefctwajcetb*\", \"X-Custom-Header\": \"value\"}"
+      }
+    }
+  }
+}
+```
+
+#### Comma-Separated Format:
+```json
+{
+  "mcpServers": {
+    "wordpress": {
+      "command": "npx",
+      "args": ["-y", "@automattic/mcp-wordpress-remote"],
+      "env": {
+        "WP_API_URL": "https://your-wordpress-site.com",
+        "CUSTOM_HEADERS": "X-MCP-API-Key:IOskncfyes78U8on3q7ry43o487tybrc,X-Custom-Header:value"
+      }
+    }
+  }
+}
+```
+
+#### Command Line Usage:
+```bash
+CUSTOM_HEADERS='{"X-MCP-API-Key": "wc_mcp_FaQduhQcW0mfVaZgP3yaaqDuXaZ3mw7j"}' \
+WP_API_URL="https://your-site.com" \
+npx @automattic/mcp-wordpress-remote
+```
+
+Custom headers are included in:
+- All WordPress API requests
+- OAuth discovery requests
+- OAuth token exchange requests
+- OAuth client registration requests
+
 ### First Run
 
 1. **Start your MCP client** (Claude Desktop, etc.)

package/dist/lib.d.ts

@@ -12,7 +12,7 @@ interface WordPressResponse {
     [key: string]: any;
 }
 
-declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.16";
+declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.18";
 /**
  * Centralized configuration for MCP WordPress Remote
  * All default values are defined here and can be overridden via environment variables
@@ -40,6 +40,7 @@ declare const CONFIG: {
     readonly JWT_TOKEN: string | undefined;
     readonly WOO_CUSTOMER_KEY: string | undefined;
     readonly WOO_CUSTOMER_SECRET: string | undefined;
+    readonly CUSTOM_HEADERS: string;
     readonly NODE_ENV: string;
 };
 /**
@@ -84,6 +85,8 @@ declare const getConfig: () => {
     wooCustomerKey: string | undefined;
     /** WooCommerce customer secret */
     wooCustomerSecret: string | undefined;
+    /** Custom headers for API requests */
+    customHeaders: string;
     /** Current environment */
     nodeEnv: string;
 };
@@ -91,6 +94,18 @@ declare const getConfig: () => {
  * Get default OAuth scopes
  */
 declare function getDefaultOAuthScopes(): string[];
+/**
+ * Parse custom headers from environment variable
+ * Supports both JSON format and comma-separated format
+ *
+ * JSON format: {"X-MCP-API-Key": "value", "X-Custom-Header": "value"}
+ * Comma format: X-MCP-API-Key:value,X-Custom-Header:value
+ */
+declare function parseCustomHeaders(customHeadersString: string): Record<string, string>;
+/**
+ * Get parsed custom headers
+ */
+declare function getCustomHeaders(): Record<string, string>;
 /**
  * Validation function for required configuration
  */
@@ -128,6 +143,8 @@ declare const logger: {
     config: (message: string, level?: LogLevel, ...args: any[]) => void;
 };
 
+declare function wpRequest(requestData: any, useJsonRpc?: boolean): Promise<WordPressResponse>;
+
 /**
  * WordPress OAuth types and error definitions
  * Updated for MCP Authorization specification 2025-06-18 compliance
@@ -202,4 +219,4 @@ declare function isConfigError(error: any): error is ConfigError;
 declare function isAuthError(error: any): error is AuthError;
 declare function isAPIError(error: any): error is APIError;
 
-export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getConfig, getDefaultOAuthScopes, isAPIError, isAuthError, isConfigError, isOAuthError, log, logger, validateConfig };
+export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getConfig, getCustomHeaders, getDefaultOAuthScopes, isAPIError, isAuthError, isConfigError, isOAuthError, log, logger, parseCustomHeaders, validateConfig, wpRequest };