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
@@ -1,23 +1,21 @@
1
1
  # WordPress MCP Server - API Documentation
2
2
 
3
- ![Version](https://img.shields.io/badge/version-1.2.0-blue)
4
- ![Tools](https://img.shields.io/badge/tools-60+-green)
3
+ ![Version](https://img.shields.io/badge/version-1.2.0-blue) ![Tools](https://img.shields.io/badge/tools-60+-green)
5
4
  ![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)
6
5
  ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)
7
6
  ![License](https://img.shields.io/badge/license-MIT-blue)
8
7
 
9
-
10
8
  ## Overview
11
9
 
12
- The WordPress MCP Server provides **59 tools** across **10 categories** for comprehensive WordPress management through the Model Context Protocol.
10
+ The WordPress MCP Server provides **59 tools** across **10 categories** for comprehensive WordPress management through
11
+ the Model Context Protocol.
13
12
 
14
- **Last Updated:** 9.8.2025
15
- **Version:** 1.2.0
16
- **Coverage:** 59/59 tools with examples
13
+ **Last Updated:** 9.8.2025 **Version:** 1.2.0 **Coverage:** 59/59 tools with examples
17
14
 
18
15
  ## Quick Start
19
16
 
20
17
  ### Basic Usage
18
+
21
19
  ```bash
22
20
  # List all posts
23
21
  wp_list_posts
@@ -30,6 +28,7 @@ wp_create_post --title="My Post" --content="Post content"
30
28
  ```
31
29
 
32
30
  ### Multi-Site Usage
31
+
33
32
  ```bash
34
33
  # Target specific site
35
34
  wp_list_posts --site=site1
@@ -40,138 +39,129 @@ wp_get_site_settings --site=production
40
39
 
41
40
  ## Tool Categories
42
41
 
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 |
42
+ | Category | Tools | Description |
43
+ | ------------------------------------------ | ----- | ------------------------------------------------ |
44
+ | [comment](./categories/comment.md) | 7 | comment management tools |
45
+ | [cache](./categories/cache.md) | 4 | Performance caching and optimization tools |
46
+ | [site](./categories/site.md) | 6 | Site settings and configuration tools |
47
+ | [taxonomy](./categories/taxonomy.md) | 10 | taxonomy management tools |
48
+ | [page](./categories/page.md) | 6 | page management tools |
49
+ | [post](./categories/post.md) | 6 | post management tools |
50
+ | [user](./categories/user.md) | 6 | user management tools |
51
+ | [media](./categories/media.md) | 5 | File upload, management, and media library tools |
52
+ | [auth](./categories/auth.md) | 3 | Authentication testing and management tools |
53
+ | [performance](./categories/performance.md) | 6 | Performance monitoring and analytics tools |
55
54
 
56
55
  ## Available Tools
57
56
 
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 WordPress post with comprehensive validation and detailed success feedback including management links.
70
-
71
- **Usage Examples:**
72
- • Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"`
73
- • Draft post: `wp_create_post --title="Draft Post" --status="draft"`
74
- • Categorized post: `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]`
75
- • Post with featured image: `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42`
76
- • Remove featured image: `wp_create_post --title="My Post" --featured_media=0`
77
- • Scheduled post: `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"`
78
- Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"` |
79
- | [`wp_create_tag`](./tools/wp_create_tag.md) | taxonomy | Creates a new tag. |
80
- | [`wp_create_user`](./tools/wp_create_user.md) | user | Creates a new user. |
81
- | [`wp_delete_application_password`](./tools/wp_delete_application_password.md) | site | Revokes an existing application password. |
82
- | [`wp_delete_category`](./tools/wp_delete_category.md) | taxonomy | Deletes a category. |
83
- | [`wp_delete_comment`](./tools/wp_delete_comment.md) | comment | Deletes a comment. |
84
- | [`wp_delete_media`](./tools/wp_delete_media.md) | media | Deletes a media item. |
85
- | [`wp_delete_page`](./tools/wp_delete_page.md) | page | Deletes a page. |
86
- | [`wp_delete_post`](./tools/wp_delete_post.md) | post | Deletes a WordPress post with option for permanent deletion or moving to trash. |
87
- | [`wp_delete_tag`](./tools/wp_delete_tag.md) | taxonomy | Deletes a tag. |
88
- | [`wp_delete_user`](./tools/wp_delete_user.md) | user | Deletes a user. |
89
- | [`wp_get_application_passwords`](./tools/wp_get_application_passwords.md) | site | Lists application passwords for a specific user. |
90
- | [`wp_get_auth_status`](./tools/wp_get_auth_status.md) | auth | Gets the current authentication status for a configured WordPress site. |
91
- | [`wp_get_category`](./tools/wp_get_category.md) | taxonomy | Retrieves a single category by its ID. |
92
- | [`wp_get_comment`](./tools/wp_get_comment.md) | comment | Retrieves a single comment by its ID. |
93
- | [`wp_get_current_user`](./tools/wp_get_current_user.md) | user | Retrieves the currently authenticated user with comprehensive profile information including roles, capabilities, and account details.
94
-
95
- **Usage Examples:**
96
- Get current user: `wp_get_current_user`
97
- Check permissions: Use this to verify your current user's capabilities and roles
98
- Account verification: Confirm you're authenticated with the correct account
99
- Profile details: View registration date, email, and user metadata |
100
- | [`wp_get_media`](./tools/wp_get_media.md) | media | Retrieves a single media item by its ID. |
101
- | [`wp_get_page`](./tools/wp_get_page.md) | page | Retrieves a single page by its ID. |
102
- | [`wp_get_page_revisions`](./tools/wp_get_page_revisions.md) | page | Retrieves revisions for a specific page. |
103
- | [`wp_get_post`](./tools/wp_get_post.md) | post | Retrieves detailed information about a single post including metadata, content statistics, and management links. |
104
- | [`wp_get_post_revisions`](./tools/wp_get_post_revisions.md) | post | Retrieves the revision history for a specific post showing author and modification dates. |
105
- | [`wp_get_site_settings`](./tools/wp_get_site_settings.md) | site | Retrieves the general settings for a WordPress site. |
106
- | [`wp_get_tag`](./tools/wp_get_tag.md) | taxonomy | Retrieves a single tag by its ID. |
107
- | [`wp_get_user`](./tools/wp_get_user.md) | user | Retrieves a single user by their ID. |
108
- | [`wp_list_categories`](./tools/wp_list_categories.md) | taxonomy | Lists categories from a WordPress site. |
109
- | [`wp_list_comments`](./tools/wp_list_comments.md) | comment | Lists comments from a WordPress site, with filters. |
110
- | [`wp_list_media`](./tools/wp_list_media.md) | media | Lists media items from a WordPress site, with filters. |
111
- | [`wp_list_pages`](./tools/wp_list_pages.md) | page | Lists pages from a WordPress site, with filters. |
112
- | [`wp_list_posts`](./tools/wp_list_posts.md) | post | Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and category/tag filtering with enhanced metadata display.
113
-
114
- **Usage Examples:**
115
- Basic listing: `wp_list_posts`
116
- • Search posts: `wp_list_posts --search="AI trends"`
117
- Filter by status: `wp_list_posts --status="draft"`
118
- Category filtering: `wp_list_posts --categories=[1,2,3]`
119
- Paginated results: `wp_list_posts --per_page=20 --page=2`
120
- • Combined filters: `wp_list_posts --search="WordPress" --status="publish" --per_page=10` |
121
- | [`wp_list_tags`](./tools/wp_list_tags.md) | taxonomy | Lists tags from a WordPress site. |
122
- | [`wp_list_users`](./tools/wp_list_users.md) | user | Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status.
123
-
124
- **Usage Examples:**
125
- List all users: `wp_list_users`
126
- Search users: `wp_list_users --search="john"`
127
- Filter by role: `wp_list_users --roles=["editor","author"]`
128
- Find admins: `wp_list_users --roles=["administrator"]`
129
- Combined search: `wp_list_users --search="smith" --roles=["subscriber"]` |
130
- | [`wp_performance_alerts`](./tools/wp_performance_alerts.md) | performance | Get performance alerts and anomaly detection results |
131
- | [`wp_performance_benchmark`](./tools/wp_performance_benchmark.md) | performance | Compare current performance against industry benchmarks |
132
- | [`wp_performance_export`](./tools/wp_performance_export.md) | performance | Export comprehensive performance report |
133
- | [`wp_performance_history`](./tools/wp_performance_history.md) | performance | Get historical performance data and trends |
134
- | [`wp_performance_optimize`](./tools/wp_performance_optimize.md) | performance | Get optimization recommendations and insights |
135
- | [`wp_performance_stats`](./tools/wp_performance_stats.md) | performance | Get real-time performance statistics and metrics |
136
- | [`wp_search_site`](./tools/wp_search_site.md) | site | Performs a site-wide search for content across posts, pages, and media with comprehensive results and metadata.
137
-
138
- **Usage Examples:**
139
- Search everything: `wp_search_site --term="WordPress"`
140
- • Search posts only: `wp_search_site --term="tutorial" --type="posts"`
141
- Search pages: `wp_search_site --term="about" --type="pages"`
142
- Search media: `wp_search_site --term="logo" --type="media"`
143
- Find specific content: `wp_search_site --term="contact form"` |
144
- | [`wp_spam_comment`](./tools/wp_spam_comment.md) | comment | Marks a comment as spam. |
145
- | [`wp_switch_auth_method`](./tools/wp_switch_auth_method.md) | auth | Switches the authentication method for a site for the current session. |
146
- | [`wp_test_auth`](./tools/wp_test_auth.md) | auth | Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.
147
-
148
- **Usage Examples:**
149
- Test connection: `wp_test_auth`
150
- Multi-site test: `wp_test_auth --site="my-site"`
151
- Verify setup: Use this after configuring new credentials
152
- • Troubleshoot: Run when experiencing connection issues
153
- • Health check: Regular verification of WordPress connectivity |
154
- | [`wp_update_category`](./tools/wp_update_category.md) | taxonomy | Updates an existing category. |
155
- | [`wp_update_comment`](./tools/wp_update_comment.md) | comment | Updates an existing comment. |
156
- | [`wp_update_media`](./tools/wp_update_media.md) | media | Updates the metadata of an existing media item. |
157
- | [`wp_update_page`](./tools/wp_update_page.md) | page | Updates an existing page. |
158
- | [`wp_update_post`](./tools/wp_update_post.md) | post | Updates an existing WordPress post with validation and detailed confirmation. |
159
- | [`wp_update_site_settings`](./tools/wp_update_site_settings.md) | site | Updates one or more general settings for a WordPress site. |
160
- | [`wp_update_tag`](./tools/wp_update_tag.md) | taxonomy | Updates an existing tag. |
161
- | [`wp_update_user`](./tools/wp_update_user.md) | user | Updates an existing user. |
162
- | [`wp_upload_media`](./tools/wp_upload_media.md) | media | Uploads a file to the WordPress media library. |
57
+ | Tool | Category | Description |
58
+ | ----------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
59
+ | [`wp_approve_comment`](./tools/wp_approve_comment.md) | comment | Approves a pending comment. |
60
+ | [`wp_cache_clear`](./tools/wp_cache_clear.md) | cache | Clear cache for a WordPress site. |
61
+ | [`wp_cache_info`](./tools/wp_cache_info.md) | cache | Get detailed cache configuration and status information. |
62
+ | [`wp_cache_stats`](./tools/wp_cache_stats.md) | cache | Get cache statistics for a WordPress site. |
63
+ | [`wp_cache_warm`](./tools/wp_cache_warm.md) | cache | Pre-warm cache with essential WordPress data. |
64
+ | [`wp_create_application_password`](./tools/wp_create_application_password.md) | site | Creates a new application password for a user. |
65
+ | [`wp_create_category`](./tools/wp_create_category.md) | taxonomy | Creates a new category. |
66
+ | [`wp_create_comment`](./tools/wp_create_comment.md) | comment | Creates a new comment on a post. |
67
+ | [`wp_create_page`](./tools/wp_create_page.md) | page | Creates a new page. |
68
+ | [`wp_create_post`](./tools/wp_create_post.md) | post | Creates a new WordPress post with comprehensive validation and detailed success feedback including management links. |
69
+
70
+ **Usage Examples:** • Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"` • Draft post:
71
+ `wp_create_post --title="Draft Post" --status="draft"` • Categorized post:
72
+ `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]` • Post with featured image:
73
+ `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42` • Remove featured image:
74
+ `wp_create_post --title="My Post" --featured_media=0` • Scheduled post:
75
+ `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"` • Complete post:
76
+ `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"` | |
77
+ [`wp_create_tag`](./tools/wp_create_tag.md) | taxonomy | Creates a new tag. | |
78
+ [`wp_create_user`](./tools/wp_create_user.md) | user | Creates a new user. | |
79
+ [`wp_delete_application_password`](./tools/wp_delete_application_password.md) | site | Revokes an existing application
80
+ password. | | [`wp_delete_category`](./tools/wp_delete_category.md) | taxonomy | Deletes a category. | |
81
+ [`wp_delete_comment`](./tools/wp_delete_comment.md) | comment | Deletes a comment. | |
82
+ [`wp_delete_media`](./tools/wp_delete_media.md) | media | Deletes a media item. | |
83
+ [`wp_delete_page`](./tools/wp_delete_page.md) | page | Deletes a page. | | [`wp_delete_post`](./tools/wp_delete_post.md)
84
+ | post | Deletes a WordPress post with option for permanent deletion or moving to trash. | |
85
+ [`wp_delete_tag`](./tools/wp_delete_tag.md) | taxonomy | Deletes a tag. | |
86
+ [`wp_delete_user`](./tools/wp_delete_user.md) | user | Deletes a user. | |
87
+ [`wp_get_application_passwords`](./tools/wp_get_application_passwords.md) | site | Lists application passwords for a
88
+ specific user. | | [`wp_get_auth_status`](./tools/wp_get_auth_status.md) | auth | Gets the current authentication status
89
+ for a configured WordPress site. | | [`wp_get_category`](./tools/wp_get_category.md) | taxonomy | Retrieves a single
90
+ category by its ID. | | [`wp_get_comment`](./tools/wp_get_comment.md) | comment | Retrieves a single comment by its ID.
91
+ | | [`wp_get_current_user`](./tools/wp_get_current_user.md) | user | Retrieves the currently authenticated user with
92
+ comprehensive profile information including roles, capabilities, and account details.
93
+
94
+ **Usage Examples:** • Get current user: `wp_get_current_user` • Check permissions: Use this to verify your current
95
+ user's capabilities and roles Account verification: Confirm you're authenticated with the correct account • Profile
96
+ details: View registration date, email, and user metadata | | [`wp_get_media`](./tools/wp_get_media.md) | media |
97
+ Retrieves a single media item by its ID. | | [`wp_get_page`](./tools/wp_get_page.md) | page | Retrieves a single page by
98
+ its ID. | | [`wp_get_page_revisions`](./tools/wp_get_page_revisions.md) | page | Retrieves revisions for a specific
99
+ page. | | [`wp_get_post`](./tools/wp_get_post.md) | post | Retrieves detailed information about a single post including
100
+ metadata, content statistics, and management links. | | [`wp_get_post_revisions`](./tools/wp_get_post_revisions.md) |
101
+ post | Retrieves the revision history for a specific post showing author and modification dates. | |
102
+ [`wp_get_site_settings`](./tools/wp_get_site_settings.md) | site | Retrieves the general settings for a WordPress site.
103
+ | | [`wp_get_tag`](./tools/wp_get_tag.md) | taxonomy | Retrieves a single tag by its ID. | |
104
+ [`wp_get_user`](./tools/wp_get_user.md) | user | Retrieves a single user by their ID. | |
105
+ [`wp_list_categories`](./tools/wp_list_categories.md) | taxonomy | Lists categories from a WordPress site. | |
106
+ [`wp_list_comments`](./tools/wp_list_comments.md) | comment | Lists comments from a WordPress site, with filters. | |
107
+ [`wp_list_media`](./tools/wp_list_media.md) | media | Lists media items from a WordPress site, with filters. | |
108
+ [`wp_list_pages`](./tools/wp_list_pages.md) | page | Lists pages from a WordPress site, with filters. | |
109
+ [`wp_list_posts`](./tools/wp_list_posts.md) | post | Lists posts from a WordPress site with comprehensive filtering
110
+ options. Supports search, status filtering, and category/tag filtering with enhanced metadata display.
111
+
112
+ **Usage Examples:** • Basic listing: `wp_list_posts` • Search posts: `wp_list_posts --search="AI trends"` • Filter by
113
+ status: `wp_list_posts --status="draft"` • Category filtering: `wp_list_posts --categories=[1,2,3]` • Paginated results:
114
+ `wp_list_posts --per_page=20 --page=2` Combined filters:
115
+ `wp_list_posts --search="WordPress" --status="publish" --per_page=10` | | [`wp_list_tags`](./tools/wp_list_tags.md) |
116
+ taxonomy | Lists tags from a WordPress site. | | [`wp_list_users`](./tools/wp_list_users.md) | user | Lists users from a
117
+ WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and
118
+ activity status.
119
+
120
+ **Usage Examples:** • List all users: `wp_list_users` Search users: `wp_list_users --search="john"` Filter by role:
121
+ `wp_list_users --roles=["editor","author"]` Find admins: `wp_list_users --roles=["administrator"]` Combined search:
122
+ `wp_list_users --search="smith" --roles=["subscriber"]` | | [`wp_performance_alerts`](./tools/wp_performance_alerts.md)
123
+ | performance | Get performance alerts and anomaly detection results | |
124
+ [`wp_performance_benchmark`](./tools/wp_performance_benchmark.md) | performance | Compare current performance against
125
+ industry benchmarks | | [`wp_performance_export`](./tools/wp_performance_export.md) | performance | Export comprehensive
126
+ performance report | | [`wp_performance_history`](./tools/wp_performance_history.md) | performance | Get historical
127
+ performance data and trends | | [`wp_performance_optimize`](./tools/wp_performance_optimize.md) | performance | Get
128
+ optimization recommendations and insights | | [`wp_performance_stats`](./tools/wp_performance_stats.md) | performance |
129
+ Get real-time performance statistics and metrics | | [`wp_search_site`](./tools/wp_search_site.md) | site | Performs a
130
+ site-wide search for content across posts, pages, and media with comprehensive results and metadata.
131
+
132
+ **Usage Examples:** Search everything: `wp_search_site --term="WordPress"` Search posts only:
133
+ `wp_search_site --term="tutorial" --type="posts"` Search pages: `wp_search_site --term="about" --type="pages"`
134
+ Search media: `wp_search_site --term="logo" --type="media"` Find specific content:
135
+ `wp_search_site --term="contact form"` | | [`wp_spam_comment`](./tools/wp_spam_comment.md) | comment | Marks a comment
136
+ as spam. | | [`wp_switch_auth_method`](./tools/wp_switch_auth_method.md) | auth | Switches the authentication method for
137
+ a site for the current session. | | [`wp_test_auth`](./tools/wp_test_auth.md) | auth | Tests the authentication and
138
+ connectivity for a configured WordPress site with detailed connection diagnostics.
139
+
140
+ **Usage Examples:** Test connection: `wp_test_auth` Multi-site test: `wp_test_auth --site="my-site"` • Verify setup:
141
+ Use this after configuring new credentials Troubleshoot: Run when experiencing connection issues • Health check:
142
+ Regular verification of WordPress connectivity | | [`wp_update_category`](./tools/wp_update_category.md) | taxonomy |
143
+ Updates an existing category. | | [`wp_update_comment`](./tools/wp_update_comment.md) | comment | Updates an existing
144
+ comment. | | [`wp_update_media`](./tools/wp_update_media.md) | media | Updates the metadata of an existing media item. |
145
+ | [`wp_update_page`](./tools/wp_update_page.md) | page | Updates an existing page. | |
146
+ [`wp_update_post`](./tools/wp_update_post.md) | post | Updates an existing WordPress post with validation and detailed
147
+ confirmation. | | [`wp_update_site_settings`](./tools/wp_update_site_settings.md) | site | Updates one or more general
148
+ settings for a WordPress site. | | [`wp_update_tag`](./tools/wp_update_tag.md) | taxonomy | Updates an existing tag. | |
149
+ [`wp_update_user`](./tools/wp_update_user.md) | user | Updates an existing user. | |
150
+ [`wp_upload_media`](./tools/wp_upload_media.md) | media | Uploads a file to the WordPress media library. |
163
151
 
164
152
  ## Authentication
165
153
 
166
154
  All tools support multiple authentication methods:
155
+
167
156
  - **Application Passwords** (recommended)
168
- - **JWT Authentication**
157
+ - **JWT Authentication**
169
158
  - **Basic Authentication** (development only)
170
159
  - **API Key Authentication**
171
160
 
172
161
  ## Error Handling
173
162
 
174
163
  Standard error response format:
164
+
175
165
  ```json
176
166
  {
177
167
  "error": "Error type",
@@ -187,6 +177,7 @@ Standard error response format:
187
177
  ## Configuration
188
178
 
189
179
  ### Multi-Site Configuration
180
+
190
181
  ```json
191
182
  {
192
183
  "sites": [
@@ -206,6 +197,7 @@ Standard error response format:
206
197
  ## Response Formats
207
198
 
208
199
  All tools return responses in this format:
200
+
209
201
  ```json
210
202
  {
211
203
  "success": true,
@@ -223,6 +215,7 @@ All tools return responses in this format:
223
215
  ## Performance Monitoring
224
216
 
225
217
  The server includes comprehensive performance monitoring:
218
+
226
219
  - Real-time metrics collection
227
220
  - Historical performance analysis
228
221
  - Industry benchmark comparisons
@@ -19,6 +19,7 @@ Authentication testing and management tools
19
19
  ## Examples
20
20
 
21
21
  ### Basic auth Workflow
22
+
22
23
  ```bash
23
24
  # List all auth
24
25
  wp_list_auth
@@ -26,11 +27,12 @@ wp_list_auth
26
27
  # Get specific item
27
28
  wp_get_aut --id=123
28
29
 
29
- # Create new item
30
+ # Create new item
30
31
  wp_create_aut --title="Example"
31
32
  ```
32
33
 
33
34
  ### Multi-Site auth Management
35
+
34
36
  ```bash
35
37
  # Work with specific site
36
38
  wp_list_auth --site=production
@@ -20,6 +20,7 @@ Performance caching and optimization tools
20
20
  ## Examples
21
21
 
22
22
  ### Basic cache Workflow
23
+
23
24
  ```bash
24
25
  # List all cache
25
26
  wp_list_cache
@@ -27,11 +28,12 @@ wp_list_cache
27
28
  # Get specific item
28
29
  wp_get_cach --id=123
29
30
 
30
- # Create new item
31
+ # Create new item
31
32
  wp_create_cach --title="Example"
32
33
  ```
33
34
 
34
35
  ### Multi-Site cache Management
36
+
35
37
  ```bash
36
38
  # Work with specific site
37
39
  wp_list_cache --site=production
@@ -23,6 +23,7 @@ comment management tools
23
23
  ## Examples
24
24
 
25
25
  ### Basic comment Workflow
26
+
26
27
  ```bash
27
28
  # List all comment
28
29
  wp_list_comment
@@ -30,11 +31,12 @@ wp_list_comment
30
31
  # Get specific item
31
32
  wp_get_commen --id=123
32
33
 
33
- # Create new item
34
+ # Create new item
34
35
  wp_create_commen --title="Example"
35
36
  ```
36
37
 
37
38
  ### Multi-Site comment Management
39
+
38
40
  ```bash
39
41
  # Work with specific site
40
42
  wp_list_comment --site=production
@@ -22,6 +22,7 @@ File upload, management, and media library tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic media Workflow
25
+
25
26
  ```bash
26
27
  # List all media
27
28
  wp_list_media
@@ -29,11 +30,12 @@ wp_list_media
29
30
  # Get specific item
30
31
  wp_get_medi --id=123
31
32
 
32
- # Create new item
33
+ # Create new item
33
34
  wp_create_medi --title="Example"
34
35
  ```
35
36
 
36
37
  ### Multi-Site media Management
38
+
37
39
  ```bash
38
40
  # Work with specific site
39
41
  wp_list_media --site=production
@@ -22,6 +22,7 @@ page management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic page Workflow
25
+
25
26
  ```bash
26
27
  # List all page
27
28
  wp_list_page
@@ -29,11 +30,12 @@ wp_list_page
29
30
  # Get specific item
30
31
  wp_get_pag --id=123
31
32
 
32
- # Create new item
33
+ # Create new item
33
34
  wp_create_pag --title="Example"
34
35
  ```
35
36
 
36
37
  ### Multi-Site page Management
38
+
37
39
  ```bash
38
40
  # Work with specific site
39
41
  wp_list_page --site=production
@@ -23,6 +23,7 @@ Performance monitoring and analytics tools
23
23
  ## Examples
24
24
 
25
25
  ### Basic performance Workflow
26
+
26
27
  ```bash
27
28
  # List all performance
28
29
  wp_list_performance
@@ -30,11 +31,12 @@ wp_list_performance
30
31
  # Get specific item
31
32
  wp_get_performanc --id=123
32
33
 
33
- # Create new item
34
+ # Create new item
34
35
  wp_create_performanc --title="Example"
35
36
  ```
36
37
 
37
38
  ### Multi-Site performance Management
39
+
38
40
  ```bash
39
41
  # Work with specific site
40
42
  wp_list_performance --site=production
@@ -22,6 +22,7 @@ post management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic post Workflow
25
+
25
26
  ```bash
26
27
  # List all post
27
28
  wp_list_post
@@ -29,11 +30,12 @@ wp_list_post
29
30
  # Get specific item
30
31
  wp_get_pos --id=123
31
32
 
32
- # Create new item
33
+ # Create new item
33
34
  wp_create_pos --title="Example"
34
35
  ```
35
36
 
36
37
  ### Multi-Site post Management
38
+
37
39
  ```bash
38
40
  # Work with specific site
39
41
  wp_list_post --site=production
@@ -22,6 +22,7 @@ Site settings and configuration tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic site Workflow
25
+
25
26
  ```bash
26
27
  # List all site
27
28
  wp_list_site
@@ -29,11 +30,12 @@ wp_list_site
29
30
  # Get specific item
30
31
  wp_get_sit --id=123
31
32
 
32
- # Create new item
33
+ # Create new item
33
34
  wp_create_sit --title="Example"
34
35
  ```
35
36
 
36
37
  ### Multi-Site site Management
38
+
37
39
  ```bash
38
40
  # Work with specific site
39
41
  wp_list_site --site=production
@@ -26,6 +26,7 @@ taxonomy management tools
26
26
  ## Examples
27
27
 
28
28
  ### Basic taxonomy Workflow
29
+
29
30
  ```bash
30
31
  # List all taxonomy
31
32
  wp_list_taxonomy
@@ -33,11 +34,12 @@ wp_list_taxonomy
33
34
  # Get specific item
34
35
  wp_get_taxonom --id=123
35
36
 
36
- # Create new item
37
+ # Create new item
37
38
  wp_create_taxonom --title="Example"
38
39
  ```
39
40
 
40
41
  ### Multi-Site taxonomy Management
42
+
41
43
  ```bash
42
44
  # Work with specific site
43
45
  wp_list_taxonomy --site=production
@@ -22,6 +22,7 @@ user management tools
22
22
  ## Examples
23
23
 
24
24
  ### Basic user Workflow
25
+
25
26
  ```bash
26
27
  # List all user
27
28
  wp_list_user
@@ -29,11 +30,12 @@ wp_list_user
29
30
  # Get specific item
30
31
  wp_get_use --id=123
31
32
 
32
- # Create new item
33
+ # Create new item
33
34
  wp_create_use --title="Example"
34
35
  ```
35
36
 
36
37
  ### Multi-Site user Management
38
+
37
39
  ```bash
38
40
  # Work with specific site
39
41
  wp_list_user --site=production