mcp-wordpress 2.10.0 → 2.10.2

package/docs/api/tools/wp_update_site_settings.md

@@ -6,11 +6,11 @@ Updates one or more general settings for a WordPress site.
 
 ## Parameters
 
-| Parameter | Type | Required | Description | Default | Examples |
-|-----------|------|----------|-------------|---------|----------|
-| `title` | `string` | ❌ | The title of the site. | - | `My Blog Post`, `Hello World` |
-| `description` | `string` | ❌ | The tagline or description of the site. | - | `example` |
-| `timezone` | `string` | ❌ | A city in the same timezone, e.g., 'America/New_York'. | - | `example` |
+| Parameter     | Type     | Required | Description                                            | Default | Examples                      |
+| ------------- | -------- | -------- | ------------------------------------------------------ | ------- | ----------------------------- |
+| `title`       | `string` | ❌       | The title of the site.                                 | -       | `My Blog Post`, `Hello World` |
+| `description` | `string` | ❌       | The tagline or description of the site.                | -       | `example`                     |
+| `timezone`    | `string` | ❌       | A city in the same timezone, e.g., 'America/New_York'. | -       | `example`                     |
 
 ## Examples
 
@@ -19,11 +19,13 @@ Updates one or more general settings for a WordPress site.
 Simple example of using wp_update_site_settings
 
 **Command:**
+
 ```bash
-wp_update_site_settings 
+wp_update_site_settings
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -36,6 +38,7 @@ wp_update_site_settings
 ```
 
 **Error Example (Authentication failure):**
+
 ```json
 {
   "error": "Authentication failed",
@@ -43,17 +46,18 @@ wp_update_site_settings
 }
 ```
 
-
 ### Advanced site Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
+
 ```bash
 wp_update_site_settings --title="Example Post Title" --description="example_value" --timezone="example_value"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -65,13 +69,6 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
 }
 ```
 
-
-
-
-
-
-
-
 ## Response Format
 
 **Return Type:** `site`
@@ -94,34 +91,24 @@ wp_update_site_settings --title="Example Post Title" --description="example_valu
 
 ### AUTHENTICATION_FAILED
 
-**Message:** Authentication failed  
-**Description:** Invalid credentials or insufficient permissions  
-**Resolution:** Check your authentication credentials and user permissions
-
+**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
+Check your authentication credentials and user permissions
 
 ### VALIDATION_ERROR
 
-**Message:** Parameter validation failed  
-**Description:** One or more required parameters are missing or invalid  
+**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
 **Resolution:** Review the required parameters and their formats
 
-
 ### NOT_FOUND
 
-**Message:** Resource not found  
-**Description:** The requested resource does not exist  
-**Resolution:** Verify the resource ID and ensure it exists
-
+**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
+resource ID and ensure it exists
 
 ### PERMISSION_DENIED
 
-**Message:** Insufficient permissions  
-**Description:** The user does not have permission to perform this action  
+**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
 **Resolution:** Contact an administrator to grant the necessary permissions
 
-
-
-
 ---
 
-*Generated automatically from tool definitions - Do not edit manually*
+_Generated automatically from tool definitions - Do not edit manually_

package/docs/api/tools/wp_update_tag.md

@@ -6,10 +6,10 @@ Updates an existing tag.
 
 ## Parameters
 
-| Parameter | Type | Required | Description | Default | Examples |
-|-----------|------|----------|-------------|---------|----------|
-| `id` | `number` | ✅ | The ID of the tag to update. | - | `123`, `456` |
-| `name` | `string` | ❌ | The new name for the tag. | - | `example` |
+| Parameter | Type     | Required | Description                  | Default | Examples     |
+| --------- | -------- | -------- | ---------------------------- | ------- | ------------ |
+| `id`      | `number` | ✅       | The ID of the tag to update. | -       | `123`, `456` |
+| `name`    | `string` | ❌       | The new name for the tag.    | -       | `example`    |
 
 ## Examples
 
@@ -18,11 +18,13 @@ Updates an existing tag.
 Simple example of using wp_update_tag
 
 **Command:**
+
 ```bash
 wp_update_tag --id="123"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -35,6 +37,7 @@ wp_update_tag --id="123"
 ```
 
 **Error Example (Authentication failure):**
+
 ```json
 {
   "error": "Authentication failed",
@@ -42,11 +45,6 @@ wp_update_tag --id="123"
 }
 ```
 
