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
@@ -15,13 +15,11 @@ Gets the current authentication status for a configured WordPress site.
15
15
  Simple example of using wp_get_auth_status
16
16
 
17
17
  **Command:**
18
-
19
18
  ```bash
20
19
  wp_get_auth_status
21
20
  ```
22
21
 
23
22
  **Response:**
24
-
25
23
  ```json
26
24
  {
27
25
  "success": true,
@@ -36,7 +34,6 @@ wp_get_auth_status
36
34
  ```
37
35
 
38
36
  **Error Example (Authentication failure):**
39
-
40
37
  ```json
41
38
  {
42
39
  "error": "Authentication failed",
@@ -44,6 +41,11 @@ wp_get_auth_status
44
41
  }
45
42
  ```
46
43
 
44
+
45
+
46
+
47
+
48
+
47
49
  ## Response Format
48
50
 
49
51
  **Return Type:** `auth`
@@ -70,24 +72,30 @@ wp_get_auth_status
70
72
  **Description:** Invalid credentials or insufficient permissions
71
73
  **Resolution:** Check your authentication credentials and user permissions
72
74
 
75
+
73
76
  ### VALIDATION_ERROR
74
77
 
75
78
  **Message:** Parameter validation failed
76
79
  **Description:** One or more required parameters are missing or invalid
77
80
  **Resolution:** Review the required parameters and their formats
78
81
 
82
+
79
83
  ### NOT_FOUND
80
84
 
81
85
  **Message:** Resource not found
82
86
  **Description:** The requested resource does not exist
83
87
  **Resolution:** Verify the resource ID and ensure it exists
84
88
 
89
+
85
90
  ### PERMISSION_DENIED
86
91
 
87
92
  **Message:** Insufficient permissions
88
93
  **Description:** The user does not have permission to perform this action
89
94
  **Resolution:** Contact an administrator to grant the necessary permissions
90
95
 
96
+
97
+
98
+
91
99
  ---
92
100
 
93
101
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Retrieves a single category by its ID.
17
17
  Simple example of using wp_get_category
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_category --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_category --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_category --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_category --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 comment by its ID.
17
17
  Simple example of using wp_get_comment
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_comment --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_comment --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_comment --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `comment`
@@ -72,24 +74,30 @@ wp_get_comment --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*
@@ -15,13 +15,11 @@ Retrieves the currently authenticated user.
15
15
  Simple example of using wp_get_current_user
16
16
 
17
17
  **Command:**
18
-
19
18
  ```bash
20
19
  wp_get_current_user
21
20
  ```
22
21
 
23
22
  **Response:**
24
-
25
23
  ```json
26
24
  {
27
25
  "success": true,
@@ -36,7 +34,6 @@ wp_get_current_user
36
34
  ```
37
35
 
38
36
  **Error Example (Authentication failure):**
39
-
40
37
  ```json
41
38
  {
42
39
  "error": "Authentication failed",
@@ -44,6 +41,11 @@ wp_get_current_user
44
41
  }
45
42
  ```
46
43
 
44
+
45
+
46
+
47
+
48
+
47
49
  ## Response Format
48
50
 
49
51
  **Return Type:** `user`
@@ -70,24 +72,30 @@ wp_get_current_user
70
72
  **Description:** Invalid credentials or insufficient permissions
71
73
  **Resolution:** Check your authentication credentials and user permissions
72
74
 
75
+
73
76
  ### VALIDATION_ERROR
74
77
 
75
78
  **Message:** Parameter validation failed
76
79
  **Description:** One or more required parameters are missing or invalid
77
80
  **Resolution:** Review the required parameters and their formats
78
81
 
82
+
79
83
  ### NOT_FOUND
80
84
 
81
85
  **Message:** Resource not found
82
86
  **Description:** The requested resource does not exist
83
87
  **Resolution:** Verify the resource ID and ensure it exists
84
88
 
89
+
85
90
  ### PERMISSION_DENIED
86
91
 
87
92
  **Message:** Insufficient permissions
88
93
  **Description:** The user does not have permission to perform this action
89
94
  **Resolution:** Contact an administrator to grant the necessary permissions
90
95
 
96
+
97
+
98
+
91
99
  ---
92
100
 
93
101
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Retrieves a single media item by its ID.
17
17
  Simple example of using wp_get_media
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_media --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_media --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_media --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `media`
@@ -72,24 +74,30 @@ wp_get_media --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 page by its ID.
17
17
  Simple example of using wp_get_page
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_page --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_page --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_page --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `page`
@@ -72,24 +74,30 @@ wp_get_page --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 revisions for a specific page.
17
17
  Simple example of using wp_get_page_revisions
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_page_revisions --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_page_revisions --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_page_revisions --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `page`
@@ -72,24 +74,30 @@ wp_get_page_revisions --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 post by its ID.
17
17
  Simple example of using wp_get_post
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_post --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_post --id="123"
38
36
  ```
39
37
 
40
38
  **Error Example (Authentication failure):**
41
-
42
39
  ```json
