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 @@ Marks a comment as spam.
17
17
  Simple example of using wp_spam_comment
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_spam_comment --id="123"
23
22
  ```
24
23
 
25
24
  **Response:**
26
-
27
25
  ```json
28
26
  {
29
27
  "success": true,
@@ -33,7 +31,6 @@ wp_spam_comment --id="123"
33
31
  ```
34
32
 
35
33
  **Error Example (Authentication failure):**
36
-
37
34
  ```json
38
35
  {
39
36
  "error": "Authentication failed",
@@ -41,6 +38,11 @@ wp_spam_comment --id="123"
41
38
  }
42
39
  ```
43
40
 
41
+
42
+
43
+
44
+
45
+
44
46
  ## Response Format
45
47
 
46
48
  **Return Type:** `object`
@@ -67,24 +69,30 @@ wp_spam_comment --id="123"
67
69
  **Description:** Invalid credentials or insufficient permissions
68
70
  **Resolution:** Check your authentication credentials and user permissions
69
71
 
72
+
70
73
  ### VALIDATION_ERROR
71
74
 
72
75
  **Message:** Parameter validation failed
73
76
  **Description:** One or more required parameters are missing or invalid
74
77
  **Resolution:** Review the required parameters and their formats
75
78
 
79
+
76
80
  ### NOT_FOUND
77
81
 
78
82
  **Message:** Resource not found
79
83
  **Description:** The requested resource does not exist
80
84
  **Resolution:** Verify the resource ID and ensure it exists
81
85
 
86
+
82
87
  ### PERMISSION_DENIED
83
88
 
84
89
  **Message:** Insufficient permissions
85
90
  **Description:** The user does not have permission to perform this action
86
91
  **Resolution:** Contact an administrator to grant the necessary permissions
87
92
 
93
+
94
+
95
+
88
96
  ---
89
97
 
90
98
  *Generated automatically from tool definitions - Do not edit manually*
@@ -20,13 +20,11 @@ Switches the authentication method for a site for the current session.
20
20
  Simple example of using wp_switch_auth_method
21
21
 
22
22
  **Command:**
23
-
24
23
  ```bash
25
24
  wp_switch_auth_method --method="example_value"
26
25
  ```
27
26
 
28
27
  **Response:**
29
-
30
28
  ```json
31
29
  {
32
30
  "success": true,
@@ -36,7 +34,6 @@ wp_switch_auth_method --method="example_value"
36
34
  ```
37
35
 
38
36
  **Error Example (Authentication failure):**
39
-
40
37
  ```json
41
38
  {
42
39
  "error": "Authentication failed",
@@ -44,18 +41,17 @@ wp_switch_auth_method --method="example_value"
44
41
  }
45
42
  ```
46
43
 
44
+
47
45
  ### Advanced auth Configuration
48
46
 
49
47
  Comprehensive example using all available parameters
50
48
 
51
49
  **Command:**
52
-
53
50
  ```bash
54
51
  wp_switch_auth_method --method="example_value" --username="john_doe" --password="example_value" --jwt_token="example_value"
55
52
  ```
56
53
 
57
54
  **Response:**
58
-
59
55
  ```json
60
56
  {
61
57
  "success": true,
@@ -64,6 +60,13 @@ wp_switch_auth_method --method="example_value" --username="john_doe" --password=
64
60
  }
65
61
  ```
66
62
 
63
+
64
+
65
+
66
+
67
+
68
+
69
+
67
70
  ## Response Format
68
71
 
69
72
  **Return Type:** `object`
@@ -90,24 +93,30 @@ wp_switch_auth_method --method="example_value" --username="john_doe" --password=
90
93
  **Description:** Invalid credentials or insufficient permissions
91
94
  **Resolution:** Check your authentication credentials and user permissions
92
95
 
96
+
93
97
  ### VALIDATION_ERROR
94
98
 
95
99
  **Message:** Parameter validation failed
96
100
  **Description:** One or more required parameters are missing or invalid
97
101
  **Resolution:** Review the required parameters and their formats
98
102
 
103
+
99
104
  ### NOT_FOUND
100
105
 
101
106
  **Message:** Resource not found
102
107
  **Description:** The requested resource does not exist
103
108
  **Resolution:** Verify the resource ID and ensure it exists
104
109
 
110
+
105
111
  ### PERMISSION_DENIED
106
112
 
107
113
  **Message:** Insufficient permissions
108
114
  **Description:** The user does not have permission to perform this action
109
115
  **Resolution:** Contact an administrator to grant the necessary permissions
110
116
 
117
+
118
+
119
+
111
120
  ---
112
121
 
113
122
  *Generated automatically from tool definitions - Do not edit manually*
@@ -15,13 +15,11 @@ Tests the authentication and connectivity for a configured WordPress site.
15
15
  Simple example of using wp_test_auth
16
16
 
17
17
  **Command:**
18
-
19
18
  ```bash
20
19
  wp_test_auth
21
20
  ```
22
21
 
23
22
  **Response:**
24
-
25
23
  ```json
26
24
  {
27
25
  "success": true,
@@ -31,7 +29,6 @@ wp_test_auth
31
29
  ```
32
30
 
33
31
  **Error Example (Authentication failure):**
34
-
35
32
  ```json
36
33
  {
37
34
  "error": "Authentication failed",
@@ -39,6 +36,11 @@ wp_test_auth
39
36
  }
40
37
  ```
41
38
 
39
+
40
+
41
+
42
+
43
+
42
44
  ## Response Format
43
45
 
44
46
  **Return Type:** `object`
@@ -65,24 +67,30 @@ wp_test_auth
65
67
  **Description:** Invalid credentials or insufficient permissions
66
68
  **Resolution:** Check your authentication credentials and user permissions
67
69
 
70
+
68
71
  ### VALIDATION_ERROR
69
72
 
70
73
  **Message:** Parameter validation failed
71
74
  **Description:** One or more required parameters are missing or invalid
72
75
  **Resolution:** Review the required parameters and their formats
73
76
 
77
+
74
78
  ### NOT_FOUND
75
79
 
76
80
  **Message:** Resource not found
77
81
  **Description:** The requested resource does not exist
78
82
  **Resolution:** Verify the resource ID and ensure it exists
79
83
 
84
+
80
85
  ### PERMISSION_DENIED
81
86
 
82
87
  **Message:** Insufficient permissions
83
88
  **Description:** The user does not have permission to perform this action
84
89
  **Resolution:** Contact an administrator to grant the necessary permissions
85
90
 
91
+
92
+
93
+
86
94
  ---
87
95
 
88
96
  *Generated automatically from tool definitions - Do not edit manually*
@@ -18,13 +18,11 @@ Updates an existing category.
18
18
  Simple example of using wp_update_category
19
19
 
20
20
  **Command:**
21
-
22
21
  ```bash
23
22
  wp_update_category --id="123"
24
23
  ```
25
24
 
26
25
  **Response:**
27
-
28
26
  ```json
29
27
  {
30
28
  "success": true,
@@ -37,7 +35,6 @@ wp_update_category --id="123"
37
35
  ```
38
36
 
39
37
  **Error Example (Authentication failure):**
40
-
41
38
  ```json
42
39
  {
43
40
  "error": "Authentication failed",
@@ -45,6 +42,11 @@ wp_update_category --id="123"
45
42
  }
46
43
  ```
47
44
 
45
+
46
+
47
+
48
+
49
+
48
50
  ## Response Format
49
51
 
50
52
  **Return Type:** `taxonomy`
@@ -71,24 +73,30 @@ wp_update_category --id="123"
71
73
  **Description:** Invalid credentials or insufficient permissions
72
74
  **Resolution:** Check your authentication credentials and user permissions
73
75
 
76
+
74
77
  ### VALIDATION_ERROR
75
78
 
76
79
  **Message:** Parameter validation failed
77
80
  **Description:** One or more required parameters are missing or invalid
78
81
  **Resolution:** Review the required parameters and their formats
79
82
 
83
+
80
84
  ### NOT_FOUND
81
85
 
82
86
  **Message:** Resource not found
83
87
  **Description:** The requested resource does not exist
84
88
  **Resolution:** Verify the resource ID and ensure it exists
85
89
 
90
+
86
91
  ### PERMISSION_DENIED
87
92
 
88
93
  **Message:** Insufficient permissions
89
94
  **Description:** The user does not have permission to perform this action
90
95
  **Resolution:** Contact an administrator to grant the necessary permissions
91
96
 
97
+
98
+
99
+
92
100
  ---
93
101
 
94
102
  *Generated automatically from tool definitions - Do not edit manually*
@@ -19,13 +19,11 @@ Updates an existing comment.
19
19
  Simple example of using wp_update_comment
20
20
 
21
21
  **Command:**
22
-
23
22
  ```bash
24
23
  wp_update_comment --id="123"
25
24
  ```
26
25
 
27
26
  **Response:**
28
-
29
27
  ```json
30
28
  {
31
29
  "success": true,
@@ -38,7 +36,6 @@ wp_update_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,18 +43,17 @@ wp_update_comment --id="123"
46
43
  }
47
44
  ```
48
45
 
46
+
49
47
  ### Advanced comment Configuration
50
48
 
51
49
  Comprehensive example using all available parameters
52
50
 
53
51
  **Command:**
54
-
55
52
  ```bash
56
53
  wp_update_comment --id="123" --content="This is example content for the post." --status="publish"
57
54
  ```
58
55
 
59
56
  **Response:**
60
-
61
57
  ```json
62
58
  {
63
59
  "success": true,
@@ -69,6 +65,13 @@ wp_update_comment --id="123" --content="This is example content for the post." -
69
65
  }
70
66
  ```
71
67
 
68
+
69
+
70
+
71
+
72
+
73
+
74
+
72
75
  ## Response Format
73
76
 
74
77
  **Return Type:** `comment`
@@ -95,24 +98,30 @@ wp_update_comment --id="123" --content="This is example content for the post." -
95
98
  **Description:** Invalid credentials or insufficient permissions
96
99
  **Resolution:** Check your authentication credentials and user permissions
97
100
 
101
+
98
102
  ### VALIDATION_ERROR
99
103
 
100
104
  **Message:** Parameter validation failed
101
105
  **Description:** One or more required parameters are missing or invalid
102
106
  **Resolution:** Review the required parameters and their formats
103
107
 
108
+
104
109
  ### NOT_FOUND
105
110
 
106
111
  **Message:** Resource not found
107
112
  **Description:** The requested resource does not exist
108
113
  **Resolution:** Verify the resource ID and ensure it exists
109
114
 
115
+
110
116
  ### PERMISSION_DENIED
111
117
 
112
118
  **Message:** Insufficient permissions
113
119
  **Description:** The user does not have permission to perform this action
114
120
  **Resolution:** Contact an administrator to grant the necessary permissions
115
121
 
122
+
123
+
124
+
116
125
  ---
117
126
 
118
127
  *Generated automatically from tool definitions - Do not edit manually*
@@ -21,13 +21,11 @@ Updates the metadata of an existing media item.
21
21
  Simple example of using wp_update_media
22
22
 
23
23
  **Command:**
24
-
25
24
  ```bash
26
25
  wp_update_media --id="123"
27
26
  ```
28
27
 
29
28
  **Response:**
30
-
31
29
  ```json
32
30
  {
33
31
  "success": true,
@@ -40,7 +38,6 @@ wp_update_media --id="123"
40
38
  ```
41
39
 
42
40
  **Error Example (Authentication failure):**
43
-
44
41
  ```json
45
42
  {
46
43
  "error": "Authentication failed",
@@ -48,18 +45,17 @@ wp_update_media --id="123"
48
45
  }
49
46
  ```
50
47
 
48
+
51
49
  ### Advanced media Configuration
52
50
 
53
51
  Comprehensive example using all available parameters
54
52
 
55
53
  **Command:**
56
-
57
54
  ```bash
58
55
  wp_update_media --id="123" --title="Example Post Title" --alt_text="example_value" --caption="example_value" --description="example_value"
59
56
  ```
60
57
 
61
58
  **Response:**
62
-
63
59
  ```json
64
60
  {
65
61
  "success": true,
@@ -71,6 +67,13 @@ wp_update_media --id="123" --title="Example Post Title" --alt_text="example_valu
71
67
  }
72
68
  ```
73
69
 
70
+
71
+
72
+
73
+
74
+
75
+
76
+
74
77
  ## Response Format
75
78
 
76
79
  **Return Type:** `media`
@@ -97,24 +100,30 @@ wp_update_media --id="123" --title="Example Post Title" --alt_text="example_valu
97
100
  **Description:** Invalid credentials or insufficient permissions
98
101
  **Resolution:** Check your authentication credentials and user permissions
99
102
 
103
+
100
104
  ### VALIDATION_ERROR
101
105
 
102
106
  **Message:** Parameter validation failed
103
107
  **Description:** One or more required parameters are missing or invalid
104
108
  **Resolution:** Review the required parameters and their formats
105
109
 
110
+
106
111
  ### NOT_FOUND
107
112
 
108
113
  **Message:** Resource not found
109
114
  **Description:** The requested resource does not exist
110
115
  **Resolution:** Verify the resource ID and ensure it exists
111
116
 
117
+
112
118
  ### PERMISSION_DENIED
113
119
 
114
120
  **Message:** Insufficient permissions
115
121
  **Description:** The user does not have permission to perform this action
116
122
  **Resolution:** Contact an administrator to grant the necessary permissions
117
123
 
124
+
125
+
126
+
118
127
  ---
119
128
 
120
129
  *Generated automatically from tool definitions - Do not edit manually*
@@ -20,13 +20,11 @@ Updates an existing page.
20
20
  Simple example of using wp_update_page
21
21
 
22
22
  **Command:**
23
-
24
23
  ```bash
25
24
  wp_update_page --id="123"
26
25
  ```
27
26
 
28
27
  **Response:**
29
-
30
28
  ```json
31
29
  {
32
30
  "success": true,
@@ -39,7 +37,6 @@ wp_update_page --id="123"
39
37
  ```
40
38
 
41
39
  **Error Example (Authentication failure):**
42
-
43
40
  ```json
44
41
  {
45
42
  "error": "Authentication failed",
@@ -47,18 +44,17 @@ wp_update_page --id="123"
47
44
  }
48
45
  ```
49
46
 
47
+
50
48
  ### Advanced page Configuration
51
49
 
52
50
  Comprehensive example using all available parameters
53
51
 
54
52
  **Command:**
55
-
56
53
  ```bash
57
54
  wp_update_page --id="123" --title="Example Post Title" --content="This is example content for the post." --status="publish"
58
55
  ```
59
56
 
60
57
  **Response:**
61
-
62
58
  ```json
63
59
  {
64
60
  "success": true,
@@ -70,6 +66,11 @@ wp_update_page --id="123" --title="Example Post Title" --content="This is exampl
70
66
  }
71
67
  ```
72
68
 
69
+
70
+
71
+
72
+
73
+
73
74
  ## Required Permissions
74
75
 
75
76
  This tool requires the following WordPress user capabilities:
@@ -78,6 +79,7 @@ This tool requires the following WordPress user capabilities:
78
79
 
79
80
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
80
81
 
82
+
81
83
  ## Response Format
82
84
 
83
85
  **Return Type:** `page`
@@ -104,24 +106,30 @@ This tool requires the following WordPress user capabilities:
104
106
  **Description:** Invalid credentials or insufficient permissions
105
107
  **Resolution:** Check your authentication credentials and user permissions
106
108
 
109
+
107
110
  ### VALIDATION_ERROR
108
111
 
109
112
  **Message:** Parameter validation failed
110
113
  **Description:** One or more required parameters are missing or invalid
111
114
  **Resolution:** Review the required parameters and their formats
112
115
 
116
+
113
117
  ### NOT_FOUND
114
118
 
115
119
  **Message:** Resource not found
116
120
  **Description:** The requested resource does not exist
117
121
  **Resolution:** Verify the resource ID and ensure it exists
118
122
 
123
+
119
124
  ### PERMISSION_DENIED
120
125
 
121
126
  **Message:** Insufficient permissions
122
127
  **Description:** The user does not have permission to perform this action
123
128
  **Resolution:** Contact an administrator to grant the necessary permissions
124
129
 
130
+
131
+
132
+
125
133
  ---
126
134
 
127
135
  *Generated automatically from tool definitions - Do not edit manually*
@@ -20,13 +20,11 @@ Updates an existing post.
20
20
  Simple example of using wp_update_post
21
21
 
22
22
  **Command:**
23
-
24
23
  ```bash
25
24
  wp_update_post --id="123"
26
25
  ```
27
26
 
28
27
  **Response:**
29
-
30
28
  ```json
31
29
  {
32
30
  "success": true,
@@ -39,7 +37,6 @@ wp_update_post --id="123"
39
37
  ```
40
38
 
41
39
  **Error Example (Authentication failure):**
42
-
43
40
  ```json
44
41
  {
45
42
  "error": "Authentication failed",
@@ -47,18 +44,17 @@ wp_update_post --id="123"
47
44
  }
48
45
  ```
49
46
 
47
+
50
48
  ### Advanced post Configuration
51
49
 
52
50
  Comprehensive example using all available parameters
53
51
 
54
52
  **Command:**
55
-
56
53
  ```bash
57
54
  wp_update_post --id="123" --title="Example Post Title" --content="This is example content for the post." --status="publish"
58
55
  ```
59
56
 
60
57
  **Response:**
61
-
62
58
  ```json
63
59
  {
64
60
  "success": true,
@@ -70,17 +66,21 @@ wp_update_post --id="123" --title="Example Post Title" --content="This is exampl
70
66
  }
71
67
  ```
72
68
 
69
+
70
+
71
+
73
72
  ## WordPress REST API Mapping
74
73
 
75
74
  **Endpoint:** `/wp-json/wp/v2/posts/{id}`
76
75
 
77
- This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
76
+ This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
77
+ parameters are determined by WordPress core functionality.
78
78
 
79
79
  ### WordPress Documentation
80
-
81
80
  - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)
82
81
  - [Endpoint Reference](https://developer.wordpress.org/rest-api/reference/)
83
82
 
83
+
84
84
  ## Required Permissions
85
85
 
86
86
  This tool requires the following WordPress user capabilities:
@@ -89,6 +89,7 @@ This tool requires the following WordPress user capabilities:
89
89
 
90
90
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
91
91
 
92
+
92
93
  ## Response Format
93
94
 
94
95
  **Return Type:** `post`
@@ -115,24 +116,30 @@ This tool requires the following WordPress user capabilities:
115
116
  **Description:** Invalid credentials or insufficient permissions
116
117
  **Resolution:** Check your authentication credentials and user permissions
117
118
 
119
+
118
120
  ### VALIDATION_ERROR
119
121
 
120
122
  **Message:** Parameter validation failed
121
123
  **Description:** One or more required parameters are missing or invalid
122
124
  **Resolution:** Review the required parameters and their formats
123
125
 
126
+
124
127
  ### NOT_FOUND
125
128
 
126
129
  **Message:** Resource not found
127
130
  **Description:** The requested resource does not exist
128
131
  **Resolution:** Verify the resource ID and ensure it exists
129
132
 
133
+
130
134
  ### PERMISSION_DENIED
131
135
 
132
136
  **Message:** Insufficient permissions
133
137
  **Description:** The user does not have permission to perform this action
134
138
  **Resolution:** Contact an administrator to grant the necessary permissions
135
139
 
140
+
141
+
142
+
136
143
  ---
137
144
 
138
145
  *Generated automatically from tool definitions - Do not edit manually*