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 @@ Creates a new category.
6
6
 
7
7
  ## Parameters
8
8
 
9
- | Parameter | Type | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `name` | `string` | ✅ | The name of the category. | - | `example` |
12
- | `description` | `string` | ❌ | The description for the category. | - | `example` |
9
+ | Parameter | Type | Required | Description | Default | Examples |
10
+ | ------------- | -------- | -------- | --------------------------------- | ------- | --------- |
11
+ | `name` | `string` | ✅ | The name of the category. | - | `example` |
12
+ | `description` | `string` | ❌ | The description for the category. | - | `example` |
13
13
 
14
14
  ## Examples
15
15
 
@@ -18,11 +18,13 @@ Creates a new category.
18
18
  Simple example of using wp_create_category
19
19
 
20
20
  **Command:**
21
+
21
22
  ```bash
22
23
  wp_create_category --name="example_value"
23
24
  ```
24
25
 
25
26
  **Response:**
27
+
26
28
  ```json
27
29
  {
28
30
  "success": true,
@@ -35,6 +37,7 @@ wp_create_category --name="example_value"
35
37
  ```
36
38
 
37
39
  **Error Example (Authentication failure):**
40
+
38
41
  ```json
39
42
  {
40
43
  "error": "Authentication failed",
@@ -42,11 +45,6 @@ wp_create_category --name="example_value"
42
45
  }
43
46
  ```
44
47
 
45
-
46
-
47
-
48
-
49
-
50
48
  ## Response Format
51
49
 
52
50
  **Return Type:** `taxonomy`
@@ -69,34 +67,24 @@ wp_create_category --name="example_value"
69
67
 
70
68
  ### AUTHENTICATION_FAILED
71
69
 
72
- **Message:** Authentication failed
73
- **Description:** Invalid credentials or insufficient permissions
74
- **Resolution:** Check your authentication credentials and user permissions
75
-
70
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
71
+ Check your authentication credentials and user permissions
76
72
 
77
73
  ### VALIDATION_ERROR
78
74
 
79
- **Message:** Parameter validation failed
80
- **Description:** One or more required parameters are missing or invalid
75
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
81
76
  **Resolution:** Review the required parameters and their formats
82
77
 
83
-
84
78
  ### NOT_FOUND
85
79
 
86
- **Message:** Resource not found
87
- **Description:** The requested resource does not exist
88
- **Resolution:** Verify the resource ID and ensure it exists
89
-
80
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
81
+ resource ID and ensure it exists
90
82
 
91
83
  ### PERMISSION_DENIED
92
84
 
93
- **Message:** Insufficient permissions
94
- **Description:** The user does not have permission to perform this action
85
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
95
86
  **Resolution:** Contact an administrator to grant the necessary permissions
96
87
 
97
-
98
-
99
-
100
88
  ---
101
89
 
102
- *Generated automatically from tool definitions - Do not edit manually*
90
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -6,12 +6,12 @@ Creates a new comment on a post.
6
6
 
7
7
  ## Parameters
8
8
 
9
- | Parameter | Type | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `post` | `number` | ✅ | The ID of the post to comment on. | - | `example` |
12
- | `content` | `string` | ✅ | The content of the comment. | - | `<p>Post content here</p>`, `This is my post content` |
13
- | `author_name` | `string` | ❌ | The name of the comment author. | - | `example` |
14
- | `author_email` | `string` | ❌ | The email of the comment author. | - | `example` |
9
+ | Parameter | Type | Required | Description | Default | Examples |
10
+ | -------------- | -------- | -------- | --------------------------------- | ------- | ----------------------------------------------------- |
11
+ | `post` | `number` | ✅ | The ID of the post to comment on. | - | `example` |
12
+ | `content` | `string` | ✅ | The content of the comment. | - | `<p>Post content here</p>`, `This is my post content` |
13
+ | `author_name` | `string` | ❌ | The name of the comment author. | - | `example` |
14
+ | `author_email` | `string` | ❌ | The email of the comment author. | - | `example` |
15
15
 
16
16
  ## Examples
17
17
 
@@ -20,11 +20,13 @@ Creates a new comment on a post.
20
20
  Simple example of using wp_create_comment
21
21
 
22
22
  **Command:**
23
+
23
24
  ```bash
24
25
  wp_create_comment --post="example_value" --content="This is example content for the post."
25
26
  ```
26
27
 
27
28
  **Response:**
29
+
28
30
  ```json
29
31
  {
30
32
  "success": true,
@@ -37,6 +39,7 @@ wp_create_comment --post="example_value" --content="This is example content for
37
39
  ```
