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
@@ -6,27 +6,18 @@
6
6
  ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)
7
7
  ![License](https://img.shields.io/badge/license-MIT-blue)
8
8
 
9
+
9
10
  ## Overview
10
11
 
11
12
  The WordPress MCP Server provides **59 tools** across **10 categories** for comprehensive WordPress management through the Model Context Protocol.
12
13
 
13
- **Last Updated:** 3.7.2025
14
+ **Last Updated:** 14.7.2025
14
15
  **Version:** 1.2.0
15
16
  **Coverage:** 59/59 tools with examples
16
17
 
17
18
  ## Quick Start
18
19
 
19
- **First, install and configure the MCP WordPress server:**
20
-
21
- 📖 **Setup Guides:**
22
-
23
- - **[NPX Setup](../user-guides/NPX_SETUP.md)** - Zero installation method (recommended)
24
- - **[NPM Setup](../user-guides/NPM_SETUP.md)** - Local development
25
- - **[Docker Setup](../user-guides/DOCKER_SETUP.md)** - Containerized deployment
26
- - **[DTX Setup](../user-guides/DTX_SETUP.md)** - Desktop Extension package
27
-
28
20
  ### Basic Usage
29
-
30
21
  ```bash
31
22
  # List all posts
32
23
  wp_list_posts
@@ -39,7 +30,6 @@ wp_create_post --title="My Post" --content="Post content"
39
30
  ```
40
31
 
41
32
  ### Multi-Site Usage
42
-
43
33
  ```bash
44
34
  # Target specific site
45
35
  wp_list_posts --site=site1
@@ -50,96 +40,94 @@ wp_get_site_settings --site=production
50
40
 
51
41
  ## Tool Categories
52
42
 
53
- | Category | Tools | Description |
54
- | ------------------------------------------ | ----- | ------------------------------------------------ |
55
- | [comment](./categories/comment.md) | 7 | comment management tools |
56
- | [cache](./categories/cache.md) | 4 | Performance caching and optimization tools |
57
- | [site](./categories/site.md) | 6 | Site settings and configuration tools |
58
- | [taxonomy](./categories/taxonomy.md) | 10 | taxonomy management tools |
59
- | [page](./categories/page.md) | 6 | page management tools |
60
- | [post](./categories/post.md) | 6 | post management tools |
61
- | [user](./categories/user.md) | 6 | user management tools |
62
- | [media](./categories/media.md) | 5 | File upload, management, and media library tools |
63
- | [auth](./categories/auth.md) | 3 | Authentication testing and management tools |
64
- | [performance](./categories/performance.md) | 6 | Performance monitoring and analytics tools |
43
+ | Category | Tools | Description |
44
+ |----------|-------|-------------|
45
+ | [comment](./categories/comment.md) | 7 | comment management tools |
46
+ | [cache](./categories/cache.md) | 4 | Performance caching and optimization tools |
47
+ | [site](./categories/site.md) | 6 | Site settings and configuration tools |
48
+ | [taxonomy](./categories/taxonomy.md) | 10 | taxonomy management tools |
49
+ | [page](./categories/page.md) | 6 | page management tools |
50
+ | [post](./categories/post.md) | 6 | post management tools |
51
+ | [user](./categories/user.md) | 6 | user management tools |
52
+ | [media](./categories/media.md) | 5 | File upload, management, and media library tools |
53
+ | [auth](./categories/auth.md) | 3 | Authentication testing and management tools |
54
+ | [performance](./categories/performance.md) | 6 | Performance monitoring and analytics tools |
65
55
 
66
56
  ## Available Tools
67
57
 
68
- | Tool | Category | Description |
69
- | ----------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------- |
70
- | [`wp_approve_comment`](./tools/wp_approve_comment.md) | comment | Approves a pending comment. |
71
- | [`wp_cache_clear`](./tools/wp_cache_clear.md) | cache | Clear cache for a WordPress site. |
72
- | [`wp_cache_info`](./tools/wp_cache_info.md) | cache | Get detailed cache configuration and status information. |
73
- | [`wp_cache_stats`](./tools/wp_cache_stats.md) | cache | Get cache statistics for a WordPress site. |
74
- | [`wp_cache_warm`](./tools/wp_cache_warm.md) | cache | Pre-warm cache with essential WordPress data. |
75
- | [`wp_create_application_password`](./tools/wp_create_application_password.md) | site | Creates a new application password for a user. |
76
- | [`wp_create_category`](./tools/wp_create_category.md) | taxonomy | Creates a new category. |
77
- | [`wp_create_comment`](./tools/wp_create_comment.md) | comment | Creates a new comment on a post. |
78
- | [`wp_create_page`](./tools/wp_create_page.md) | page | Creates a new page. |
79
- | [`wp_create_post`](./tools/wp_create_post.md) | post | Creates a new post. |
80
- | [`wp_create_tag`](./tools/wp_create_tag.md) | taxonomy | Creates a new tag. |
81
- | [`wp_create_user`](./tools/wp_create_user.md) | user | Creates a new user. |
82
- | [`wp_delete_application_password`](./tools/wp_delete_application_password.md) | site | Revokes an existing application password. |
83
- | [`wp_delete_category`](./tools/wp_delete_category.md) | taxonomy | Deletes a category. |
84
- | [`wp_delete_comment`](./tools/wp_delete_comment.md) | comment | Deletes a comment. |
85
- | [`wp_delete_media`](./tools/wp_delete_media.md) | media | Deletes a media item. |
86
- | [`wp_delete_page`](./tools/wp_delete_page.md) | page | Deletes a page. |
87
- | [`wp_delete_post`](./tools/wp_delete_post.md) | post | Deletes a post. |
88
- | [`wp_delete_tag`](./tools/wp_delete_tag.md) | taxonomy | Deletes a tag. |
89
- | [`wp_delete_user`](./tools/wp_delete_user.md) | user | Deletes a user. |
90
- | [`wp_get_application_passwords`](./tools/wp_get_application_passwords.md) | site | Lists application passwords for a specific user. |
91
- | [`wp_get_auth_status`](./tools/wp_get_auth_status.md) | auth | Gets the current authentication status for a configured WordPress site. |
92
- | [`wp_get_category`](./tools/wp_get_category.md) | taxonomy | Retrieves a single category by its ID. |
93
- | [`wp_get_comment`](./tools/wp_get_comment.md) | comment | Retrieves a single comment by its ID. |
94
- | [`wp_get_current_user`](./tools/wp_get_current_user.md) | user | Retrieves the currently authenticated user. |
95
- | [`wp_get_media`](./tools/wp_get_media.md) | media | Retrieves a single media item by its ID. |
96
- | [`wp_get_page`](./tools/wp_get_page.md) | page | Retrieves a single page by its ID. |
97
- | [`wp_get_page_revisions`](./tools/wp_get_page_revisions.md) | page | Retrieves revisions for a specific page. |
98
- | [`wp_get_post`](./tools/wp_get_post.md) | post | Retrieves a single post by its ID. |
99
- | [`wp_get_post_revisions`](./tools/wp_get_post_revisions.md) | post | Retrieves revisions for a specific post. |
100
- | [`wp_get_site_settings`](./tools/wp_get_site_settings.md) | site | Retrieves the general settings for a WordPress site. |
101
- | [`wp_get_tag`](./tools/wp_get_tag.md) | taxonomy | Retrieves a single tag by its ID. |
102
- | [`wp_get_user`](./tools/wp_get_user.md) | user | Retrieves a single user by their ID. |
103
- | [`wp_list_categories`](./tools/wp_list_categories.md) | taxonomy | Lists categories from a WordPress site. |
104
- | [`wp_list_comments`](./tools/wp_list_comments.md) | comment | Lists comments from a WordPress site, with filters. |
105
- | [`wp_list_media`](./tools/wp_list_media.md) | media | Lists media items from a WordPress site, with filters. |
106
- | [`wp_list_pages`](./tools/wp_list_pages.md) | page | Lists pages from a WordPress site, with filters. |
107
- | [`wp_list_posts`](./tools/wp_list_posts.md) | post | Lists posts from a WordPress site, with filters. |
108
- | [`wp_list_tags`](./tools/wp_list_tags.md) | taxonomy | Lists tags from a WordPress site. |
109
- | [`wp_list_users`](./tools/wp_list_users.md) | user | Lists users from a WordPress site, with filters. |
110
- | [`wp_performance_alerts`](./tools/wp_performance_alerts.md) | performance | Get performance alerts and anomaly detection results |
111
- | [`wp_performance_benchmark`](./tools/wp_performance_benchmark.md) | performance | Compare current performance against industry benchmarks |
112
- | [`wp_performance_export`](./tools/wp_performance_export.md) | performance | Export comprehensive performance report |
113
- | [`wp_performance_history`](./tools/wp_performance_history.md) | performance | Get historical performance data and trends |
114
- | [`wp_performance_optimize`](./tools/wp_performance_optimize.md) | performance | Get optimization recommendations and insights |
115
- | [`wp_performance_stats`](./tools/wp_performance_stats.md) | performance | Get real-time performance statistics and metrics |
116
- | [`wp_search_site`](./tools/wp_search_site.md) | site | Performs a site-wide search for content. |
117
- | [`wp_spam_comment`](./tools/wp_spam_comment.md) | comment | Marks a comment as spam. |
118
- | [`wp_switch_auth_method`](./tools/wp_switch_auth_method.md) | auth | Switches the authentication method for a site for the current session. |
119
- | [`wp_test_auth`](./tools/wp_test_auth.md) | auth | Tests the authentication and connectivity for a configured WordPress site. |
120
- | [`wp_update_category`](./tools/wp_update_category.md) | taxonomy | Updates an existing category. |
121
- | [`wp_update_comment`](./tools/wp_update_comment.md) | comment | Updates an existing comment. |
122
- | [`wp_update_media`](./tools/wp_update_media.md) | media | Updates the metadata of an existing media item. |
123
- | [`wp_update_page`](./tools/wp_update_page.md) | page | Updates an existing page. |
124
- | [`wp_update_post`](./tools/wp_update_post.md) | post | Updates an existing post. |
125
- | [`wp_update_site_settings`](./tools/wp_update_site_settings.md) | site | Updates one or more general settings for a WordPress site. |
126
- | [`wp_update_tag`](./tools/wp_update_tag.md) | taxonomy | Updates an existing tag. |
127
- | [`wp_update_user`](./tools/wp_update_user.md) | user | Updates an existing user. |
128
- | [`wp_upload_media`](./tools/wp_upload_media.md) | media | Uploads a file to the WordPress media library. |
58
+ | Tool | Category | Description |
59
+ |------|----------|-------------|
60
+ | [`wp_approve_comment`](./tools/wp_approve_comment.md) | comment | Approves a pending comment. |
61
+ | [`wp_cache_clear`](./tools/wp_cache_clear.md) | cache | Clear cache for a WordPress site. |
62
+ | [`wp_cache_info`](./tools/wp_cache_info.md) | cache | Get detailed cache configuration and status information. |
63
+ | [`wp_cache_stats`](./tools/wp_cache_stats.md) | cache | Get cache statistics for a WordPress site. |
64
+ | [`wp_cache_warm`](./tools/wp_cache_warm.md) | cache | Pre-warm cache with essential WordPress data. |
65
+ | [`wp_create_application_password`](./tools/wp_create_application_password.md) | site | Creates a new application password for a user. |
66
+ | [`wp_create_category`](./tools/wp_create_category.md) | taxonomy | Creates a new category. |
67
+ | [`wp_create_comment`](./tools/wp_create_comment.md) | comment | Creates a new comment on a post. |
68
+ | [`wp_create_page`](./tools/wp_create_page.md) | page | Creates a new page. |
69
+ | [`wp_create_post`](./tools/wp_create_post.md) | post | Creates a new post. |
70
+ | [`wp_create_tag`](./tools/wp_create_tag.md) | taxonomy | Creates a new tag. |
71
+ | [`wp_create_user`](./tools/wp_create_user.md) | user | Creates a new user. |
72
+ | [`wp_delete_application_password`](./tools/wp_delete_application_password.md) | site | Revokes an existing application password. |
73
+ | [`wp_delete_category`](./tools/wp_delete_category.md) | taxonomy | Deletes a category. |
74
+ | [`wp_delete_comment`](./tools/wp_delete_comment.md) | comment | Deletes a comment. |
75
+ | [`wp_delete_media`](./tools/wp_delete_media.md) | media | Deletes a media item. |
76
+ | [`wp_delete_page`](./tools/wp_delete_page.md) | page | Deletes a page. |
77
+ | [`wp_delete_post`](./tools/wp_delete_post.md) | post | Deletes a post. |
78
+ | [`wp_delete_tag`](./tools/wp_delete_tag.md) | taxonomy | Deletes a tag. |
79
+ | [`wp_delete_user`](./tools/wp_delete_user.md) | user | Deletes a user. |
80
+ | [`wp_get_application_passwords`](./tools/wp_get_application_passwords.md) | site | Lists application passwords for a specific user. |
81
+ | [`wp_get_auth_status`](./tools/wp_get_auth_status.md) | auth | Gets the current authentication status for a configured WordPress site. |
82
+ | [`wp_get_category`](./tools/wp_get_category.md) | taxonomy | Retrieves a single category by its ID. |
83
+ | [`wp_get_comment`](./tools/wp_get_comment.md) | comment | Retrieves a single comment by its ID. |
84
+ | [`wp_get_current_user`](./tools/wp_get_current_user.md) | user | Retrieves the currently authenticated user. |
85
+ | [`wp_get_media`](./tools/wp_get_media.md) | media | Retrieves a single media item by its ID. |
86
+ | [`wp_get_page`](./tools/wp_get_page.md) | page | Retrieves a single page by its ID. |
87
+ | [`wp_get_page_revisions`](./tools/wp_get_page_revisions.md) | page | Retrieves revisions for a specific page. |
88
+ | [`wp_get_post`](./tools/wp_get_post.md) | post | Retrieves a single post by its ID. |
89
+ | [`wp_get_post_revisions`](./tools/wp_get_post_revisions.md) | post | Retrieves revisions for a specific post. |
90
+ | [`wp_get_site_settings`](./tools/wp_get_site_settings.md) | site | Retrieves the general settings for a WordPress site. |
91
+ | [`wp_get_tag`](./tools/wp_get_tag.md) | taxonomy | Retrieves a single tag by its ID. |
92
+ | [`wp_get_user`](./tools/wp_get_user.md) | user | Retrieves a single user by their ID. |
93
+ | [`wp_list_categories`](./tools/wp_list_categories.md) | taxonomy | Lists categories from a WordPress site. |
94
+ | [`wp_list_comments`](./tools/wp_list_comments.md) | comment | Lists comments from a WordPress site, with filters. |
95
+ | [`wp_list_media`](./tools/wp_list_media.md) | media | Lists media items from a WordPress site, with filters. |
96
+ | [`wp_list_pages`](./tools/wp_list_pages.md) | page | Lists pages from a WordPress site, with filters. |
97
+ | [`wp_list_posts`](./tools/wp_list_posts.md) | post | Lists posts from a WordPress site, with filters. |
98
+ | [`wp_list_tags`](./tools/wp_list_tags.md) | taxonomy | Lists tags from a WordPress site. |
99
+ | [`wp_list_users`](./tools/wp_list_users.md) | user | Lists users from a WordPress site, with filters. |
100
+ | [`wp_performance_alerts`](./tools/wp_performance_alerts.md) | performance | Get performance alerts and anomaly detection results |
101
+ | [`wp_performance_benchmark`](./tools/wp_performance_benchmark.md) | performance | Compare current performance against industry benchmarks |
102
+ | [`wp_performance_export`](./tools/wp_performance_export.md) | performance | Export comprehensive performance report |
103
+ | [`wp_performance_history`](./tools/wp_performance_history.md) | performance | Get historical performance data and trends |
104
+ | [`wp_performance_optimize`](./tools/wp_performance_optimize.md) | performance | Get optimization recommendations and insights |
105
+ | [`wp_performance_stats`](./tools/wp_performance_stats.md) | performance | Get real-time performance statistics and metrics |
106
+ | [`wp_search_site`](./tools/wp_search_site.md) | site | Performs a site-wide search for content. |
107
+ | [`wp_spam_comment`](./tools/wp_spam_comment.md) | comment | Marks a comment as spam. |
108
+ | [`wp_switch_auth_method`](./tools/wp_switch_auth_method.md) | auth | Switches the authentication method for a site for the current session. |
109
+ | [`wp_test_auth`](./tools/wp_test_auth.md) | auth | Tests the authentication and connectivity for a configured WordPress site. |
110
+ | [`wp_update_category`](./tools/wp_update_category.md) | taxonomy | Updates an existing category. |
111
+ | [`wp_update_comment`](./tools/wp_update_comment.md) | comment | Updates an existing comment. |
112
+ | [`wp_update_media`](./tools/wp_update_media.md) | media | Updates the metadata of an existing media item. |
113
+ | [`wp_update_page`](./tools/wp_update_page.md) | page | Updates an existing page. |
114
+ | [`wp_update_post`](./tools/wp_update_post.md) | post | Updates an existing post. |
115
+ | [`wp_update_site_settings`](./tools/wp_update_site_settings.md) | site | Updates one or more general settings for a WordPress site. |
116
+ | [`wp_update_tag`](./tools/wp_update_tag.md) | taxonomy | Updates an existing tag. |
117
+ | [`wp_update_user`](./tools/wp_update_user.md) | user | Updates an existing user. |
118
+ | [`wp_upload_media`](./tools/wp_upload_media.md) | media | Uploads a file to the WordPress media library. |
129
119
 
130
120
  ## Authentication
131
121
 
132
122
  All tools support multiple authentication methods:
133
-
134
123
  - **Application Passwords** (recommended)
135
- - **JWT Authentication**
124
+ - **JWT Authentication**
136
125
  - **Basic Authentication** (development only)
137
126
  - **API Key Authentication**
138
127
 
139
128
  ## Error Handling
140
129
 
141
130
  Standard error response format:
142
-
143
131
  ```json
144
132
  {
145
133
  "error": "Error type",
@@ -155,7 +143,6 @@ Standard error response format:
155
143
  ## Configuration
156
144
 
157
145
  ### Multi-Site Configuration
158
-
159
146
  ```json
160
147
  {
161
148
  "sites": [
@@ -175,7 +162,6 @@ Standard error response format:
175
162
  ## Response Formats
176
163
 
177
164
  All tools return responses in this format:
178
-
179
165
  ```json
180
166
  {
181
167
  "success": true,
@@ -193,7 +179,6 @@ All tools return responses in this format:
193
179
  ## Performance Monitoring
194
180
 
195
181
  The server includes comprehensive performance monitoring:
196
-
197
182
  - Real-time metrics collection
198
183
  - Historical performance analysis
199
184
  - Industry benchmark comparisons
@@ -19,7 +19,6 @@ Authentication testing and management tools
19
19
  ## Examples
20
20
 
21
21
  ### Basic auth Workflow
22
-
23
22
  ```bash
24
23
  # List all auth
25
24
  wp_list_auth
@@ -32,7 +31,6 @@ wp_create_aut --title="Example"
32
31
  ```
33
32
 
34
33
  ### Multi-Site auth Management
35
-
36
34
  ```bash
37
35
  # Work with specific site
38
36
  wp_list_auth --site=production
@@ -20,7 +20,6 @@ Performance caching and optimization tools
20
20
  ## Examples
21
21
 
22
22
  ### Basic cache Workflow
23
-
24
23
  ```bash
25
24
  # List all cache
26
25
  wp_list_cache
@@ -33,7 +32,6 @@ wp_create_cach --title="Example"
33
32
  ```
34
33
 
35
34
  ### Multi-Site cache Management
36
-
37
35
  ```bash
38
36
  # Work with specific site
39
37
  wp_list_cache --site=production
@@ -23,7 +23,6 @@ comment management tools
23
23
  ## Examples
24
24
 
25
25
  ### Basic comment Workflow
26
-
27
26
  ```bash
28
27
  # List all comment
29
28
  wp_list_comment
@@ -36,7 +35,6 @@ wp_create_commen --title="Example"
36
35
  ```
37
36
 
38
37
  ### Multi-Site comment Management
39
-
40
38
  ```bash
41
39
  # Work with specific site
42
40
  wp_list_comment --site=production
@@ -22,7 +22,6 @@ File upload, management, and media library tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic media Workflow
25
-
26
25
  ```bash
27
26
  # List all media
28
27
  wp_list_media
@@ -35,7 +34,6 @@ wp_create_medi --title="Example"
35
34
  ```
36
35
 
37
36
  ### Multi-Site media Management
38
-
39
37
  ```bash
40
38
  # Work with specific site
41
39
  wp_list_media --site=production
@@ -22,7 +22,6 @@ page management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic page Workflow
25
-
26
25
  ```bash
27
26
  # List all page
28
27
  wp_list_page
@@ -35,7 +34,6 @@ wp_create_pag --title="Example"
35
34
  ```
36
35
 
37
36
  ### Multi-Site page Management
38
-
39
37
  ```bash
40
38
  # Work with specific site
41
39
  wp_list_page --site=production
@@ -23,7 +23,6 @@ Performance monitoring and analytics tools
23
23
  ## Examples
24
24
 
25
25
  ### Basic performance Workflow
26
-
27
26
  ```bash
28
27
  # List all performance
29
28
  wp_list_performance
@@ -36,7 +35,6 @@ wp_create_performanc --title="Example"
36
35
  ```
37
36
 
38
37
  ### Multi-Site performance Management
39
-
40
38
  ```bash
41
39
  # Work with specific site
42
40
  wp_list_performance --site=production
@@ -22,7 +22,6 @@ post management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic post Workflow
25
-
26
25
  ```bash
27
26
  # List all post
28
27
  wp_list_post
@@ -35,7 +34,6 @@ wp_create_pos --title="Example"
35
34
  ```
36
35
 
37
36
  ### Multi-Site post Management
38
-
39
37
  ```bash
40
38
  # Work with specific site
41
39
  wp_list_post --site=production
@@ -22,7 +22,6 @@ Site settings and configuration tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic site Workflow
25
-
26
25
  ```bash
27
26
  # List all site
28
27
  wp_list_site
@@ -35,7 +34,6 @@ wp_create_sit --title="Example"
35
34
  ```
36
35
 
37
36
  ### Multi-Site site Management
38
-
39
37
  ```bash
40
38
  # Work with specific site
41
39
  wp_list_site --site=production
@@ -26,7 +26,6 @@ taxonomy management tools
26
26
  ## Examples
27
27
 
28
28
  ### Basic taxonomy Workflow
29
-
30
29
  ```bash
31
30
  # List all taxonomy
32
31
  wp_list_taxonomy
@@ -39,7 +38,6 @@ wp_create_taxonom --title="Example"
39
38
  ```
40
39
 
41
40
  ### Multi-Site taxonomy Management
42
-
43
41
  ```bash
44
42
  # Work with specific site
45
43
  wp_list_taxonomy --site=production
@@ -22,7 +22,6 @@ user management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic user Workflow
25
-
26
25
  ```bash
27
26
  # List all user
28
27
  wp_list_user
@@ -35,7 +34,6 @@ wp_create_use --title="Example"
35
34
  ```
36
35
 
37
36
  ### Multi-Site user Management
38
-
39
37
  ```bash
40
38
  # Work with specific site
41
39
  wp_list_user --site=production
@@ -2,7 +2,7 @@
2
2
  "totalTools": 59,
3
3
  "totalCategories": 10,
4
4
  "totalTypes": 1,
5
- "lastUpdated": "2025-07-03T17:22:44.406Z",
5
+ "lastUpdated": "2025-07-14T17:43:04.283Z",
6
6
  "version": "1.2.0",
7
7
  "coverage": {
8
8
  "toolsWithExamples": 59,
@@ -17,13 +17,11 @@ Approves a pending comment.
17
17
  Simple example of using wp_approve_comment
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_approve_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_approve_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_approve_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_approve_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*
@@ -18,13 +18,11 @@ Clear cache for a WordPress site.
18
18
  Simple example of using wp_cache_clear
19
19
 
20
20
  **Command:**
21
-
22
21
  ```bash
23
22
  wp_cache_clear
24
23
  ```
25
24
 
26
25
  **Response:**
27
-
28
26
  ```json
29
27
  {
30
28
  "success": true,
@@ -34,7 +32,6 @@ wp_cache_clear
34
32
  ```
35
33
 
36
34
  **Error Example (Authentication failure):**
37
-
38
35
  ```json
39
36
  {
40
37
  "error": "Authentication failed",
@@ -42,18 +39,17 @@ wp_cache_clear
42
39
  }
43
40
  ```
44
41
 
42
+
45
43
  ### Multi-Site cache Usage
46
44
 
47
45
  Using wp_cache_clear with specific site targeting
48
46
 
49
47
  **Command:**
50
-
51
48
  ```bash
52
49
  wp_cache_clear --site="site1"
53
50
  ```
54
51
 
55
52
  **Response:**
56
-
57
53
  ```json
58
54
  {
59
55
  "success": true,
@@ -62,6 +58,13 @@ wp_cache_clear --site="site1"
62
58
  }
63
59
  ```
64
60
 
61
+
62
+
63
+
64
+
65
+
66
+
67
+
65
68
  ## Response Format
66
69
 
67
70
  **Return Type:** `CacheStats`
@@ -88,24 +91,30 @@ wp_cache_clear --site="site1"
88
91
  **Description:** Invalid credentials or insufficient permissions
89
92
  **Resolution:** Check your authentication credentials and user permissions
90
93
 
94
+
91
95
  ### VALIDATION_ERROR
92
96
 
93
97
  **Message:** Parameter validation failed
94
98
  **Description:** One or more required parameters are missing or invalid
95
99
  **Resolution:** Review the required parameters and their formats
96
100
 
101
+
97
102
  ### NOT_FOUND
98
103
 
99
104
  **Message:** Resource not found
100
105
  **Description:** The requested resource does not exist
101
106
  **Resolution:** Verify the resource ID and ensure it exists
102
107
 
108
+
103
109
  ### PERMISSION_DENIED
104
110
 
105
111
  **Message:** Insufficient permissions
106
112
  **Description:** The user does not have permission to perform this action
107
113
  **Resolution:** Contact an administrator to grant the necessary permissions
108
114
 
115
+
116
+
117
+
109
118
  ---
110
119
 
111
120
  *Generated automatically from tool definitions - Do not edit manually*
@@ -17,13 +17,11 @@ Get detailed cache configuration and status information.
17
17
  Simple example of using wp_cache_info
18
18
 
19
19
  **Command:**
20
-
21
20
  ```bash
22
21
  wp_cache_info
23
22
  ```
24
23
 
25
24
  **Response:**
26
-
27
25
  ```json
28
26
  {
29
27
  "success": true,
@@ -33,7 +31,6 @@ wp_cache_info
33
31
  ```
34
32
 
35
33
  **Error Example (Authentication failure):**
36
-
37
34
  ```json
38
35
  {
39
36
  "error": "Authentication failed",
@@ -41,18 +38,17 @@ wp_cache_info
41
38
  }
42
39
  ```
43
40
 
41
+
44
42
  ### Multi-Site cache Usage
45
43
 
46
44
  Using wp_cache_info with specific site targeting
47
45
 
48
46
  **Command:**
49
-
50
47
  ```bash
51
48
  wp_cache_info --site="site1"
52
49
  ```
53
50
 
54
51
  **Response:**
55
-
56
52
  ```json
57
53
  {
58
54
  "success": true,
@@ -61,6 +57,13 @@ wp_cache_info --site="site1"
61
57
  }
62
58
  ```
63
59
 
60
+
61
+
62
+
63
+
64
+
65
+
66
+
64
67
  ## Response Format
65
68
 
66
69
  **Return Type:** `CacheStats`
@@ -87,24 +90,30 @@ wp_cache_info --site="site1"
87
90
  **Description:** Invalid credentials or insufficient permissions
88
91
  **Resolution:** Check your authentication credentials and user permissions
89
92
 
93
+
90
94
  ### VALIDATION_ERROR
91
95
 
92
96
  **Message:** Parameter validation failed
93
97
  **Description:** One or more required parameters are missing or invalid
94
98
  **Resolution:** Review the required parameters and their formats
95
99
 
100
+
96
101
  ### NOT_FOUND
97
102
 
98
103
  **Message:** Resource not found
99
104
  **Description:** The requested resource does not exist
100
105
  **Resolution:** Verify the resource ID and ensure it exists
101
106
 
107
+
102
108
  ### PERMISSION_DENIED
103
109
 
104
110
  **Message:** Insufficient permissions
105
111
  **Description:** The user does not have permission to perform this action
106
112
  **Resolution:** Contact an administrator to grant the necessary permissions
107
113
 
114
+
115
+
116
+
108
117
  ---
109
118
 
110
119
  *Generated automatically from tool definitions - Do not edit manually*