-
-
-
-
-
 ## Response Format
 
 **Return Type:** `taxonomy`
@@ -69,34 +67,24 @@ wp_update_tag --id="123"
 
 ### AUTHENTICATION_FAILED
 
-**Message:** Authentication failed  
-**Description:** Invalid credentials or insufficient permissions  
-**Resolution:** Check your authentication credentials and user permissions
-
+**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
+Check your authentication credentials and user permissions
 
 ### VALIDATION_ERROR
 
-**Message:** Parameter validation failed  
-**Description:** One or more required parameters are missing or invalid  
+**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
 **Resolution:** Review the required parameters and their formats
 
-
 ### NOT_FOUND
 
-**Message:** Resource not found  
-**Description:** The requested resource does not exist  
-**Resolution:** Verify the resource ID and ensure it exists
-
+**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
+resource ID and ensure it exists
 
 ### PERMISSION_DENIED
 
-**Message:** Insufficient permissions  
-**Description:** The user does not have permission to perform this action  
+**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
 **Resolution:** Contact an administrator to grant the necessary permissions
 
-
-
-
 ---
 
-*Generated automatically from tool definitions - Do not edit manually*
+_Generated automatically from tool definitions - Do not edit manually_

package/docs/api/tools/wp_update_user.md

@@ -6,11 +6,11 @@ Updates an existing user.
 
 ## Parameters
 
-| Parameter | Type | Required | Description | Default | Examples |
-|-----------|------|----------|-------------|---------|----------|
-| `id` | `number` | ✅ | The ID of the user to update. | - | `123`, `456` |
-| `email` | `string` | ❌ | The new email address for the user. | - | `user@example.com`, `admin@site.com` |
-| `name` | `string` | ❌ | The new display name for the user. | - | `example` |
+| Parameter | Type     | Required | Description                         | Default | Examples                             |
+| --------- | -------- | -------- | ----------------------------------- | ------- | ------------------------------------ |
+| `id`      | `number` | ✅       | The ID of the user to update.       | -       | `123`, `456`                         |
+| `email`   | `string` | ❌       | The new email address for the user. | -       | `user@example.com`, `admin@site.com` |
+| `name`    | `string` | ❌       | The new display name for the user.  | -       | `example`                            |
 
 ## Examples
 
@@ -19,11 +19,13 @@ Updates an existing user.
 Simple example of using wp_update_user
 
 **Command:**
+
 ```bash
 wp_update_user --id="123"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -36,6 +38,7 @@ wp_update_user --id="123"
 ```
 
 **Error Example (Authentication failure):**
+
 ```json
 {
   "error": "Authentication failed",
@@ -43,17 +46,18 @@ wp_update_user --id="123"
 }
 ```
 
-
 ### Advanced user Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
+
 ```bash
 wp_update_user --id="123" --email="user@example.com" --name="example_value"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -65,11 +69,6 @@ wp_update_user --id="123" --email="user@example.com" --name="example_value"
 }
 ```
 
-
-
-
-
-
 ## Required Permissions
 
 This tool requires the following WordPress user capabilities:
@@ -78,7 +77,6 @@ This tool requires the following WordPress user capabilities:
 
 **Note:** The authenticated user must have these capabilities to successfully execute this tool.
 
-
 ## Response Format
 
 **Return Type:** `user`
@@ -101,34 +99,24 @@ This tool requires the following WordPress user capabilities:
 
 ### AUTHENTICATION_FAILED
 
-**Message:** Authentication failed  
-**Description:** Invalid credentials or insufficient permissions  
-**Resolution:** Check your authentication credentials and user permissions
-
+**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
+Check your authentication credentials and user permissions
 
 ### VALIDATION_ERROR
 
-**Message:** Parameter validation failed  
-**Description:** One or more required parameters are missing or invalid  
+**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
 **Resolution:** Review the required parameters and their formats
 
-
 ### NOT_FOUND
 
-**Message:** Resource not found  
-**Description:** The requested resource does not exist  
-**Resolution:** Verify the resource ID and ensure it exists
-
+**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
+resource ID and ensure it exists
 
 ### PERMISSION_DENIED
 
-**Message:** Insufficient permissions  
-**Description:** The user does not have permission to perform this action  
+**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
 **Resolution:** Contact an administrator to grant the necessary permissions
 
-
-
-
 ---
 
-*Generated automatically from tool definitions - Do not edit manually*
+_Generated automatically from tool definitions - Do not edit manually_

package/docs/api/tools/wp_upload_media.md