38
40
 
39
41
  **Error Example (Authentication failure):**
42
+
40
43
  ```json
41
44
  {
42
45
  "error": "Authentication failed",
@@ -44,17 +47,18 @@ wp_create_comment --post="example_value" --content="This is example content for
44
47
  }
45
48
  ```
46
49
 
47
-
48
50
  ### Advanced comment Configuration
49
51
 
50
52
  Comprehensive example using all available parameters
51
53
 
52
54
  **Command:**
55
+
53
56
  ```bash
54
57
  wp_create_comment --post="example_value" --content="This is example content for the post." --author_name="example_value" --author_email="example_value"
55
58
  ```
56
59
 
57
60
  **Response:**
61
+
58
62
  ```json
59
63
  {
60
64
  "success": true,
@@ -66,13 +70,6 @@ wp_create_comment --post="example_value" --content="This is example content for
66
70
  }
67
71
  ```
68
72
 
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
73
  ## Response Format
77
74
 
78
75
  **Return Type:** `comment`
@@ -95,34 +92,24 @@ wp_create_comment --post="example_value" --content="This is example content for
95
92
 
96
93
  ### AUTHENTICATION_FAILED
97
94
 
98
- **Message:** Authentication failed
99
- **Description:** Invalid credentials or insufficient permissions
100
- **Resolution:** Check your authentication credentials and user permissions
101
-
95
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
96
+ Check your authentication credentials and user permissions
102
97
 
103
98
  ### VALIDATION_ERROR
104
99
 
105
- **Message:** Parameter validation failed
106
- **Description:** One or more required parameters are missing or invalid
100
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
107
101
  **Resolution:** Review the required parameters and their formats
108
102
 
109
-
110
103
  ### NOT_FOUND
111
104
 
112
- **Message:** Resource not found
113
- **Description:** The requested resource does not exist
114
- **Resolution:** Verify the resource ID and ensure it exists
115
-
105
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
106
+ resource ID and ensure it exists
116
107
 
117
108
  ### PERMISSION_DENIED
118
109
 
119
- **Message:** Insufficient permissions
120
- **Description:** The user does not have permission to perform this action
110
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
121
111
  **Resolution:** Contact an administrator to grant the necessary permissions
122
112
 
123
-
124
-
125
-
126
113
  ---
127
114
 
128
- *Generated automatically from tool definitions - Do not edit manually*
115
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -6,11 +6,11 @@ Creates a new page.
6
6
 
7
7
  ## Parameters
8
8
 
9
- | Parameter | Type | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `title` | `string` | ✅ | The title for the page. | - | `My Blog Post`, `Hello World` |
12
- | `content` | `string` | ❌ | The content for the page, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
13
- | `status` | `string` | ❌ | The publishing status for the page. | `publish` | `example` |
9
+ | Parameter | Type | Required | Description | Default | Examples |
10
+ | --------- | -------- | -------- | ----------------------------------------- | --------- | ----------------------------------------------------- |
11
+ | `title` | `string` | ✅ | The title for the page. | - | `My Blog Post`, `Hello World` |
12
+ | `content` | `string` | ❌ | The content for the page, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
13
+ | `status` | `string` | ❌ | The publishing status for the page. | `publish` | `example` |
14
14
 
15
15
  ## Examples
16
16
 
@@ -19,11 +19,13 @@ Creates a new page.
19
19
  Simple example of using wp_create_page
20
20
 
21
21
  **Command:**
22
+
22
23
  ```bash
23
24
  wp_create_page --title="Example Post Title"
24
25
  ```
25
26
 
26
27
  **Response:**
28
+
27
29
  ```json
28
30
  {
29
31
  "success": true,
@@ -36,6 +38,7 @@ wp_create_page --title="Example Post Title"
36
38
  ```
37
39
 
38
40
  **Error Example (Authentication failure):**
41
+
39
42
  ```json
40
43
  {
41
44
  "error": "Authentication failed",
@@ -43,17 +46,18 @@ wp_create_page --title="Example Post Title"
43
46
  }
44
47
  ```
45
48
 
46
-
47
49
  ### Advanced page Configuration
48
50
 
49
51
  Comprehensive example using all available parameters
50
52
 
51
53
  **Command:**
54
+
52
55
  ```bash
53
56
  wp_create_page --title="Example Post Title" --content="This is example content for the post." --status="publish"
54
57
  ```
55
58
 
56
59
  **Response:**
60
+
57
61
  ```json
58
62
  {
59
63
  "success": true,
@@ -65,11 +69,6 @@ wp_create_page --title="Example Post Title" --content="This is example content f
65
69
  }
66
70
  ```
