mcp-wordpress 2.10.0 → 2.10.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -19
- package/bin/mcp-wordpress.js +3 -3
- package/bin/setup.js +140 -141
- package/bin/status.js +112 -114
- package/dist/client/MockWordPressClient.d.ts.map +1 -1
- package/dist/client/MockWordPressClient.js.map +1 -1
- package/dist/client/SEOWordPressClient.d.ts.map +1 -1
- package/dist/client/SEOWordPressClient.js +16 -14
- package/dist/client/SEOWordPressClient.js.map +1 -1
- package/dist/client/index.d.ts +6 -6
- package/dist/client/index.js +6 -6
- package/dist/client/managers/AuthManager.d.ts.map +1 -1
- package/dist/client/managers/AuthManager.js +2 -2
- package/dist/client/managers/AuthManager.js.map +1 -1
- package/dist/client/managers/AuthenticationManager.js +1 -1
- package/dist/client/managers/JWTAuthImplementation.d.ts.map +1 -1
- package/dist/client/managers/JWTAuthImplementation.js +7 -7
- package/dist/client/managers/JWTAuthImplementation.js.map +1 -1
- package/dist/client/managers/composed/MigrationAdapter.js +1 -1
- package/dist/client/managers/composed/index.d.ts +2 -2
- package/dist/client/managers/composed/index.d.ts.map +1 -1
- package/dist/client/managers/composed/index.js +1 -1
- package/dist/client/managers/composed/index.js.map +1 -1
- package/dist/client/managers/implementations/ErrorHandlerImpl.d.ts.map +1 -1
- package/dist/client/managers/implementations/ErrorHandlerImpl.js +2 -4
- package/dist/client/managers/implementations/ErrorHandlerImpl.js.map +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.d.ts.map +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.js +1 -1
- package/dist/client/managers/implementations/ParameterValidatorImpl.js.map +1 -1
- package/dist/client/managers/interfaces/ManagerInterfaces.d.ts.map +1 -1
- package/dist/config/index.d.ts +3 -3
- package/dist/config/index.js +3 -3
- package/dist/docs/MarkdownFormatter.d.ts.map +1 -1
- package/dist/docs/MarkdownFormatter.js +7 -7
- package/dist/docs/MarkdownFormatter.js.map +1 -1
- package/dist/performance/PerformanceAnalytics.d.ts.map +1 -1
- package/dist/performance/PerformanceAnalytics.js +3 -1
- package/dist/performance/PerformanceAnalytics.js.map +1 -1
- package/dist/security/InputValidator.js +1 -1
- package/dist/security/SecurityCIPipeline.js +1 -1
- package/dist/security/SecurityCIPipeline.js.map +1 -1
- package/dist/security/SecurityConfig.d.ts.map +1 -1
- package/dist/security/SecurityConfig.js +6 -2
- package/dist/security/SecurityConfig.js.map +1 -1
- package/dist/server/index.d.ts +2 -2
- package/dist/server/index.js +2 -2
- package/dist/tools/cache.d.ts.map +1 -1
- package/dist/tools/cache.js.map +1 -1
- package/dist/tools/comments.d.ts.map +1 -1
- package/dist/tools/comments.js.map +1 -1
- package/dist/tools/performance.d.ts.map +1 -1
- package/dist/tools/performance.js.map +1 -1
- package/dist/tools/posts/PostHandlers.d.ts.map +1 -1
- package/dist/tools/posts/PostHandlers.js.map +1 -1
- package/dist/tools/seo/SEOTools.d.ts.map +1 -1
- package/dist/tools/seo/SEOTools.js.map +1 -1
- package/dist/tools/seo/analyzers/ContentAnalyzer.d.ts.map +1 -1
- package/dist/tools/seo/analyzers/ContentAnalyzer.js.map +1 -1
- package/dist/types/enhanced.d.ts +17 -17
- package/dist/types/enhanced.d.ts.map +1 -1
- package/dist/types/enhanced.js +2 -2
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/requests.d.ts +16 -16
- package/dist/types/tools.d.ts +46 -46
- package/dist/types/tools.d.ts.map +1 -1
- package/dist/utils/index.d.ts +7 -7
- package/dist/utils/index.js +7 -7
- package/docs/ARCHITECTURE.md +17 -17
- package/docs/BADGE_UPDATES.md +11 -11
- package/docs/CACHING.md +2 -0
- package/docs/CI_CD_IMPROVEMENTS.md +8 -5
- package/docs/CONFIGURATION.md +76 -46
- package/docs/DOCKER_PUBLISHING_TROUBLESHOOTING.md +11 -2
- package/docs/EVALUATION.md +16 -21
- package/docs/INCREMENTAL_COVERAGE.md +7 -3
- package/docs/INSTALLATION.md +33 -19
- package/docs/PUBLISHING-TROUBLESHOOTING.md +3 -2
- package/docs/SECURITY.md +17 -15
- package/docs/SECURITY_TESTING.md +3 -0
- package/docs/TROUBLESHOOTING.md +85 -36
- package/docs/api/README.md +118 -125
- package/docs/api/categories/auth.md +3 -1
- package/docs/api/categories/cache.md +3 -1
- package/docs/api/categories/comment.md +3 -1
- package/docs/api/categories/media.md +3 -1
- package/docs/api/categories/page.md +3 -1
- package/docs/api/categories/performance.md +3 -1
- package/docs/api/categories/post.md +3 -1
- package/docs/api/categories/site.md +3 -1
- package/docs/api/categories/taxonomy.md +3 -1
- package/docs/api/categories/user.md +3 -1
- package/docs/api/openapi.json +114 -410
- package/docs/api/summary.json +1 -1
- package/docs/api/tools/wp_approve_comment.md +13 -25
- package/docs/api/tools/wp_cache_clear.md +17 -30
- package/docs/api/tools/wp_cache_info.md +16 -29
- package/docs/api/tools/wp_cache_stats.md +16 -29
- package/docs/api/tools/wp_cache_warm.md +16 -29
- package/docs/api/tools/wp_create_application_password.md +14 -26
- package/docs/api/tools/wp_create_category.md +14 -26
- package/docs/api/tools/wp_create_comment.md +18 -31
- package/docs/api/tools/wp_create_page.md +17 -29
- package/docs/api/tools/wp_create_post.md +25 -30
- package/docs/api/tools/wp_create_tag.md +13 -25
- package/docs/api/tools/wp_create_user.md +18 -30
- package/docs/api/tools/wp_delete_application_password.md +14 -26
- package/docs/api/tools/wp_delete_category.md +13 -25
- package/docs/api/tools/wp_delete_comment.md +14 -26
- package/docs/api/tools/wp_delete_media.md +14 -25
- package/docs/api/tools/wp_delete_page.md +14 -25
- package/docs/api/tools/wp_delete_post.md +17 -25
- package/docs/api/tools/wp_delete_tag.md +13 -25
- package/docs/api/tools/wp_delete_user.md +14 -25
- package/docs/api/tools/wp_get_application_passwords.md +13 -25
- package/docs/api/tools/wp_get_auth_status.md +12 -24
- package/docs/api/tools/wp_get_category.md +13 -25
- package/docs/api/tools/wp_get_comment.md +13 -25
- package/docs/api/tools/wp_get_current_user.md +17 -30
- package/docs/api/tools/wp_get_media.md +13 -25
- package/docs/api/tools/wp_get_page.md +13 -25
- package/docs/api/tools/wp_get_page_revisions.md +13 -25
- package/docs/api/tools/wp_get_post.md +16 -25
- package/docs/api/tools/wp_get_post_revisions.md +13 -25
- package/docs/api/tools/wp_get_site_settings.md +12 -23
- package/docs/api/tools/wp_get_tag.md +13 -25
- package/docs/api/tools/wp_get_user.md +13 -25
- package/docs/api/tools/wp_list_categories.md +15 -27
- package/docs/api/tools/wp_list_comments.md +15 -27
- package/docs/api/tools/wp_list_media.md +18 -31
- package/docs/api/tools/wp_list_pages.md +18 -31
- package/docs/api/tools/wp_list_posts.md +29 -41
- package/docs/api/tools/wp_list_tags.md +14 -26
- package/docs/api/tools/wp_list_users.md +20 -34
- package/docs/api/tools/wp_performance_alerts.md +22 -36
- package/docs/api/tools/wp_performance_benchmark.md +20 -34
- package/docs/api/tools/wp_performance_export.md +22 -36
- package/docs/api/tools/wp_performance_history.md +21 -35
- package/docs/api/tools/wp_performance_optimize.md +22 -36
- package/docs/api/tools/wp_performance_stats.md +20 -34
- package/docs/api/tools/wp_search_site.md +18 -32
- package/docs/api/tools/wp_spam_comment.md +13 -25
- package/docs/api/tools/wp_switch_auth_method.md +18 -31
- package/docs/api/tools/wp_test_auth.md +15 -30
- package/docs/api/tools/wp_update_category.md +14 -26
- package/docs/api/tools/wp_update_comment.md +17 -30
- package/docs/api/tools/wp_update_media.md +19 -32
- package/docs/api/tools/wp_update_page.md +18 -30
- package/docs/api/tools/wp_update_post.md +21 -30
- package/docs/api/tools/wp_update_site_settings.md +18 -31
- package/docs/api/tools/wp_update_tag.md +14 -26
- package/docs/api/tools/wp_update_user.md +17 -29
- package/docs/api/tools/wp_upload_media.md +20 -32
- package/docs/api/types/WordPressPost.md +8 -15
- package/docs/code-improvements.md +1 -0
- package/docs/developer/GITHUB_ACTIONS_SETUP.md +2 -2
- package/docs/developer/MAINTENANCE.md +4 -0
- package/docs/developer/NPM_AUTH_SETUP.md +3 -0
- package/docs/developer/RELEASE_PROCESS.md +1 -0
- package/docs/examples/multi-site-setup.md +2 -0
- package/docs/integrations/claude-desktop.md +14 -5
- package/docs/integrations/cline.md +1 -0
- package/docs/user-guides/DTX_SETUP.md +9 -8
- package/docs/user-guides/NPX_SETUP.md +5 -9
- package/docs/user-guides/SMITHERY_SETUP.md +5 -0
- package/docs/v2.2.0-resolution-demo.md +17 -2
- package/package.json +2 -1
- package/src/cache/__tests__/CacheManager.test.ts +4 -8
- package/src/client/MockWordPressClient.ts +5 -1
- package/src/client/SEOWordPressClient.ts +30 -26
- package/src/client/index.ts +6 -6
- package/src/client/managers/AuthManager.ts +16 -8
- package/src/client/managers/AuthenticationManager.ts +2 -2
- package/src/client/managers/JWTAuthImplementation.ts +24 -27
- package/src/client/managers/ManagersIndex.ts +1 -1
- package/src/client/managers/composed/MigrationAdapter.ts +1 -1
- package/src/client/managers/composed/index.ts +7 -7
- package/src/client/managers/implementations/ErrorHandlerImpl.ts +12 -26
- package/src/client/managers/implementations/ParameterValidatorImpl.ts +49 -49
- package/src/client/managers/interfaces/ManagerInterfaces.ts +13 -9
- package/src/config/index.ts +3 -3
- package/src/docs/MarkdownFormatter.ts +13 -9
- package/src/performance/PerformanceAnalytics.ts +9 -3
- package/src/security/InputValidator.ts +1 -1
- package/src/security/SecurityCIPipeline.ts +1 -1
- package/src/security/SecurityConfig.ts +9 -3
- package/src/server/index.ts +2 -2
- package/src/tools/cache.ts +3 -1
- package/src/tools/comments.ts +3 -1
- package/src/tools/performance.ts +7 -3
- package/src/tools/posts/PostHandlers.ts +3 -1
- package/src/tools/seo/SEOTools.ts +6 -2
- package/src/tools/seo/analyzers/ContentAnalyzer.ts +9 -3
- package/src/types/enhanced.ts +34 -34
- package/src/types/index.ts +13 -11
- package/src/types/requests.ts +19 -19
- package/src/types/tools.ts +137 -84
- package/src/utils/index.ts +7 -7
|
@@ -6,10 +6,10 @@ Lists categories from a WordPress site.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `search`
|
|
12
|
-
| `hide_empty` | `boolean` | ❌
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| ------------ | --------- | -------- | ---------------------------------------------- | ------- | ----------------------- |
|
|
11
|
+
| `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
|
|
12
|
+
| `hide_empty` | `boolean` | ❌ | Whether to hide categories with no posts. | - | `example` |
|
|
13
13
|
|
|
14
14
|
## Examples
|
|
15
15
|
|
|
@@ -18,11 +18,13 @@ Lists categories from a WordPress site.
|
|
|
18
18
|
Simple example of using wp_list_categories
|
|
19
19
|
|
|
20
20
|
**Command:**
|
|
21
|
+
|
|
21
22
|
```bash
|
|
22
|
-
wp_list_categories
|
|
23
|
+
wp_list_categories
|
|
23
24
|
```
|
|
24
25
|
|
|
25
26
|
**Response:**
|
|
27
|
+
|
|
26
28
|
```json
|
|
27
29
|
{
|
|
28
30
|
"success": true,
|
|
@@ -44,6 +46,7 @@ wp_list_categories
|
|
|
44
46
|
```
|
|
45
47
|
|
|
46
48
|
**Error Example (Authentication failure):**
|
|
49
|
+
|
|
47
50
|
```json
|
|
48
51
|
{
|
|
49
52
|
"error": "Authentication failed",
|
|
@@ -51,11 +54,6 @@ wp_list_categories
|
|
|
51
54
|
}
|
|
52
55
|
```
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
57
|
## Response Format
|
|
60
58
|
|
|
61
59
|
**Return Type:** `taxonomy[]`
|
|
@@ -78,34 +76,24 @@ wp_list_categories
|
|
|
78
76
|
|
|
79
77
|
### AUTHENTICATION_FAILED
|
|
80
78
|
|
|
81
|
-
**Message:** Authentication failed
|
|
82
|
-
|
|
83
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
84
|
-
|
|
79
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
80
|
+
Check your authentication credentials and user permissions
|
|
85
81
|
|
|
86
82
|
### VALIDATION_ERROR
|
|
87
83
|
|
|
88
|
-
**Message:** Parameter validation failed
|
|
89
|
-
**Description:** One or more required parameters are missing or invalid
|
|
84
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
90
85
|
**Resolution:** Review the required parameters and their formats
|
|
91
86
|
|
|
92
|
-
|
|
93
87
|
### NOT_FOUND
|
|
94
88
|
|
|
95
|
-
**Message:** Resource not found
|
|
96
|
-
|
|
97
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
98
|
-
|
|
89
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
90
|
+
resource ID and ensure it exists
|
|
99
91
|
|
|
100
92
|
### PERMISSION_DENIED
|
|
101
93
|
|
|
102
|
-
**Message:** Insufficient permissions
|
|
103
|
-
**Description:** The user does not have permission to perform this action
|
|
94
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
104
95
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
105
96
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
97
|
---
|
|
110
98
|
|
|
111
|
-
|
|
99
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,10 +6,10 @@ Lists comments from a WordPress site, with filters.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter | Type
|
|
10
|
-
|
|
11
|
-
| `post`
|
|
12
|
-
| `status`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| --------- | -------- | -------- | --------------------------------------------------------- | --------- | --------- |
|
|
11
|
+
| `post` | `number` | ❌ | Limit results to comments assigned to a specific post ID. | - | `example` |
|
|
12
|
+
| `status` | `string` | ❌ | Filter by comment status. | `publish` | `example` |
|
|
13
13
|
|
|
14
14
|
## Examples
|
|
15
15
|
|
|
@@ -18,11 +18,13 @@ Lists comments from a WordPress site, with filters.
|
|
|
18
18
|
Simple example of using wp_list_comments
|
|
19
19
|
|
|
20
20
|
**Command:**
|
|
21
|
+
|
|
21
22
|
```bash
|
|
22
|
-
wp_list_comments
|
|
23
|
+
wp_list_comments
|
|
23
24
|
```
|
|
24
25
|
|
|
25
26
|
**Response:**
|
|
27
|
+
|
|
26
28
|
```json
|
|
27
29
|
{
|
|
28
30
|
"success": true,
|
|
@@ -44,6 +46,7 @@ wp_list_comments
|
|
|
44
46
|
```
|
|
45
47
|
|
|
46
48
|
**Error Example (Authentication failure):**
|
|
49
|
+
|
|
47
50
|
```json
|
|
48
51
|
{
|
|
49
52
|
"error": "Authentication failed",
|
|
@@ -51,11 +54,6 @@ wp_list_comments
|
|
|
51
54
|
}
|
|
52
55
|
```
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
57
|
## Response Format
|
|
60
58
|
|
|
61
59
|
**Return Type:** `comment[]`
|
|
@@ -78,34 +76,24 @@ wp_list_comments
|
|
|
78
76
|
|
|
79
77
|
### AUTHENTICATION_FAILED
|
|
80
78
|
|
|
81
|
-
**Message:** Authentication failed
|
|
82
|
-
|
|
83
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
84
|
-
|
|
79
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
80
|
+
Check your authentication credentials and user permissions
|
|
85
81
|
|
|
86
82
|
### VALIDATION_ERROR
|
|
87
83
|
|
|
88
|
-
**Message:** Parameter validation failed
|
|
89
|
-
**Description:** One or more required parameters are missing or invalid
|
|
84
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
90
85
|
**Resolution:** Review the required parameters and their formats
|
|
91
86
|
|
|
92
|
-
|
|
93
87
|
### NOT_FOUND
|
|
94
88
|
|
|
95
|
-
**Message:** Resource not found
|
|
96
|
-
|
|
97
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
98
|
-
|
|
89
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
90
|
+
resource ID and ensure it exists
|
|
99
91
|
|
|
100
92
|
### PERMISSION_DENIED
|
|
101
93
|
|
|
102
|
-
**Message:** Insufficient permissions
|
|
103
|
-
**Description:** The user does not have permission to perform this action
|
|
94
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
104
95
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
105
96
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
97
|
---
|
|
110
98
|
|
|
111
|
-
|
|
99
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,11 +6,11 @@ Lists media items from a WordPress site, with filters.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `per_page`
|
|
12
|
-
| `search`
|
|
13
|
-
| `media_type` | `string` | ❌
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| ------------ | -------- | -------- | ---------------------------------------------- | ------- | ----------------------- |
|
|
11
|
+
| `per_page` | `number` | ❌ | Number of items to return per page (max 100). | `10` | `10`, `20` |
|
|
12
|
+
| `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
|
|
13
|
+
| `media_type` | `string` | ❌ | Limit results to a specific media type. | - | `example` |
|
|
14
14
|
|
|
15
15
|
## Examples
|
|
16
16
|
|
|
@@ -19,11 +19,13 @@ Lists media items from a WordPress site, with filters.
|
|
|
19
19
|
Simple example of using wp_list_media
|
|
20
20
|
|
|
21
21
|
**Command:**
|
|
22
|
+
|
|
22
23
|
```bash
|
|
23
|
-
wp_list_media
|
|
24
|
+
wp_list_media
|
|
24
25
|
```
|
|
25
26
|
|
|
26
27
|
**Response:**
|
|
28
|
+
|
|
27
29
|
```json
|
|
28
30
|
{
|
|
29
31
|
"success": true,
|
|
@@ -45,6 +47,7 @@ wp_list_media
|
|
|
45
47
|
```
|
|
46
48
|
|
|
47
49
|
**Error Example (Authentication failure):**
|
|
50
|
+
|
|
48
51
|
```json
|
|
49
52
|
{
|
|
50
53
|
"error": "Authentication failed",
|
|
@@ -52,17 +55,18 @@ wp_list_media
|
|
|
52
55
|
}
|
|
53
56
|
```
|
|
54
57
|
|
|
55
|
-
|
|
56
58
|
### Advanced media Configuration
|
|
57
59
|
|
|
58
60
|
Comprehensive example using all available parameters
|
|
59
61
|
|
|
60
62
|
**Command:**
|
|
63
|
+
|
|
61
64
|
```bash
|
|
62
65
|
wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
|
|
63
66
|
```
|
|
64
67
|
|
|
65
68
|
**Response:**
|
|
69
|
+
|
|
66
70
|
```json
|
|
67
71
|
{
|
|
68
72
|
"success": true,
|
|
@@ -83,13 +87,6 @@ wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
|
|
|
83
87
|
}
|
|
84
88
|
```
|
|
85
89
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
90
|
## Response Format
|
|
94
91
|
|
|
95
92
|
**Return Type:** `media[]`
|
|
@@ -112,34 +109,24 @@ wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
|
|
|
112
109
|
|
|
113
110
|
### AUTHENTICATION_FAILED
|
|
114
111
|
|
|
115
|
-
**Message:** Authentication failed
|
|
116
|
-
|
|
117
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
118
|
-
|
|
112
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
113
|
+
Check your authentication credentials and user permissions
|
|
119
114
|
|
|
120
115
|
### VALIDATION_ERROR
|
|
121
116
|
|
|
122
|
-
**Message:** Parameter validation failed
|
|
123
|
-
**Description:** One or more required parameters are missing or invalid
|
|
117
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
124
118
|
**Resolution:** Review the required parameters and their formats
|
|
125
119
|
|
|
126
|
-
|
|
127
120
|
### NOT_FOUND
|
|
128
121
|
|
|
129
|
-
**Message:** Resource not found
|
|
130
|
-
|
|
131
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
132
|
-
|
|
122
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
123
|
+
resource ID and ensure it exists
|
|
133
124
|
|
|
134
125
|
### PERMISSION_DENIED
|
|
135
126
|
|
|
136
|
-
**Message:** Insufficient permissions
|
|
137
|
-
**Description:** The user does not have permission to perform this action
|
|
127
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
138
128
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
139
129
|
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
130
|
---
|
|
144
131
|
|
|
145
|
-
|
|
132
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,11 +6,11 @@ Lists pages from a WordPress site, with filters.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter
|
|
10
|
-
|
|
11
|
-
| `per_page` | `number` | ❌
|
|
12
|
-
| `search`
|
|
13
|
-
| `status`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| ---------- | -------- | -------- | ---------------------------------------------- | --------- | ----------------------- |
|
|
11
|
+
| `per_page` | `number` | ❌ | Number of items to return per page (max 100). | `10` | `10`, `20` |
|
|
12
|
+
| `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
|
|
13
|
+
| `status` | `string` | ❌ | Filter by page status. | `publish` | `example` |
|
|
14
14
|
|
|
15
15
|
## Examples
|
|
16
16
|
|
|
@@ -19,11 +19,13 @@ Lists pages from a WordPress site, with filters.
|
|
|
19
19
|
Simple example of using wp_list_pages
|
|
20
20
|
|
|
21
21
|
**Command:**
|
|
22
|
+
|
|
22
23
|
```bash
|
|
23
|
-
wp_list_pages
|
|
24
|
+
wp_list_pages
|
|
24
25
|
```
|
|
25
26
|
|
|
26
27
|
**Response:**
|
|
28
|
+
|
|
27
29
|
```json
|
|
28
30
|
{
|
|
29
31
|
"success": true,
|
|
@@ -45,6 +47,7 @@ wp_list_pages
|
|
|
45
47
|
```
|
|
46
48
|
|
|
47
49
|
**Error Example (Authentication failure):**
|
|
50
|
+
|
|
48
51
|
```json
|
|
49
52
|
{
|
|
50
53
|
"error": "Authentication failed",
|
|
@@ -52,17 +55,18 @@ wp_list_pages
|
|
|
52
55
|
}
|
|
53
56
|
```
|
|
54
57
|
|
|
55
|
-
|
|
56
58
|
### Advanced page Configuration
|
|
57
59
|
|
|
58
60
|
Comprehensive example using all available parameters
|
|
59
61
|
|
|
60
62
|
**Command:**
|
|
63
|
+
|
|
61
64
|
```bash
|
|
62
65
|
wp_list_pages --per_page="10" --search="wordpress" --status="publish"
|
|
63
66
|
```
|
|
64
67
|
|
|
65
68
|
**Response:**
|
|
69
|
+
|
|
66
70
|
```json
|
|
67
71
|
{
|
|
68
72
|
"success": true,
|
|
@@ -83,13 +87,6 @@ wp_list_pages --per_page="10" --search="wordpress" --status="publish"
|
|
|
83
87
|
}
|
|
84
88
|
```
|
|
85
89
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
90
|
## Response Format
|
|
94
91
|
|
|
95
92
|
**Return Type:** `page[]`
|
|
@@ -112,34 +109,24 @@ wp_list_pages --per_page="10" --search="wordpress" --status="publish"
|
|
|
112
109
|
|
|
113
110
|
### AUTHENTICATION_FAILED
|
|
114
111
|
|
|
115
|
-
**Message:** Authentication failed
|
|
116
|
-
|
|
117
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
118
|
-
|
|
112
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
113
|
+
Check your authentication credentials and user permissions
|
|
119
114
|
|
|
120
115
|
### VALIDATION_ERROR
|
|
121
116
|
|
|
122
|
-
**Message:** Parameter validation failed
|
|
123
|
-
**Description:** One or more required parameters are missing or invalid
|
|
117
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
124
118
|
**Resolution:** Review the required parameters and their formats
|
|
125
119
|
|
|
126
|
-
|
|
127
120
|
### NOT_FOUND
|
|
128
121
|
|
|
129
|
-
**Message:** Resource not found
|
|
130
|
-
|
|
131
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
132
|
-
|
|
122
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
123
|
+
resource ID and ensure it exists
|
|
133
124
|
|
|
134
125
|
### PERMISSION_DENIED
|
|
135
126
|
|
|
136
|
-
**Message:** Insufficient permissions
|
|
137
|
-
**Description:** The user does not have permission to perform this action
|
|
127
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
138
128
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
139
129
|
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
130
|
---
|
|
144
131
|
|
|
145
|
-
|
|
132
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -2,25 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|

|
|
4
4
|
|
|
5
|
-
Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and
|
|
5
|
+
Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and
|
|
6
|
+
category/tag filtering with enhanced metadata display.
|
|
6
7
|
|
|
7
|
-
**Usage Examples:**
|
|
8
|
-
•
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
• Category filtering: `wp_list_posts --categories=[1,2,3]`
|
|
12
|
-
• Paginated results: `wp_list_posts --per_page=20 --page=2`
|
|
13
|
-
• Combined filters: `wp_list_posts --search="WordPress" --status="publish" --per_page=10`
|
|
8
|
+
**Usage Examples:** • Basic listing: `wp_list_posts` • Search posts: `wp_list_posts --search="AI trends"` • Filter by
|
|
9
|
+
status: `wp_list_posts --status="draft"` • Category filtering: `wp_list_posts --categories=[1,2,3]` • Paginated results:
|
|
10
|
+
`wp_list_posts --per_page=20 --page=2` • Combined filters:
|
|
11
|
+
`wp_list_posts --search="WordPress" --status="publish" --per_page=10`
|
|
14
12
|
|
|
15
13
|
## Parameters
|
|
16
14
|
|
|
17
|
-
| Parameter
|
|
18
|
-
|
|
19
|
-
| `per_page`
|
|
20
|
-
| `search`
|
|
21
|
-
| `status`
|
|
22
|
-
| `categories` | `array`
|
|
23
|
-
| `tags`
|
|
15
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
16
|
+
| ------------ | -------- | -------- | ------------------------------------------------ | --------- | ----------------------- |
|
|
17
|
+
| `per_page` | `number` | ❌ | Number of items to return per page (max 100). | `10` | `10`, `20` |
|
|
18
|
+
| `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
|
|
19
|
+
| `status` | `string` | ❌ | Filter by post status. | `publish` | `example` |
|
|
20
|
+
| `categories` | `array` | ❌ | Limit results to posts in specific category IDs. | - | `example` |
|
|
21
|
+
| `tags` | `array` | ❌ | Limit results to posts with specific tag IDs. | - | `example` |
|
|
24
22
|
|
|
25
23
|
## Examples
|
|
26
24
|
|
|
@@ -29,11 +27,13 @@ Lists posts from a WordPress site with comprehensive filtering options. Supports
|
|
|
29
27
|
Simple example of using wp_list_posts
|
|
30
28
|
|
|
31
29
|
**Command:**
|
|
30
|
+
|
|
32
31
|
```bash
|
|
33
|
-
wp_list_posts
|
|
32
|
+
wp_list_posts
|
|
34
33
|
```
|
|
35
34
|
|
|
36
35
|
**Response:**
|
|
36
|
+
|
|
37
37
|
```json
|
|
38
38
|
{
|
|
39
39
|
"success": true,
|
|
@@ -55,6 +55,7 @@ wp_list_posts
|
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
**Error Example (Authentication failure):**
|
|
58
|
+
|
|
58
59
|
```json
|
|
59
60
|
{
|
|
60
61
|
"error": "Authentication failed",
|
|
@@ -62,17 +63,18 @@ wp_list_posts
|
|
|
62
63
|
}
|
|
63
64
|
```
|
|
64
65
|
|
|
65
|
-
|
|
66
66
|
### Advanced post Configuration
|
|
67
67
|
|
|
68
68
|
Comprehensive example using all available parameters
|
|
69
69
|
|
|
70
70
|
**Command:**
|
|
71
|
+
|
|
71
72
|
```bash
|
|
72
73
|
wp_list_posts --per_page="10" --search="wordpress" --status="publish" --categories="example_value" --tags="example_value"
|
|
73
74
|
```
|
|
74
75
|
|
|
75
76
|
**Response:**
|
|
77
|
+
|
|
76
78
|
```json
|
|
77
79
|
{
|
|
78
80
|
"success": true,
|
|
@@ -93,22 +95,18 @@ wp_list_posts --per_page="10" --search="wordpress" --status="publish" --categori
|
|
|
93
95
|
}
|
|
94
96
|
```
|
|
95
97
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
98
|
## WordPress REST API Mapping
|
|
100
99
|
|
|
101
100
|
**Endpoint:** `/wp-json/wp/v2/posts`
|
|
102
101
|
|
|
103
|
-
This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters
|
|
102
|
+
This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters
|
|
103
|
+
are determined by WordPress core functionality.
|
|
104
104
|
|
|
105
105
|
### WordPress Documentation
|
|
106
|
+
|
|
106
107
|
- [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)
|
|
107
108
|
- [Endpoint Reference](https://developer.wordpress.org/rest-api/reference/)
|
|
108
109
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
110
|
## Response Format
|
|
113
111
|
|
|
114
112
|
**Return Type:** `post[]`
|
|
@@ -131,34 +129,24 @@ This tool directly interfaces with the WordPress REST API endpoint above. The re
|
|
|
131
129
|
|
|
132
130
|
### AUTHENTICATION_FAILED
|
|
133
131
|
|
|
134
|
-
**Message:** Authentication failed
|
|
135
|
-
|
|
136
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
137
|
-
|
|
132
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
133
|
+
Check your authentication credentials and user permissions
|
|
138
134
|
|
|
139
135
|
### VALIDATION_ERROR
|
|
140
136
|
|
|
141
|
-
**Message:** Parameter validation failed
|
|
142
|
-
**Description:** One or more required parameters are missing or invalid
|
|
137
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
143
138
|
**Resolution:** Review the required parameters and their formats
|
|
144
139
|
|
|
145
|
-
|
|
146
140
|
### NOT_FOUND
|
|
147
141
|
|
|
148
|
-
**Message:** Resource not found
|
|
149
|
-
|
|
150
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
151
|
-
|
|
142
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
143
|
+
resource ID and ensure it exists
|
|
152
144
|
|
|
153
145
|
### PERMISSION_DENIED
|
|
154
146
|
|
|
155
|
-
**Message:** Insufficient permissions
|
|
156
|
-
**Description:** The user does not have permission to perform this action
|
|
147
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
157
148
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
158
149
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
150
|
---
|
|
163
151
|
|
|
164
|
-
|
|
152
|
+
_Generated automatically from tool definitions - Do not edit manually_
|
|
@@ -6,9 +6,9 @@ Lists tags from a WordPress site.
|
|
|
6
6
|
|
|
7
7
|
## Parameters
|
|
8
8
|
|
|
9
|
-
| Parameter | Type
|
|
10
|
-
|
|
11
|
-
| `search`
|
|
9
|
+
| Parameter | Type | Required | Description | Default | Examples |
|
|
10
|
+
| --------- | -------- | -------- | ---------------------------------------------- | ------- | ----------------------- |
|
|
11
|
+
| `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
|
|
12
12
|
|
|
13
13
|
## Examples
|
|
14
14
|
|
|
@@ -17,11 +17,13 @@ Lists tags from a WordPress site.
|
|
|
17
17
|
Simple example of using wp_list_tags
|
|
18
18
|
|
|
19
19
|
**Command:**
|
|
20
|
+
|
|
20
21
|
```bash
|
|
21
|
-
wp_list_tags
|
|
22
|
+
wp_list_tags
|
|
22
23
|
```
|
|
23
24
|
|
|
24
25
|
**Response:**
|
|
26
|
+
|
|
25
27
|
```json
|
|
26
28
|
{
|
|
27
29
|
"success": true,
|
|
@@ -43,6 +45,7 @@ wp_list_tags
|
|
|
43
45
|
```
|
|
44
46
|
|
|
45
47
|
**Error Example (Authentication failure):**
|
|
48
|
+
|
|
46
49
|
```json
|
|
47
50
|
{
|
|
48
51
|
"error": "Authentication failed",
|
|
@@ -50,11 +53,6 @@ wp_list_tags
|
|
|
50
53
|
}
|
|
51
54
|
```
|
|
52
55
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
56
|
## Response Format
|
|
59
57
|
|
|
60
58
|
**Return Type:** `taxonomy[]`
|
|
@@ -77,34 +75,24 @@ wp_list_tags
|
|
|
77
75
|
|
|
78
76
|
### AUTHENTICATION_FAILED
|
|
79
77
|
|
|
80
|
-
**Message:** Authentication failed
|
|
81
|
-
|
|
82
|
-
**Resolution:** Check your authentication credentials and user permissions
|
|
83
|
-
|
|
78
|
+
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
|
|
79
|
+
Check your authentication credentials and user permissions
|
|
84
80
|
|
|
85
81
|
### VALIDATION_ERROR
|
|
86
82
|
|
|
87
|
-
**Message:** Parameter validation failed
|
|
88
|
-
**Description:** One or more required parameters are missing or invalid
|
|
83
|
+
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
|
|
89
84
|
**Resolution:** Review the required parameters and their formats
|
|
90
85
|
|
|
91
|
-
|
|
92
86
|
### NOT_FOUND
|
|
93
87
|
|
|
94
|
-
**Message:** Resource not found
|
|
95
|
-
|
|
96
|
-
**Resolution:** Verify the resource ID and ensure it exists
|
|
97
|
-
|
|
88
|
+
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
|
|
89
|
+
resource ID and ensure it exists
|
|
98
90
|
|
|
99
91
|
### PERMISSION_DENIED
|
|
100
92
|
|
|
101
|
-
**Message:** Insufficient permissions
|
|
102
|
-
**Description:** The user does not have permission to perform this action
|
|
93
|
+
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
|
|
103
94
|
**Resolution:** Contact an administrator to grant the necessary permissions
|
|
104
95
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
96
|
---
|
|
109
97
|
|
|
110
|
-
|
|
98
|
+
_Generated automatically from tool definitions - Do not edit manually_
|