mcp-wordpress 1.5.2 → 2.0.0

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 (190) hide show
  1. package/README.md +332 -61
  2. package/dist/cache/CacheInvalidation.d.ts.map +1 -1
  3. package/dist/cache/CacheInvalidation.js +4 -4
  4. package/dist/cache/CacheInvalidation.js.map +1 -1
  5. package/dist/client/MockWordPressClient.d.ts +55 -0
  6. package/dist/client/MockWordPressClient.d.ts.map +1 -0
  7. package/dist/client/MockWordPressClient.js +369 -0
  8. package/dist/client/MockWordPressClient.js.map +1 -0
  9. package/dist/client/api.d.ts +1 -0
  10. package/dist/client/api.d.ts.map +1 -1
  11. package/dist/client/api.js +26 -60
  12. package/dist/client/api.js.map +1 -1
  13. package/dist/client/managers/AuthenticationManager.d.ts.map +1 -1
  14. package/dist/client/managers/AuthenticationManager.js +4 -3
  15. package/dist/client/managers/AuthenticationManager.js.map +1 -1
  16. package/dist/config/ConfigurationSchema.d.ts +3 -3
  17. package/dist/config/ConfigurationSchema.d.ts.map +1 -1
  18. package/dist/config/ConfigurationSchema.js +7 -24
  19. package/dist/config/ConfigurationSchema.js.map +1 -1
  20. package/dist/config/ServerConfiguration.d.ts +8 -0
  21. package/dist/config/ServerConfiguration.d.ts.map +1 -1
  22. package/dist/config/ServerConfiguration.js +80 -31
  23. package/dist/config/ServerConfiguration.js.map +1 -1
  24. package/dist/docs/DocumentationGenerator.d.ts.map +1 -1
  25. package/dist/docs/DocumentationGenerator.js +5 -7
  26. package/dist/docs/DocumentationGenerator.js.map +1 -1
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +33 -29
  29. package/dist/index.js.map +1 -1
  30. package/dist/security/InputValidator.d.ts.map +1 -1
  31. package/dist/security/InputValidator.js +3 -11
  32. package/dist/security/InputValidator.js.map +1 -1
  33. package/dist/server/ToolRegistry.d.ts +4 -0
  34. package/dist/server/ToolRegistry.d.ts.map +1 -1
  35. package/dist/server/ToolRegistry.js +71 -8
  36. package/dist/server/ToolRegistry.js.map +1 -1
  37. package/dist/tools/auth.d.ts.map +1 -1
  38. package/dist/tools/auth.js +8 -3
  39. package/dist/tools/auth.js.map +1 -1
  40. package/dist/tools/posts.d.ts.map +1 -1
  41. package/dist/tools/posts.js +287 -20
  42. package/dist/tools/posts.js.map +1 -1
  43. package/dist/tools/site.d.ts.map +1 -1
  44. package/dist/tools/site.js +47 -9
  45. package/dist/tools/site.js.map +1 -1
  46. package/dist/tools/users.d.ts.map +1 -1
  47. package/dist/tools/users.js +113 -10
  48. package/dist/tools/users.js.map +1 -1
  49. package/dist/utils/enhancedError.d.ts +61 -0
  50. package/dist/utils/enhancedError.d.ts.map +1 -0
  51. package/dist/utils/enhancedError.js +221 -0
  52. package/dist/utils/enhancedError.js.map +1 -0
  53. package/dist/utils/streaming.d.ts +104 -0
  54. package/dist/utils/streaming.d.ts.map +1 -0
  55. package/dist/utils/streaming.js +312 -0
  56. package/dist/utils/streaming.js.map +1 -0
  57. package/dist/utils/validation.d.ts +19 -3
  58. package/dist/utils/validation.d.ts.map +1 -1
  59. package/dist/utils/validation.js +174 -24
  60. package/dist/utils/validation.js.map +1 -1
  61. package/docs/ARCHITECTURE.md +850 -0
  62. package/docs/CACHING.md +20 -17
  63. package/docs/CONFIGURATION.md +660 -0
  64. package/docs/DOCKER.md +61 -60
  65. package/docs/EVALUATION.md +397 -0
  66. package/docs/INSTALLATION.md +423 -0
  67. package/docs/PERFORMANCE_MONITORING.md +17 -15
  68. package/docs/SECURITY.md +621 -0
  69. package/docs/SECURITY_TESTING.md +22 -26
  70. package/docs/TEST_SITE_SETUP.md +136 -0
  71. package/docs/TROUBLESHOOTING.md +578 -0
  72. package/docs/api/README.md +76 -91
  73. package/docs/api/categories/auth.md +0 -2
  74. package/docs/api/categories/cache.md +0 -2
  75. package/docs/api/categories/comment.md +0 -2
  76. package/docs/api/categories/media.md +0 -2
  77. package/docs/api/categories/page.md +0 -2
  78. package/docs/api/categories/performance.md +0 -2
  79. package/docs/api/categories/post.md +0 -2
  80. package/docs/api/categories/site.md +0 -2
  81. package/docs/api/categories/taxonomy.md +0 -2
  82. package/docs/api/categories/user.md +0 -2
  83. package/docs/api/summary.json +1 -1
  84. package/docs/api/tools/wp_approve_comment.md +11 -3
  85. package/docs/api/tools/wp_cache_clear.md +14 -5
  86. package/docs/api/tools/wp_cache_info.md +14 -5
  87. package/docs/api/tools/wp_cache_stats.md +14 -5
  88. package/docs/api/tools/wp_cache_warm.md +14 -5
  89. package/docs/api/tools/wp_create_application_password.md +11 -3
  90. package/docs/api/tools/wp_create_category.md +11 -3
  91. package/docs/api/tools/wp_create_comment.md +14 -5
  92. package/docs/api/tools/wp_create_page.md +13 -5
  93. package/docs/api/tools/wp_create_post.md +14 -7
  94. package/docs/api/tools/wp_create_tag.md +11 -3
  95. package/docs/api/tools/wp_create_user.md +13 -5
  96. package/docs/api/tools/wp_delete_application_password.md +11 -3
  97. package/docs/api/tools/wp_delete_category.md +11 -3
  98. package/docs/api/tools/wp_delete_comment.md +11 -3
  99. package/docs/api/tools/wp_delete_media.md +10 -3
  100. package/docs/api/tools/wp_delete_page.md +10 -3
  101. package/docs/api/tools/wp_delete_post.md +11 -5
  102. package/docs/api/tools/wp_delete_tag.md +11 -3
  103. package/docs/api/tools/wp_delete_user.md +10 -3
  104. package/docs/api/tools/wp_get_application_passwords.md +11 -3
  105. package/docs/api/tools/wp_get_auth_status.md +11 -3
  106. package/docs/api/tools/wp_get_category.md +11 -3
  107. package/docs/api/tools/wp_get_comment.md +11 -3
  108. package/docs/api/tools/wp_get_current_user.md +11 -3
  109. package/docs/api/tools/wp_get_media.md +11 -3
  110. package/docs/api/tools/wp_get_page.md +11 -3
  111. package/docs/api/tools/wp_get_page_revisions.md +11 -3
  112. package/docs/api/tools/wp_get_post.md +12 -5
  113. package/docs/api/tools/wp_get_post_revisions.md +11 -3
  114. package/docs/api/tools/wp_get_site_settings.md +10 -3
  115. package/docs/api/tools/wp_get_tag.md +11 -3
  116. package/docs/api/tools/wp_get_user.md +11 -3
  117. package/docs/api/tools/wp_list_categories.md +11 -3
  118. package/docs/api/tools/wp_list_comments.md +11 -3
  119. package/docs/api/tools/wp_list_media.md +14 -5
  120. package/docs/api/tools/wp_list_pages.md +14 -5
  121. package/docs/api/tools/wp_list_posts.md +15 -7
  122. package/docs/api/tools/wp_list_tags.md +11 -3
  123. package/docs/api/tools/wp_list_users.md +11 -3
  124. package/docs/api/tools/wp_performance_alerts.md +17 -7
  125. package/docs/api/tools/wp_performance_benchmark.md +17 -7
  126. package/docs/api/tools/wp_performance_export.md +17 -7
  127. package/docs/api/tools/wp_performance_history.md +17 -7
  128. package/docs/api/tools/wp_performance_optimize.md +17 -7
  129. package/docs/api/tools/wp_performance_stats.md +17 -7
  130. package/docs/api/tools/wp_search_site.md +11 -3
  131. package/docs/api/tools/wp_spam_comment.md +11 -3
  132. package/docs/api/tools/wp_switch_auth_method.md +14 -5
  133. package/docs/api/tools/wp_test_auth.md +11 -3
  134. package/docs/api/tools/wp_update_category.md +11 -3
  135. package/docs/api/tools/wp_update_comment.md +14 -5
  136. package/docs/api/tools/wp_update_media.md +14 -5
  137. package/docs/api/tools/wp_update_page.md +13 -5
  138. package/docs/api/tools/wp_update_post.md +14 -7
  139. package/docs/api/tools/wp_update_site_settings.md +14 -5
  140. package/docs/api/tools/wp_update_tag.md +11 -3
  141. package/docs/api/tools/wp_update_user.md +13 -5
  142. package/docs/api/tools/wp_upload_media.md +13 -5
  143. package/docs/api/types/WordPressPost.md +2 -0
  144. package/docs/code-improvements.md +40 -0
  145. package/docs/contract-testing.md +1 -1
  146. package/docs/developer/API_REFERENCE.md +19 -59
  147. package/docs/developer/ARCHITECTURE.md +8 -11
  148. package/docs/developer/BUILD_SYSTEM.md +2 -2
  149. package/docs/developer/CONTRIBUTING.md +3 -5
  150. package/docs/developer/GITHUB_ACTIONS_SETUP.md +2 -2
  151. package/docs/developer/MIGRATION_GUIDE.md +5 -6
  152. package/docs/developer/README.md +2 -1
  153. package/docs/developer/REFACTORING.md +9 -15
  154. package/docs/developer/RELEASE_PROCESS.md +4 -3
  155. package/docs/developer/TESTING.md +2 -2
  156. package/docs/examples/claude-desktop-config.md +8 -0
  157. package/docs/integrations/claude-desktop.md +426 -0
  158. package/docs/integrations/cline.md +537 -0
  159. package/docs/integrations/vs-code.md +515 -0
  160. package/docs/releases/COMMUNITY_ANNOUNCEMENT_v1.1.2.md +30 -23
  161. package/docs/releases/RELEASE_NOTES_v1.1.2.md +7 -6
  162. package/docs/testing-configurations.md +11 -0
  163. package/docs/user-guides/DOCKER_NPM_DTX_SETUP.md +3 -2
  164. package/docs/user-guides/DOCKER_SETUP.md +3 -2
  165. package/docs/user-guides/DTX_SETUP.md +6 -5
  166. package/docs/user-guides/DXT_INSTALLATION.md +4 -4
  167. package/docs/user-guides/NPM_SETUP.md +4 -2
  168. package/docs/user-guides/NPX_SETUP.md +4 -2
  169. package/docs/user-guides/SMITHERY_SETUP.md +402 -0
  170. package/docs/wordpress-rest-api-authentication-troubleshooting.md +45 -42
  171. package/package.json +12 -2
  172. package/src/cache/CacheInvalidation.ts +7 -18
  173. package/src/client/MockWordPressClient.ts +398 -0
  174. package/src/client/api.ts +77 -237
  175. package/src/client/managers/AuthenticationManager.ts +19 -56
  176. package/src/config/ConfigurationSchema.ts +14 -45
  177. package/src/config/ServerConfiguration.ts +98 -71
  178. package/src/docs/DocumentationGenerator.ts +39 -123
  179. package/src/dxt-entry.cjs +4 -1
  180. package/src/index.ts +35 -54
  181. package/src/security/InputValidator.ts +15 -57
  182. package/src/server/ToolRegistry.ts +88 -17
  183. package/src/tools/auth.ts +15 -22
  184. package/src/tools/posts.ts +347 -64
  185. package/src/tools/site.ts +69 -46
  186. package/src/tools/users.ts +142 -44
  187. package/src/utils/enhancedError.ts +248 -0
  188. package/src/utils/streaming.ts +428 -0
  189. package/src/utils/validation.ts +253 -92
  190. package/dist/mcp-wordpress-1.5.2.tgz +0 -0