67
71
 
68
-
69
-
70
-
71
-
72
-
73
72
  ## Required Permissions
74
73
 
75
74
  This tool requires the following WordPress user capabilities:
@@ -79,7 +78,6 @@ This tool requires the following WordPress user capabilities:
79
78
 
80
79
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
81
80
 
82
-
83
81
  ## Response Format
84
82
 
85
83
  **Return Type:** `page`
@@ -102,34 +100,24 @@ This tool requires the following WordPress user capabilities:
102
100
 
103
101
  ### AUTHENTICATION_FAILED
104
102
 
105
- **Message:** Authentication failed
106
- **Description:** Invalid credentials or insufficient permissions
107
- **Resolution:** Check your authentication credentials and user permissions
108
-
103
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
104
+ Check your authentication credentials and user permissions
109
105
 
110
106
  ### VALIDATION_ERROR
111
107
 
112
- **Message:** Parameter validation failed
113
- **Description:** One or more required parameters are missing or invalid
108
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
114
109
  **Resolution:** Review the required parameters and their formats
115
110
 
116
-
117
111
  ### NOT_FOUND
118
112
 
119
- **Message:** Resource not found
120
- **Description:** The requested resource does not exist
121
- **Resolution:** Verify the resource ID and ensure it exists
122
-
113
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
114
+ resource ID and ensure it exists
123
115
 
124
116
  ### PERMISSION_DENIED
125
117
 
126
- **Message:** Insufficient permissions
127
- **Description:** The user does not have permission to perform this action
118
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
128
119
  **Resolution:** Contact an administrator to grant the necessary permissions
129
120
 
130
-
131
-
132
-
133
121
  ---
134
122
 
135
- *Generated automatically from tool definitions - Do not edit manually*
123
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -4,26 +4,25 @@
4
4
 
5
5
  Creates a new WordPress post with comprehensive validation and detailed success feedback including management links.
6
6
 
7
- **Usage Examples:**
8
- • Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"`
9
- • Draft post: `wp_create_post --title="Draft Post" --status="draft"`
10
- • Categorized post: `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]`
11
- • Post with featured image: `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42`
12
- • Remove featured image: `wp_create_post --title="My Post" --featured_media=0`
13
- • Scheduled post: `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"`
14
- • Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`
7
+ **Usage Examples:** • Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"` • Draft post:
8
+ `wp_create_post --title="Draft Post" --status="draft"` • Categorized post:
9
+ `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]` • Post with featured image:
10
+ `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42` • Remove featured image:
11
+ `wp_create_post --title="My Post" --featured_media=0` • Scheduled post:
12
+ `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"` • Complete post:
13
+ `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`
15
14
 
16
15
  ## Parameters
17
16
 
18
- | Parameter | Type | Required | Description | Default | Examples |
19
- |-----------|------|----------|-------------|---------|----------|
20
- | `title` | `string` | ✅ | The title for the post. | - | `My Blog Post`, `Hello World` |
21
- | `content` | `string` | ❌ | The content for the post, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
22
- | `status` | `string` | ❌ | The publishing status for the post. | `publish` | `example` |
23
- | `excerpt` | `string` | ❌ | The excerpt for the post. | - | `example` |
24
- | `categories` | `array` | ❌ | An array of category IDs to assign to the post. | - | `example` |
25
- | `tags` | `array` | ❌ | An array of tag IDs to assign to the post. | - | `example` |
26
- | `featured_media` | `number` | ❌ | The ID of the featured media (image) for the post. Use wp_upload_media first to get a media ID. Set to 0 or null to remove the featured image. | - | `example` |
17
+ | Parameter | Type | Required | Description | Default | Examples |
18
+ | ---------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------- |
19
+ | `title` | `string` | ✅ | The title for the post. | - | `My Blog Post`, `Hello World` |
20
+ | `content` | `string` | ❌ | The content for the post, in HTML format. | - | `<p>Post content here</p>`, `This is my post content` |
21
+ | `status` | `string` | ❌ | The publishing status for the post. | `publish` | `example` |
22
+ | `excerpt` | `string` | ❌ | The excerpt for the post. | - | `example` |
23
+ | `categories` | `array` | ❌ | An array of category IDs to assign to the post. | - | `example` |
24
+ | `tags` | `array` | ❌ | An array of tag IDs to assign to the post. | - | `example` |
25
+ | `featured_media` | `number` | ❌ | The ID of the featured media (image) for the post. Use wp_upload_media first to get a media ID. Set to 0 or null to remove the featured image. | - | `example` |
27
26
 