@@ -6,14 +6,14 @@ Uploads a file to the WordPress media library.
 
 ## Parameters
 
-| Parameter | Type | Required | Description | Default | Examples |
-|-----------|------|----------|-------------|---------|----------|
-| `file_path` | `string` | ✅ | The local, absolute path to the file to upload. | - | `example` |
-| `title` | `string` | ❌ | The title for the media item. | - | `My Blog Post`, `Hello World` |
-| `alt_text` | `string` | ❌ | Alternative text for the media item (for accessibility). | - | `example` |
-| `caption` | `string` | ❌ | The caption for the media item. | - | `example` |
-| `description` | `string` | ❌ | The description for the media item. | - | `example` |
-| `post` | `number` | ❌ | The ID of a post to attach this media to. | - | `example` |
+| Parameter     | Type     | Required | Description                                              | Default | Examples                      |
+| ------------- | -------- | -------- | -------------------------------------------------------- | ------- | ----------------------------- |
+| `file_path`   | `string` | ✅       | The local, absolute path to the file to upload.          | -       | `example`                     |
+| `title`       | `string` | ❌       | The title for the media item.                            | -       | `My Blog Post`, `Hello World` |
+| `alt_text`    | `string` | ❌       | Alternative text for the media item (for accessibility). | -       | `example`                     |
+| `caption`     | `string` | ❌       | The caption for the media item.                          | -       | `example`                     |
+| `description` | `string` | ❌       | The description for the media item.                      | -       | `example`                     |
+| `post`        | `number` | ❌       | The ID of a post to attach this media to.                | -       | `example`                     |
 
 ## Examples
 
@@ -22,11 +22,13 @@ Uploads a file to the WordPress media library.
 Simple example of using wp_upload_media
 
 **Command:**
+
 ```bash
 wp_upload_media --file_path="example_value"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -36,6 +38,7 @@ wp_upload_media --file_path="example_value"
 ```
 
 **Error Example (Authentication failure):**
+
 ```json
 {
   "error": "Authentication failed",
@@ -43,17 +46,18 @@ wp_upload_media --file_path="example_value"
 }
 ```
 
-
 ### Advanced media Configuration
 
 Comprehensive example using all available parameters
 
 **Command:**
+
 ```bash
 wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_text="example_value" --caption="example_value" --description="example_value" --post="example_value"
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -62,11 +66,6 @@ wp_upload_media --file_path="example_value" --title="Example Post Title" --alt_t
 }
 ```
 
-
-
-
-
-
 ## Required Permissions
 
 This tool requires the following WordPress user capabilities:
@@ -75,7 +74,6 @@ This tool requires the following WordPress user capabilities:
 
 **Note:** The authenticated user must have these capabilities to successfully execute this tool.
 
-
 ## Response Format
 
 **Return Type:** `object`
@@ -98,34 +96,24 @@ This tool requires the following WordPress user capabilities:
 
 ### AUTHENTICATION_FAILED
 
-**Message:** Authentication failed  
-**Description:** Invalid credentials or insufficient permissions  
-**Resolution:** Check your authentication credentials and user permissions
-
+**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
+Check your authentication credentials and user permissions
 
 ### VALIDATION_ERROR
 
-**Message:** Parameter validation failed  
-**Description:** One or more required parameters are missing or invalid  
+**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
 **Resolution:** Review the required parameters and their formats
 
-
 ### NOT_FOUND
 
-**Message:** Resource not found  
-**Description:** The requested resource does not exist  
-**Resolution:** Verify the resource ID and ensure it exists
-
+**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
+resource ID and ensure it exists
 
 ### PERMISSION_DENIED
 
-**Message:** Insufficient permissions  
-**Description:** The user does not have permission to perform this action  
+**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
 **Resolution:** Contact an administrator to grant the necessary permissions
 
-
-
-
 ---
 
-*Generated automatically from tool definitions - Do not edit manually*
+_Generated automatically from tool definitions - Do not edit manually_

package/docs/api/types/WordPressPost.md

@@ -6,12 +6,12 @@ WordPress blog post object
 
 ## Properties
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `id` | `number` | ✅ | Unique identifier |
-| `title` | `string` | ✅ | Post title |
-| `content` | `string` | ✅ | Post content |
-| `status` | `string` | ✅ | Publication status |
+| Property  | Type     | Required | Description        |
+| --------- | -------- | -------- | ------------------ |
+| `id`      | `number` | ✅       | Unique identifier  |
+| `title`   | `string` | ✅       | Post title         |
+| `content` | `string` | ✅       | Post content       |
+| `status`  | `string` | ✅       | Publication status |
 
 ## Example
 