@@ -17,13 +17,11 @@ Retrieves a single tag by its ID.
17
17
  Simple example of using wp_get_tag
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_tag --id="123"
23
22
  ```
24
23
 
25
24
  **Response:**
26
-
27
25
  ```json
28
26
  {
29
27
  "success": true,
@@ -38,7 +36,6 @@ wp_get_tag --id="123"
38
36
  ```
39
37
 
40
38
  **Error Example (Authentication failure):**
41
-
42
39
  ```json
43
40
  {
44
41
  "error": "Authentication failed",
@@ -46,6 +43,11 @@ wp_get_tag --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `taxonomy`
@@ -72,24 +74,30 @@ wp_get_tag --id="123"
72
74
  **Description:** Invalid credentials or insufficient permissions
73
75
  **Resolution:** Check your authentication credentials and user permissions
74
76
 
77
+
75
78
  ### VALIDATION_ERROR
76
79
 
77
80
  **Message:** Parameter validation failed
78
81
  **Description:** One or more required parameters are missing or invalid
79
82
  **Resolution:** Review the required parameters and their formats
80
83
 
84
+
81
85
  ### NOT_FOUND
82
86
 
83
87
  **Message:** Resource not found
84
88
  **Description:** The requested resource does not exist
85
89
  **Resolution:** Verify the resource ID and ensure it exists
86
90
 
91
+
87
92
  ### PERMISSION_DENIED
88
93
 
89
94
  **Message:** Insufficient permissions
90
95
  **Description:** The user does not have permission to perform this action
91
96
  **Resolution:** Contact an administrator to grant the necessary permissions
92
97
 
98
+
99
+
100
+
93
101
  ---
94
102
 
95
103
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Retrieves a single user by their ID.
17
17
  Simple example of using wp_get_user
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_user --id="123"
23
22
  ```
24
23
 
25
24
  **Response:**
26
-
27
25
  ```json
28
26
  {
29
27
  "success": true,
@@ -38,7 +36,6 @@ wp_get_user --id="123"
38
36
  ```
39
37
 
40
38
  **Error Example (Authentication failure):**
41
-
42
39
  ```json
43
40
  {
44
41
  "error": "Authentication failed",
@@ -46,6 +43,11 @@ wp_get_user --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `user`
@@ -72,24 +74,30 @@ wp_get_user --id="123"
72
74
  **Description:** Invalid credentials or insufficient permissions
73
75
  **Resolution:** Check your authentication credentials and user permissions
74
76
 
77
+
75
78
  ### VALIDATION_ERROR
76
79
 
77
80
  **Message:** Parameter validation failed
78
81
  **Description:** One or more required parameters are missing or invalid
79
82
  **Resolution:** Review the required parameters and their formats
80
83
 
84
+
81
85
  ### NOT_FOUND
82
86
 
83
87
  **Message:** Resource not found
84
88
  **Description:** The requested resource does not exist
85
89
  **Resolution:** Verify the resource ID and ensure it exists
86
90
 
91
+
87
92
  ### PERMISSION_DENIED
88
93
 
89
94
  **Message:** Insufficient permissions
90
95
  **Description:** The user does not have permission to perform this action
91
96
  **Resolution:** Contact an administrator to grant the necessary permissions
92
97
 
98
+
99
+
100
+
93
101
  ---
94
102
 
95
103
  *Generated automatically from tool definitions - Do not edit manually*
@@ -18,13 +18,11 @@ Lists categories from a WordPress site.
18
18
  Simple example of using wp_list_categories
19
19
 
20
20
  **Command:**
21
-
22
21
  ```bash
23
22
  wp_list_categories
24
23
  ```
25
24
 
26
25
  **Response:**
27
-
28
26
  ```json
29
27
  {
30
28
  "success": true,
@@ -46,7 +44,6 @@ wp_list_categories
46
44
  ```
47
45
 
48
46
  **Error Example (Authentication failure):**
49
-
50
47
  ```json
51
48
  {
52
49
  "error": "Authentication failed",
@@ -54,6 +51,11 @@ wp_list_categories
54
51
  }
55
52
  ```
56
53
 
54
+
55
+
56
+
57
+
58
+
57
59
  ## Response Format
58
60
 
59
61
  **Return Type:** `taxonomy[]`
@@ -80,24 +82,30 @@ wp_list_categories
80
82
  **Description:** Invalid credentials or insufficient permissions
81
83
  **Resolution:** Check your authentication credentials and user permissions
82
84
 
85
+
83
86
  ### VALIDATION_ERROR
84
87
 
85
88
  **Message:** Parameter validation failed
86
89
  **Description:** One or more required parameters are missing or invalid
87
90
  **Resolution:** Review the required parameters and their formats
88
91
 
92
+
89
93
  ### NOT_FOUND
90
94
 
91
95
  **Message:** Resource not found
92
96
  **Description:** The requested resource does not exist
93
97
  **Resolution:** Verify the resource ID and ensure it exists
94
98
 
99
+
95
100
  ### PERMISSION_DENIED
96
101
 
97
102
  **Message:** Insufficient permissions
98
103
  **Description:** The user does not have permission to perform this action
99
104
  **Resolution:** Contact an administrator to grant the necessary permissions
100
105
 
106
+
107
+
108
+
101
109
  ---
102
110
 
103
111
  *Generated automatically from tool definitions - Do not edit manually*
@@ -18,13 +18,11 @@ Lists comments from a WordPress site, with filters.
18
18
  Simple example of using wp_list_comments
19
19
 
20
20
  **Command:**
21
-
22
21
  ```bash
23
22
  wp_list_comments
24
23
  ```
25
24
 
26
25
  **Response:**
27
-
28
26
  ```json
29
27
  {
30
28
  "success": true,
@@ -46,7 +44,6 @@ wp_list_comments
46
44
  ```
47
45
 
48
46
  **Error Example (Authentication failure):**
49
-
50
47
  ```json
51
48
  {
52
49
  "error": "Authentication failed",
@@ -54,6 +51,11 @@ wp_list_comments
54
51
  }
55
52
  ```
56
53
 
54
+
55
+
56
+
57
+
58
+
57
59
  ## Response Format
58
60
 
59
61
  **Return Type:** `comment[]`
@@ -80,24 +82,30 @@ wp_list_comments
80
82
  **Description:** Invalid credentials or insufficient permissions
81
83
  **Resolution:** Check your authentication credentials and user permissions
82
84
 
85
+
83
86
  ### VALIDATION_ERROR
84
87
 
85
88
  **Message:** Parameter validation failed
86
89
  **Description:** One or more required parameters are missing or invalid
87
90
  **Resolution:** Review the required parameters and their formats
88
91
 
92
+
89
93
  ### NOT_FOUND
90
94
 
91
95
  **Message:** Resource not found
92
96
  **Description:** The requested resource does not exist
93
97
  **Resolution:** Verify the resource ID and ensure it exists
94
98
 
99
+
95
100
  ### PERMISSION_DENIED
96
101
 
97
102
  **Message:** Insufficient permissions
98
103
  **Description:** The user does not have permission to perform this action
99
104
  **Resolution:** Contact an administrator to grant the necessary permissions
100
105
 
106
+
107
+
108
+
101
109
  ---
102
110
 
103
111
  *Generated automatically from tool definitions - Do not edit manually*
@@ -19,13 +19,11 @@ Lists media items from a WordPress site, with filters.
19
19
  Simple example of using wp_list_media
20
20
 
21
21
  **Command:**
22
-
23
22
  ```bash
24
23
  wp_list_media
25
24
  ```
26
25
 
27
26
  **Response:**
28
-
29
27
  ```json
30
28
  {
31
29
  "success": true,
@@ -47,7 +45,6 @@ wp_list_media
47
45
  ```
48
46
 
49
47
  **Error Example (Authentication failure):**
50
-
51
48
  ```json
52
49
  {
53
50
  "error": "Authentication failed",
@@ -55,18 +52,17 @@ wp_list_media
55
52
  }
56
53
  ```
57
54
 
55
+
58
56
  ### Advanced media Configuration
59
57
 
60
58
  Comprehensive example using all available parameters
61
59
 
62
60
  **Command:**
63
-
64
61
  ```bash
65
62
  wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
66
63
  ```
67
64
 
68
65
  **Response:**
69
-
70
66
  ```json
71
67
  {
72
68
  "success": true,
@@ -87,6 +83,13 @@ wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
87
83
  }
88
84
  ```
89
85
 
86
+
87
+
88
+
89
+
90
+
91
+
92
+
90
93
  ## Response Format
91
94
 
92
95
  **Return Type:** `media[]`
@@ -113,24 +116,30 @@ wp_list_media --per_page="10" --search="wordpress" --media_type="example_value"
113
116
  **Description:** Invalid credentials or insufficient permissions
114
117
  **Resolution:** Check your authentication credentials and user permissions
115
118
 
119
+
116
120
  ### VALIDATION_ERROR
117
121
 
118
122
  **Message:** Parameter validation failed
119
123
  **Description:** One or more required parameters are missing or invalid
120
124
  **Resolution:** Review the required parameters and their formats
121
125
 
126
+
122
127
  ### NOT_FOUND
123
128
 
124
129
  **Message:** Resource not found
125
130
  **Description:** The requested resource does not exist
126
131
  **Resolution:** Verify the resource ID and ensure it exists
127
132
 
133
+
128
134
  ### PERMISSION_DENIED
129
135
 
130
136
  **Message:** Insufficient permissions
131
137
  **Description:** The user does not have permission to perform this action
132
138
  **Resolution:** Contact an administrator to grant the necessary permissions
133
139
 
140
+
141
+
142
+
134
143
  ---
135
144
 
136
145
  *Generated automatically from tool definitions - Do not edit manually*
@@ -19,13 +19,11 @@ Lists pages from a WordPress site, with filters.
19
19
  Simple example of using wp_list_pages
20
20
 
21
21
  **Command:**
22
-
23
22
  ```bash
24
23
  wp_list_pages
25
24
  ```
26
25
 
27
26
  **Response:**
28
-
29
27
  ```json
30
28
  {
31
29
  "success": true,
@@ -47,7 +45,6 @@ wp_list_pages
47
45
  ```
48
46
 
49
47
  **Error Example (Authentication failure):**
50
-
51
48
  ```json
52
49
  {
53
50
  "error": "Authentication failed",
@@ -55,18 +52,17 @@ wp_list_pages
55
52
  }
56
53
  ```
57
54
 
55
+
58
56
  ### Advanced page Configuration
59
57
 
60
58
  Comprehensive example using all available parameters
61
59
 
62
60
  **Command:**
63
-
64
61
  ```bash
65
62
  wp_list_pages --per_page="10" --search="wordpress" --status="publish"
66
63
  ```
67
64
 
68
65
  **Response:**
69
-
70
66
  ```json
71
67
  {
72
68
  "success": true,
@@ -87,6 +83,13 @@ wp_list_pages --per_page="10" --search="wordpress" --status="publish"
87
83
  }
88
84
  ```
89
85
 
86
+
87
+
88
+
89
+
90
+
91
+
92
+
90
93
  ## Response Format
91
94
 
92
95
  **Return Type:** `page[]`
@@ -113,24 +116,30 @@ wp_list_pages --per_page="10" --search="wordpress" --status="publish"
113
116
  **Description:** Invalid credentials or insufficient permissions
114
117
  **Resolution:** Check your authentication credentials and user permissions
115
118
 
119
+
116
120
  ### VALIDATION_ERROR
117
121
 
118
122
  **Message:** Parameter validation failed
119
123
  **Description:** One or more required parameters are missing or invalid
120
124
  **Resolution:** Review the required parameters and their formats
121
125
 
126
+
122
127
  ### NOT_FOUND
123
128
 
124
129
  **Message:** Resource not found
125
130
  **Description:** The requested resource does not exist
126
131
  **Resolution:** Verify the resource ID and ensure it exists
127
132
 
133
+
128
134
  ### PERMISSION_DENIED
129
135
 
130
136
  **Message:** Insufficient permissions
131
137
  **Description:** The user does not have permission to perform this action
132
138
  **Resolution:** Contact an administrator to grant the necessary permissions
133
139
 
140
+
141
+
142
+
134
143
  ---
135
144
 
136
145
  *Generated automatically from tool definitions - Do not edit manually*
@@ -21,13 +21,11 @@ Lists posts from a WordPress site, with filters.
21
21
  Simple example of using wp_list_posts
22
22
 
23
23
  **Command:**
24
-
25
24
  ```bash
26
25
  wp_list_posts
27
26
  ```
28
27
 
29
28
  **Response:**
30
-
31
29
  ```json
32
30
  {
33
31
  "success": true,
@@ -49,7 +47,6 @@ wp_list_posts
49
47
  ```
50
48
 
51
49
  **Error Example (Authentication failure):**
52
-
53
50
  ```json
54
51
  {
55
52
  "error": "Authentication failed",
@@ -57,18 +54,17 @@ wp_list_posts
57
54
  }
58
55
  ```
59
56
 
57
+
60
58
  ### Advanced post Configuration
61
59
 
62
60
  Comprehensive example using all available parameters
63
61
 
64
62
  **Command:**
65
-
66
63
  ```bash
67
64
  wp_list_posts --per_page="10" --search="wordpress" --status="publish" --categories="example_value" --tags="example_value"
68
65
  ```
69
66
 
70
67
  **Response:**
71
-
72
68
  ```json
73
69
  {
74
70
  "success": true,
@@ -89,17 +85,23 @@ wp_list_posts --per_page="10" --search="wordpress" --status="publish" --categori
89
85
  }
90
86
  ```
91
87
 
88
+
89
+
90
+
92
91
  ## WordPress REST API Mapping
93
92
 
94
93
  **Endpoint:** `/wp-json/wp/v2/posts`
95
94
 
96
- This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
95
+ This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
96
+ parameters are determined by WordPress core functionality.
97
97
 
98
98
  ### WordPress Documentation
99
-
100
99
  - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)
101
100
  - [Endpoint Reference](https://developer.wordpress.org/rest-api/reference/)
102
101
 
102
+
103
+
104
+
103
105
  ## Response Format
104
106
 
105
107
  **Return Type:** `post[]`
@@ -126,24 +128,30 @@ This tool directly interfaces with the WordPress REST API endpoint above. The re
126
128
  **Description:** Invalid credentials or insufficient permissions
127
129
  **Resolution:** Check your authentication credentials and user permissions
128
130
 
131
+
129
132
  ### VALIDATION_ERROR
130
133
 
131
134
  **Message:** Parameter validation failed
132
135
  **Description:** One or more required parameters are missing or invalid
133
136
  **Resolution:** Review the required parameters and their formats
134
137
 
138
+
135
139
  ### NOT_FOUND
136
140
 
137
141
  **Message:** Resource not found
138
142
  **Description:** The requested resource does not exist
139
143
  **Resolution:** Verify the resource ID and ensure it exists
140
144
 
145
+
141
146
  ### PERMISSION_DENIED
142
147
 
143
148
  **Message:** Insufficient permissions
144
149
  **Description:** The user does not have permission to perform this action
145
150
  **Resolution:** Contact an administrator to grant the necessary permissions
146
151
 
152
+
153
+
154
+
147
155
  ---
148
156
 
149
157
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Lists tags from a WordPress site.
17
17
  Simple example of using wp_list_tags
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_list_tags
23
22
  ```
24
23
 
25
24
  **Response:**
26
-
27
25
  ```json
28
26
  {
29
27
  "success": true,
@@ -45,7 +43,6 @@ wp_list_tags
45
43
  ```
46
44
 
47
45
  **Error Example (Authentication failure):**
48
-
49
46
  ```json
50
47
  {
51
48
  "error": "Authentication failed",
@@ -53,6 +50,11 @@ wp_list_tags
53
50
  }
54
51
  ```
55
52
 
53
+
54
+
55
+
56
+
57
+
56
58
  ## Response Format
57
59
 
58
60
  **Return Type:** `taxonomy[]`
@@ -79,24 +81,30 @@ wp_list_tags
79
81
  **Description:** Invalid credentials or insufficient permissions
80
82
  **Resolution:** Check your authentication credentials and user permissions
81
83
 
84
+
82
85
  ### VALIDATION_ERROR
83
86
 
84
87
  **Message:** Parameter validation failed
85
88
  **Description:** One or more required parameters are missing or invalid
86
89
  **Resolution:** Review the required parameters and their formats
87
90
 
91
+
88
92
  ### NOT_FOUND
89
93
 
90
94
  **Message:** Resource not found
91
95
  **Description:** The requested resource does not exist
92
96
  **Resolution:** Verify the resource ID and ensure it exists
93
97
 
98
+
94
99
  ### PERMISSION_DENIED
95
100
 
96
101
  **Message:** Insufficient permissions
97
102
  **Description:** The user does not have permission to perform this action
98
103
  **Resolution:** Contact an administrator to grant the necessary permissions
99
104
 
105
+
106
+
107
+
100
108
  ---
101
109
 
102
110
  *Generated automatically from tool definitions - Do not edit manually*
@@ -18,13 +18,11 @@ Lists users from a WordPress site, with filters.
18
18
  Simple example of using wp_list_users
19
19
 
20
20
  **Command:**
21
-
22
21
  ```bash
23
22
  wp_list_users
24
23
  ```
25
24
 
26
25
  **Response:**
27
-
28
26
  ```json
29
27
  {
30
28
  "success": true,
@@ -46,7 +44,6 @@ wp_list_users
46
44
  ```
47
45
 
48
46
  **Error Example (Authentication failure):**
49
-
50
47
  ```json
51
48
  {
52
49
  "error": "Authentication failed",
@@ -54,6 +51,11 @@ wp_list_users
54
51
  }
55
52
  ```
56
53
 
54
+
55
+
56
+
57
+
58
+
57
59
  ## Response Format
58
60
 
59
61
  **Return Type:** `user[]`
@@ -80,24 +82,30 @@ wp_list_users
80
82
  **Description:** Invalid credentials or insufficient permissions
81
83
  **Resolution:** Check your authentication credentials and user permissions
82
84
 
85
+
83
86
  ### VALIDATION_ERROR
84
87
 
85
88
  **Message:** Parameter validation failed
86
89
  **Description:** One or more required parameters are missing or invalid
87
90
  **Resolution:** Review the required parameters and their formats
88
91
 
92
+
89
93
  ### NOT_FOUND
90
94
 
91
95
  **Message:** Resource not found
92
96
  **Description:** The requested resource does not exist
93
97
  **Resolution:** Verify the resource ID and ensure it exists
94
98
 
99
+
95
100
  ### PERMISSION_DENIED
96
101
 
97
102
  **Message:** Insufficient permissions
98
103
  **Description:** The user does not have permission to perform this action
99
104
  **Resolution:** Contact an administrator to grant the necessary permissions
100
105
 
106
+
107
+
108
+
101
109
  ---
102
110
 
103
111
  *Generated automatically from tool definitions - Do not edit manually*