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.
Files changed (198) hide show
  1. package/README.md +17 -19
  2. package/bin/mcp-wordpress.js +3 -3
  3. package/bin/setup.js +140 -141
  4. package/bin/status.js +112 -114
  5. package/dist/client/MockWordPressClient.d.ts.map +1 -1
  6. package/dist/client/MockWordPressClient.js.map +1 -1
  7. package/dist/client/SEOWordPressClient.d.ts.map +1 -1
  8. package/dist/client/SEOWordPressClient.js +16 -14
  9. package/dist/client/SEOWordPressClient.js.map +1 -1
  10. package/dist/client/index.d.ts +6 -6
  11. package/dist/client/index.js +6 -6
  12. package/dist/client/managers/AuthManager.d.ts.map +1 -1
  13. package/dist/client/managers/AuthManager.js +2 -2
  14. package/dist/client/managers/AuthManager.js.map +1 -1
  15. package/dist/client/managers/AuthenticationManager.js +1 -1
  16. package/dist/client/managers/JWTAuthImplementation.d.ts.map +1 -1
  17. package/dist/client/managers/JWTAuthImplementation.js +7 -7
  18. package/dist/client/managers/JWTAuthImplementation.js.map +1 -1
  19. package/dist/client/managers/composed/MigrationAdapter.js +1 -1
  20. package/dist/client/managers/composed/index.d.ts +2 -2
  21. package/dist/client/managers/composed/index.d.ts.map +1 -1
  22. package/dist/client/managers/composed/index.js +1 -1
  23. package/dist/client/managers/composed/index.js.map +1 -1
  24. package/dist/client/managers/implementations/ErrorHandlerImpl.d.ts.map +1 -1
  25. package/dist/client/managers/implementations/ErrorHandlerImpl.js +2 -4
  26. package/dist/client/managers/implementations/ErrorHandlerImpl.js.map +1 -1
  27. package/dist/client/managers/implementations/ParameterValidatorImpl.d.ts.map +1 -1
  28. package/dist/client/managers/implementations/ParameterValidatorImpl.js +1 -1
  29. package/dist/client/managers/implementations/ParameterValidatorImpl.js.map +1 -1
  30. package/dist/client/managers/interfaces/ManagerInterfaces.d.ts.map +1 -1
  31. package/dist/config/index.d.ts +3 -3
  32. package/dist/config/index.js +3 -3
  33. package/dist/docs/MarkdownFormatter.d.ts.map +1 -1
  34. package/dist/docs/MarkdownFormatter.js +7 -7
  35. package/dist/docs/MarkdownFormatter.js.map +1 -1
  36. package/dist/performance/PerformanceAnalytics.d.ts.map +1 -1
  37. package/dist/performance/PerformanceAnalytics.js +3 -1
  38. package/dist/performance/PerformanceAnalytics.js.map +1 -1
  39. package/dist/security/InputValidator.js +1 -1
  40. package/dist/security/SecurityCIPipeline.js +1 -1
  41. package/dist/security/SecurityCIPipeline.js.map +1 -1
  42. package/dist/security/SecurityConfig.d.ts.map +1 -1
  43. package/dist/security/SecurityConfig.js +6 -2
  44. package/dist/security/SecurityConfig.js.map +1 -1
  45. package/dist/server/index.d.ts +2 -2
  46. package/dist/server/index.js +2 -2
  47. package/dist/tools/cache.d.ts.map +1 -1
  48. package/dist/tools/cache.js.map +1 -1
  49. package/dist/tools/comments.d.ts.map +1 -1
  50. package/dist/tools/comments.js.map +1 -1
  51. package/dist/tools/performance.d.ts.map +1 -1
  52. package/dist/tools/performance.js.map +1 -1
  53. package/dist/tools/posts/PostHandlers.d.ts.map +1 -1
  54. package/dist/tools/posts/PostHandlers.js.map +1 -1
  55. package/dist/tools/seo/SEOTools.d.ts.map +1 -1
  56. package/dist/tools/seo/SEOTools.js.map +1 -1
  57. package/dist/tools/seo/analyzers/ContentAnalyzer.d.ts.map +1 -1
  58. package/dist/tools/seo/analyzers/ContentAnalyzer.js.map +1 -1
  59. package/dist/types/enhanced.d.ts +17 -17
  60. package/dist/types/enhanced.d.ts.map +1 -1
  61. package/dist/types/enhanced.js +2 -2
  62. package/dist/types/index.d.ts +2 -2
  63. package/dist/types/index.d.ts.map +1 -1
  64. package/dist/types/requests.d.ts +16 -16
  65. package/dist/types/tools.d.ts +46 -46
  66. package/dist/types/tools.d.ts.map +1 -1
  67. package/dist/utils/index.d.ts +7 -7
  68. package/dist/utils/index.js +7 -7
  69. package/docs/ARCHITECTURE.md +17 -17
  70. package/docs/BADGE_UPDATES.md +11 -11
  71. package/docs/CACHING.md +2 -0
  72. package/docs/CI_CD_IMPROVEMENTS.md +8 -5
  73. package/docs/CONFIGURATION.md +76 -46
  74. package/docs/DOCKER_PUBLISHING_TROUBLESHOOTING.md +11 -2
  75. package/docs/EVALUATION.md +16 -21
  76. package/docs/INCREMENTAL_COVERAGE.md +7 -3
  77. package/docs/INSTALLATION.md +33 -19
  78. package/docs/PUBLISHING-TROUBLESHOOTING.md +3 -2
  79. package/docs/SECURITY.md +17 -15
  80. package/docs/SECURITY_TESTING.md +3 -0
  81. package/docs/TROUBLESHOOTING.md +85 -36
  82. package/docs/api/README.md +118 -125
  83. package/docs/api/categories/auth.md +3 -1
  84. package/docs/api/categories/cache.md +3 -1
  85. package/docs/api/categories/comment.md +3 -1
  86. package/docs/api/categories/media.md +3 -1
  87. package/docs/api/categories/page.md +3 -1
  88. package/docs/api/categories/performance.md +3 -1
  89. package/docs/api/categories/post.md +3 -1
  90. package/docs/api/categories/site.md +3 -1
  91. package/docs/api/categories/taxonomy.md +3 -1
  92. package/docs/api/categories/user.md +3 -1
  93. package/docs/api/openapi.json +114 -410
  94. package/docs/api/summary.json +1 -1
  95. package/docs/api/tools/wp_approve_comment.md +13 -25
  96. package/docs/api/tools/wp_cache_clear.md +17 -30
  97. package/docs/api/tools/wp_cache_info.md +16 -29
  98. package/docs/api/tools/wp_cache_stats.md +16 -29
  99. package/docs/api/tools/wp_cache_warm.md +16 -29
  100. package/docs/api/tools/wp_create_application_password.md +14 -26
  101. package/docs/api/tools/wp_create_category.md +14 -26
  102. package/docs/api/tools/wp_create_comment.md +18 -31
  103. package/docs/api/tools/wp_create_page.md +17 -29
  104. package/docs/api/tools/wp_create_post.md +25 -30
  105. package/docs/api/tools/wp_create_tag.md +13 -25
  106. package/docs/api/tools/wp_create_user.md +18 -30
  107. package/docs/api/tools/wp_delete_application_password.md +14 -26
  108. package/docs/api/tools/wp_delete_category.md +13 -25
  109. package/docs/api/tools/wp_delete_comment.md +14 -26
  110. package/docs/api/tools/wp_delete_media.md +14 -25
  111. package/docs/api/tools/wp_delete_page.md +14 -25
  112. package/docs/api/tools/wp_delete_post.md +17 -25
  113. package/docs/api/tools/wp_delete_tag.md +13 -25
  114. package/docs/api/tools/wp_delete_user.md +14 -25
  115. package/docs/api/tools/wp_get_application_passwords.md +13 -25
  116. package/docs/api/tools/wp_get_auth_status.md +12 -24
  117. package/docs/api/tools/wp_get_category.md +13 -25
  118. package/docs/api/tools/wp_get_comment.md +13 -25
  119. package/docs/api/tools/wp_get_current_user.md +17 -30
  120. package/docs/api/tools/wp_get_media.md +13 -25
  121. package/docs/api/tools/wp_get_page.md +13 -25
  122. package/docs/api/tools/wp_get_page_revisions.md +13 -25
  123. package/docs/api/tools/wp_get_post.md +16 -25
  124. package/docs/api/tools/wp_get_post_revisions.md +13 -25
  125. package/docs/api/tools/wp_get_site_settings.md +12 -23
  126. package/docs/api/tools/wp_get_tag.md +13 -25
  127. package/docs/api/tools/wp_get_user.md +13 -25
  128. package/docs/api/tools/wp_list_categories.md +15 -27
  129. package/docs/api/tools/wp_list_comments.md +15 -27
  130. package/docs/api/tools/wp_list_media.md +18 -31
  131. package/docs/api/tools/wp_list_pages.md +18 -31
  132. package/docs/api/tools/wp_list_posts.md +29 -41
  133. package/docs/api/tools/wp_list_tags.md +14 -26
  134. package/docs/api/tools/wp_list_users.md +20 -34
  135. package/docs/api/tools/wp_performance_alerts.md +22 -36
  136. package/docs/api/tools/wp_performance_benchmark.md +20 -34
  137. package/docs/api/tools/wp_performance_export.md +22 -36
  138. package/docs/api/tools/wp_performance_history.md +21 -35
  139. package/docs/api/tools/wp_performance_optimize.md +22 -36
  140. package/docs/api/tools/wp_performance_stats.md +20 -34
  141. package/docs/api/tools/wp_search_site.md +18 -32
  142. package/docs/api/tools/wp_spam_comment.md +13 -25
  143. package/docs/api/tools/wp_switch_auth_method.md +18 -31
  144. package/docs/api/tools/wp_test_auth.md +15 -30
  145. package/docs/api/tools/wp_update_category.md +14 -26
  146. package/docs/api/tools/wp_update_comment.md +17 -30
  147. package/docs/api/tools/wp_update_media.md +19 -32
  148. package/docs/api/tools/wp_update_page.md +18 -30
  149. package/docs/api/tools/wp_update_post.md +21 -30
  150. package/docs/api/tools/wp_update_site_settings.md +18 -31
  151. package/docs/api/tools/wp_update_tag.md +14 -26
  152. package/docs/api/tools/wp_update_user.md +17 -29
  153. package/docs/api/tools/wp_upload_media.md +20 -32
  154. package/docs/api/types/WordPressPost.md +8 -15
  155. package/docs/code-improvements.md +1 -0
  156. package/docs/developer/GITHUB_ACTIONS_SETUP.md +2 -2
  157. package/docs/developer/MAINTENANCE.md +4 -0
  158. package/docs/developer/NPM_AUTH_SETUP.md +3 -0
  159. package/docs/developer/RELEASE_PROCESS.md +1 -0
  160. package/docs/examples/multi-site-setup.md +2 -0
  161. package/docs/integrations/claude-desktop.md +14 -5
  162. package/docs/integrations/cline.md +1 -0
  163. package/docs/user-guides/DTX_SETUP.md +9 -8
  164. package/docs/user-guides/NPX_SETUP.md +5 -9
  165. package/docs/user-guides/SMITHERY_SETUP.md +5 -0
  166. package/docs/v2.2.0-resolution-demo.md +17 -2
  167. package/package.json +2 -1
  168. package/src/cache/__tests__/CacheManager.test.ts +4 -8
  169. package/src/client/MockWordPressClient.ts +5 -1
  170. package/src/client/SEOWordPressClient.ts +30 -26
  171. package/src/client/index.ts +6 -6
  172. package/src/client/managers/AuthManager.ts +16 -8
  173. package/src/client/managers/AuthenticationManager.ts +2 -2
  174. package/src/client/managers/JWTAuthImplementation.ts +24 -27
  175. package/src/client/managers/ManagersIndex.ts +1 -1
  176. package/src/client/managers/composed/MigrationAdapter.ts +1 -1
  177. package/src/client/managers/composed/index.ts +7 -7
  178. package/src/client/managers/implementations/ErrorHandlerImpl.ts +12 -26
  179. package/src/client/managers/implementations/ParameterValidatorImpl.ts +49 -49
  180. package/src/client/managers/interfaces/ManagerInterfaces.ts +13 -9
  181. package/src/config/index.ts +3 -3
  182. package/src/docs/MarkdownFormatter.ts +13 -9
  183. package/src/performance/PerformanceAnalytics.ts +9 -3
  184. package/src/security/InputValidator.ts +1 -1
  185. package/src/security/SecurityCIPipeline.ts +1 -1
  186. package/src/security/SecurityConfig.ts +9 -3
  187. package/src/server/index.ts +2 -2
  188. package/src/tools/cache.ts +3 -1
  189. package/src/tools/comments.ts +3 -1
  190. package/src/tools/performance.ts +7 -3
  191. package/src/tools/posts/PostHandlers.ts +3 -1
  192. package/src/tools/seo/SEOTools.ts +6 -2
  193. package/src/tools/seo/analyzers/ContentAnalyzer.ts +9 -3
  194. package/src/types/enhanced.ts +34 -34
  195. package/src/types/index.ts +13 -11
  196. package/src/types/requests.ts +19 -19
  197. package/src/types/tools.ts +137 -84
  198. 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 | 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` |
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
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 | 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` |
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
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 | 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` |
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
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 | 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` |
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
132
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -2,25 +2,23 @@
2
2
 
3
3
  ![post](https://img.shields.io/badge/category-post-lightgrey)
4
4
 
5
- Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and category/tag filtering with enhanced metadata display.
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
- Basic listing: `wp_list_posts`
9
- • Search posts: `wp_list_posts --search="AI trends"`
10
- • Filter by status: `wp_list_posts --status="draft"`
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 | Type | Required | Description | Default | Examples |
18
- |-----------|------|----------|-------------|---------|----------|
19
- | `per_page` | `number` | ❌ | Number of items to return per page (max 100). | `10` | `10`, `20` |
20
- | `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
21
- | `status` | `string` | ❌ | Filter by post status. | `publish` | `example` |
22
- | `categories` | `array` | ❌ | Limit results to posts in specific category IDs. | - | `example` |
23
- | `tags` | `array` | ❌ | Limit results to posts with specific tag IDs. | - | `example` |
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 are determined by WordPress core functionality.
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
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 | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `search` | `string` | ❌ | Limit results to those matching a search term. | - | `wordpress`, `tutorial` |
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
- **Description:** Invalid credentials or insufficient permissions
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
- **Description:** The requested resource does not exist
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
- *Generated automatically from tool definitions - Do not edit manually*
98
+ _Generated automatically from tool definitions - Do not edit manually_