@@ -23,17 +23,10 @@ WordPress blog post object
   "status": "publish",
   "date": "2024-01-01T00:00:00Z",
   "author": 1,
-  "categories": [
-    1
-  ],
-  "tags": [
-    1,
-    2
-  ],
+  "categories": [1],
+  "tags": [1, 2],
   "featured_media": 0,
   "excerpt": "A sample WordPress post",
   "slug": "welcome-to-wordpress"
 }
 ```
-
-

package/docs/code-improvements.md

@@ -7,6 +7,7 @@ Based on coverage analysis, the following areas need attention:
 ### Critical Areas (0% coverage)
 
 1. **Tool Implementations** (`src/tools/`):
+
    - site.ts (0% coverage)
    - taxonomies.ts (0% coverage)
    - users.ts (0% coverage)

package/docs/developer/GITHUB_ACTIONS_SETUP.md

@@ -9,8 +9,7 @@ NPM publishing.
 
 ### 1. NPM Publish Workflow (`.github/workflows/npm-publish.yml`)
 
-**Trigger**: When a GitHub release is created  
-**Purpose**: Automatically publish the package to NPM
+**Trigger**: When a GitHub release is created **Purpose**: Automatically publish the package to NPM
 
 **Features**:
 
@@ -58,6 +57,7 @@ gh release create v1.1.3 --title "Release v1.1.3" --notes "Release notes here"
 ### 1. Configure NPM Token
 
 1. **Generate NPM Token**:
+
    - Log in to [npmjs.com](https://npmjs.com)
    - Go to Account Settings → Access Tokens
    - Create an "Automation" token

package/docs/developer/MAINTENANCE.md

@@ -150,11 +150,13 @@ The following scripts help maintain file integrity:
 ### Monthly Tasks
 
 1. **Comprehensive Security Review**
+
    - Check `.gitignore` and `.npmignore` for new patterns
    - Review npm audit results
    - Verify no credentials in commit history
 
 2. **Documentation Updates**
+
    - Update README.md with new features
    - Review and update CLAUDE.md
    - Check all markdown files for accuracy
@@ -224,6 +226,7 @@ node_modules/
 ### Credential Management
 
 1. **Local Development:**
+
    - Store tokens in `~/.npmrc` or environment variables
    - Never commit `.npmrc` to version control
    - Use separate tokens for development vs. CI/CD
@@ -246,6 +249,7 @@ node_modules/
    ```
 
 2. **Credential Rotation:**
+
    - Revoke compromised NPM tokens
    - Rotate any exposed API keys
    - Update GitHub secrets

package/docs/developer/NPM_AUTH_SETUP.md

@@ -35,6 +35,7 @@ The project includes a pre-configured `.npmrc` file that uses environment variab
 ### Method 1: Using NPM Token (Recommended for Automation)
 
 1. **Create an NPM automation token**:
+
    - Log in to npmjs.com
    - Go to Account Settings → Access Tokens
    - Click "Generate New Token" → Choose "Automation" type
@@ -86,10 +87,12 @@ npm config set //registry.npmjs.org/:_authToken YOUR_NPM_TOKEN
 ## Security Best Practices
 
 1. **Never commit `.npmrc` with tokens** to version control
+
    - Add `.npmrc` to `.gitignore` if storing tokens there
    - Use environment variables for tokens
 
 2. **Use different tokens for different purposes**:
+
    - Personal development: Read-only or Publish token
    - CI/CD: Automation token (like your NPM_TOKEN in GitHub secrets)
    - Team projects: Shared organization tokens

package/docs/developer/RELEASE_PROCESS.md

@@ -336,6 +336,7 @@ For critical bugs requiring immediate fixes:
    ```
 
 3. **Create Pull Request**:
+
    - Target: `main` branch
    - Label: `hotfix`, `critical`
    - Skip normal review process if approved

package/docs/examples/multi-site-setup.md

@@ -515,10 +515,12 @@ Each site in the configuration maintains complete isolation:
 ### Common Problems
 
 1. **Site ID not found**
+
    - Verify the `id` field matches exactly
    - Check for typos in site parameter
 
 2. **Authentication fails for specific site**
+
    - Test each site's credentials individually
    - Regenerate application passwords if needed