43
40
  {
44
41
  "error": "Authentication failed",
@@ -46,17 +43,21 @@ wp_get_post --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
49
47
  ## WordPress REST API Mapping
50
48
 
51
49
  **Endpoint:** `/wp-json/wp/v2/posts/{id}`
52
50
 
53
- This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
51
+ This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
52
+ parameters are determined by WordPress core functionality.
54
53
 
55
54
  ### WordPress Documentation
56
-
57
55
  - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)
58
56
  - [Endpoint Reference](https://developer.wordpress.org/rest-api/reference/)
59
57
 
58
+
59
+
60
+
60
61
  ## Response Format
61
62
 
62
63
  **Return Type:** `post`
@@ -83,24 +84,30 @@ This tool directly interfaces with the WordPress REST API endpoint above. The re
83
84
  **Description:** Invalid credentials or insufficient permissions
84
85
  **Resolution:** Check your authentication credentials and user permissions
85
86
 
87
+
86
88
  ### VALIDATION_ERROR
87
89
 
88
90
  **Message:** Parameter validation failed
89
91
  **Description:** One or more required parameters are missing or invalid
90
92
  **Resolution:** Review the required parameters and their formats
91
93
 
94
+
92
95
  ### NOT_FOUND
93
96
 
94
97
  **Message:** Resource not found
95
98
  **Description:** The requested resource does not exist
96
99
  **Resolution:** Verify the resource ID and ensure it exists
97
100
 
101
+
98
102
  ### PERMISSION_DENIED
99
103
 
100
104
  **Message:** Insufficient permissions
101
105
  **Description:** The user does not have permission to perform this action
102
106
  **Resolution:** Contact an administrator to grant the necessary permissions
103
107
 
108
+
109
+
110
+
104
111
  ---
105
112
 
106
113
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Retrieves revisions for a specific post.
17
17
  Simple example of using wp_get_post_revisions
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_get_post_revisions --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_post_revisions --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_post_revisions --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
47
+
48
+
49
+
50
+
49
51
  ## Response Format
50
52
 
51
53
  **Return Type:** `post`
@@ -72,24 +74,30 @@ wp_get_post_revisions --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*
@@ -15,13 +15,11 @@ Retrieves the general settings for a WordPress site.
15
15
  Simple example of using wp_get_site_settings
16
16
 
17
17
  **Command:**
18
-
19
18
  ```bash
20
19
  wp_get_site_settings
21
20
  ```
22
21
 
23
22
  **Response:**
24
-
25
23
  ```json
26
24
  {
27
25
  "success": true,
@@ -36,7 +34,6 @@ wp_get_site_settings
36
34
  ```
37
35
 
38
36
  **Error Example (Authentication failure):**
39
-
40
37
  ```json
41
38
  {
42
39
  "error": "Authentication failed",
@@ -44,6 +41,9 @@ wp_get_site_settings
44
41
  }
45
42
  ```
46
43
 
44
+
45
+
46
+
47
47
  ## Required Permissions
48
48
 
49
49
  This tool requires the following WordPress user capabilities:
@@ -52,6 +52,7 @@ This tool requires the following WordPress user capabilities:
52
52
 
53
53
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
54
54
 
55
+
55
56
  ## Response Format
56
57
 
57
58
  **Return Type:** `site`
@@ -78,24 +79,30 @@ This tool requires the following WordPress user capabilities:
78
79
  **Description:** Invalid credentials or insufficient permissions
79
80
  **Resolution:** Check your authentication credentials and user permissions
80
81
 
82
+
81
83
  ### VALIDATION_ERROR
82
84
 
83
85
  **Message:** Parameter validation failed
84
86
  **Description:** One or more required parameters are missing or invalid
85
87
  **Resolution:** Review the required parameters and their formats
86
88
 
89
+
87
90
  ### NOT_FOUND
88
91
 
89
92
  **Message:** Resource not found
90
93
  **Description:** The requested resource does not exist
91
94
  **Resolution:** Verify the resource ID and ensure it exists
92
95
 
96
+
93
97
  ### PERMISSION_DENIED
94
98
 
95
99
  **Message:** Insufficient permissions
96
100
  **Description:** The user does not have permission to perform this action
97
101
  **Resolution:** Contact an administrator to grant the necessary permissions
98
102
 
103
+
104
+
105
+
99
106
  ---
100
107
 
101
108
  *Generated automatically from tool definitions - Do not edit manually*