28
27
  ## Examples
29
28
 
@@ -86,8 +85,8 @@ wp_create_post --title="Example Post Title" --content="This is example content f
86
85
 
87
86
  **Endpoint:** `/wp-json/wp/v2/posts`
88
87
 
89
- This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
90
- parameters are determined by WordPress core functionality.
88
+ This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters
89
+ are determined by WordPress core functionality.
91
90
 
92
91
  ### WordPress Documentation
93
92
 
@@ -125,28 +124,24 @@ This tool requires the following WordPress user capabilities:
125
124
 
126
125
  ### AUTHENTICATION_FAILED
127
126
 
128
- **Message:** Authentication failed
129
- **Description:** Invalid credentials or insufficient permissions
130
- **Resolution:** Check your authentication credentials and user permissions
127
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
128
+ Check your authentication credentials and user permissions
131
129
 
132
130
  ### VALIDATION_ERROR
133
131
 
134
- **Message:** Parameter validation failed
135
- **Description:** One or more required parameters are missing or invalid
132
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
136
133
  **Resolution:** Review the required parameters and their formats
137
134
 
138
135
  ### NOT_FOUND
139
136
 
140
- **Message:** Resource not found
141
- **Description:** The requested resource does not exist
142
- **Resolution:** Verify the resource ID and ensure it exists
137
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
138
+ resource ID and ensure it exists
143
139
 
144
140
  ### PERMISSION_DENIED
145
141
 
146
- **Message:** Insufficient permissions
147
- **Description:** The user does not have permission to perform this action
142
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
148
143
  **Resolution:** Contact an administrator to grant the necessary permissions
149
144
 
150
145
  ---
151
146
 
152
- *Generated automatically from tool definitions - Do not edit manually*
147
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -6,9 +6,9 @@ Creates a new tag.
6
6
 
7
7
  ## Parameters
8
8
 
9
- | Parameter | Type | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `name` | `string` | ✅ | The name of the tag. | - | `example` |
9
+ | Parameter | Type | Required | Description | Default | Examples |
10
+ | --------- | -------- | -------- | -------------------- | ------- | --------- |
11
+ | `name` | `string` | ✅ | The name of the tag. | - | `example` |
12
12
 
13
13
  ## Examples
14
14
 
@@ -17,11 +17,13 @@ Creates a new tag.
17
17
  Simple example of using wp_create_tag
18
18
 
19
19
  **Command:**
20
+
20
21
  ```bash
21
22
  wp_create_tag --name="example_value"
22
23
  ```
23
24
 
24
25
  **Response:**
26
+
25
27
  ```json
26
28
  {
27
29
  "success": true,
@@ -34,6 +36,7 @@ wp_create_tag --name="example_value"
34
36
  ```
35
37
 
36
38
  **Error Example (Authentication failure):**
39
+
37
40
  ```json
38
41
  {
39
42
  "error": "Authentication failed",
@@ -41,11 +44,6 @@ wp_create_tag --name="example_value"
41
44
  }
42
45
  ```
43
46
 
44
-
45
-
46
-
47
-
48
-
49
47
  ## Response Format
50
48
 
51
49
  **Return Type:** `taxonomy`
@@ -68,34 +66,24 @@ wp_create_tag --name="example_value"
68
66
 
69
67
  ### AUTHENTICATION_FAILED
70
68
 
71
- **Message:** Authentication failed
72
- **Description:** Invalid credentials or insufficient permissions
73
- **Resolution:** Check your authentication credentials and user permissions
74
-
69
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
70
+ Check your authentication credentials and user permissions
75
71
 
76
72
  ### VALIDATION_ERROR
77
73
 
78
- **Message:** Parameter validation failed
79
- **Description:** One or more required parameters are missing or invalid
74
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
80
75
  **Resolution:** Review the required parameters and their formats
81
76
 
82
-
83
77
  ### NOT_FOUND
84
78
 
85
- **Message:** Resource not found
86
- **Description:** The requested resource does not exist
87
- **Resolution:** Verify the resource ID and ensure it exists
88
-
79
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
80
+ resource ID and ensure it exists
89
81
 
90
82
  ### PERMISSION_DENIED
91
83
 
92
- **Message:** Insufficient permissions
93
- **Description:** The user does not have permission to perform this action
84
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
94
85
  **Resolution:** Contact an administrator to grant the necessary permissions
95
86
 
96
-
97
-
98
-
99
87
  ---
100
88
 
101
- *Generated automatically from tool definitions - Do not edit manually*
89
+ _Generated automatically from tool definitions - Do not edit manually_
@@ -6,12 +6,12 @@ Creates a new user.
6
6
 
7
7
  ## Parameters
8
8
 
9
- | Parameter | Type | Required | Description | Default | Examples |
10
- |-----------|------|----------|-------------|---------|----------|
11
- | `username` | `string` | ✅ | The username for the new user. | - | `john_doe`, `admin` |
12
- | `email` | `string` | ✅ | The email address for the new user. | - | `user@example.com`, `admin@site.com` |
13
- | `password` | `string` | ✅ | The password for the new user. | - | `example` |
14
- | `roles` | `array` | ❌ | An array of roles to assign to the user. | - | `example` |
9
+ | Parameter | Type | Required | Description | Default | Examples |
10
+ | ---------- | -------- | -------- | ---------------------------------------- | ------- | ------------------------------------ |
11
+ | `username` | `string` | ✅ | The username for the new user. | - | `john_doe`, `admin` |
12
+ | `email` | `string` | ✅ | The email address for the new user. | - | `user@example.com`, `admin@site.com` |
13
+ | `password` | `string` | ✅ | The password for the new user. | - | `example` |
14
+ | `roles` | `array` | ❌ | An array of roles to assign to the user. | - | `example` |
15
15
 
16
16
  ## Examples
17
17
 
@@ -20,11 +20,13 @@ Creates a new user.
20
20
  Simple example of using wp_create_user
21
21
 
22
22
  **Command:**
23
+
23
24
  ```bash
24
25
  wp_create_user --username="john_doe" --email="user@example.com"
25
26
  ```
26
27
 
27
28
  **Response:**
29
+
28
30
  ```json
29
31
  {
30
32
  "success": true,
@@ -37,6 +39,7 @@ wp_create_user --username="john_doe" --email="user@example.com"
37
39
  ```
38
40
 
39
41
  **Error Example (Authentication failure):**
42
+
40
43
  ```json
41
44
  {
42
45
  "error": "Authentication failed",
@@ -44,17 +47,18 @@ wp_create_user --username="john_doe" --email="user@example.com"
44
47
  }
45
48
  ```
46
49
 
47
-
48
50
  ### Advanced user Configuration
49
51
 
50
52
  Comprehensive example using all available parameters
51
53
 
52
54
  **Command:**
55
+
53
56
  ```bash
54
57
  wp_create_user --username="john_doe" --email="user@example.com" --password="example_value" --roles="example_value"
55
58
  ```
56
59
 
57
60
  **Response:**
61
+
58
62
  ```json
59
63
  {
60
64
  "success": true,
@@ -66,11 +70,6 @@ wp_create_user --username="john_doe" --email="user@example.com" --password="exam
66
70
  }
67
71
  ```
68
72
 
69
-
70
-
71
-
72
-
73
-
74
73
  ## Required Permissions
75
74
 
76
75
  This tool requires the following WordPress user capabilities:
@@ -79,7 +78,6 @@ This tool requires the following WordPress user capabilities:
79
78
 
80
79
  **Note:** The authenticated user must have these capabilities to successfully execute this tool.
81
80
 
82
-
83
81
  ## Response Format
84
82
 
85
83
  **Return Type:** `user`
@@ -102,34 +100,24 @@ This tool requires the following WordPress user capabilities:
102
100
 
103
101
  ### AUTHENTICATION_FAILED
104
102
 
105
- **Message:** Authentication failed
106
- **Description:** Invalid credentials or insufficient permissions
107
- **Resolution:** Check your authentication credentials and user permissions
108
-
103
+ **Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
104
+ Check your authentication credentials and user permissions
109
105
 
110
106
  ### VALIDATION_ERROR
111
107
 
112
- **Message:** Parameter validation failed
113
- **Description:** One or more required parameters are missing or invalid
108
+ **Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
114
109
  **Resolution:** Review the required parameters and their formats
115
110
 
116
-
117
111
  ### NOT_FOUND
118
112
 
119
- **Message:** Resource not found
120
- **Description:** The requested resource does not exist
121
- **Resolution:** Verify the resource ID and ensure it exists
122
-
113
+ **Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
114
+ resource ID and ensure it exists
123
115
 
124
116
  ### PERMISSION_DENIED
125
117
 
126
- **Message:** Insufficient permissions
127
- **Description:** The user does not have permission to perform this action
118
+ **Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
128
119
  **Resolution:** Contact an administrator to grant the necessary permissions
129
120
 
130
-
131
-
132
-
133
121
  ---
134
122
 
135
- *Generated automatically from tool definitions - Do not edit manually*
123
+ _Generated automatically from tool definitions - Do not edit manually_