mcp-wordpress 2.2.0 → 2.4.0

package/docs/api/tools/wp_create_post.md

@@ -2,7 +2,14 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Creates a new post.
+Creates a new WordPress post with comprehensive validation and detailed success feedback including management links.
+
+**Usage Examples:**
+• Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"`
+• Draft post: `wp_create_post --title="Draft Post" --status="draft"`
+• Categorized post: `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]`
+• Scheduled post: `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"`
+• Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`
 
 ## Parameters
 
@@ -75,8 +82,7 @@ wp_create_post --title="Example Post Title" --content="This is example content f
 
 **Endpoint:** `/wp-json/wp/v2/posts`
 
-This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
-parameters are determined by WordPress core functionality.
+This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
 
 ### WordPress Documentation
 - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)

package/docs/api/tools/wp_delete_post.md

@@ -2,7 +2,7 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Deletes a post.
+Deletes a WordPress post with option for permanent deletion or moving to trash.
 
 ## Parameters
 
@@ -46,8 +46,7 @@ wp_delete_post --id="123"
 
 **Endpoint:** `/wp-json/wp/v2/posts/{id}`
 
-This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
-parameters are determined by WordPress core functionality.
+This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
 
 ### WordPress Documentation
 - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)

package/docs/api/tools/wp_get_current_user.md

@@ -2,7 +2,13 @@
 
 ![user](https://img.shields.io/badge/category-user-lightgrey)
 
-Retrieves the currently authenticated user.
+Retrieves the currently authenticated user with comprehensive profile information including roles, capabilities, and account details.
+
+**Usage Examples:**
+• Get current user: `wp_get_current_user`
+• Check permissions: Use this to verify your current user's capabilities and roles
+• Account verification: Confirm you're authenticated with the correct account
+• Profile details: View registration date, email, and user metadata
 
 ## Parameters
 

package/docs/api/tools/wp_get_post.md

@@ -2,7 +2,7 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Retrieves a single post by its ID.
+Retrieves detailed information about a single post including metadata, content statistics, and management links.
 
 ## Parameters
 
@@ -48,8 +48,7 @@ wp_get_post --id="123"
 
 **Endpoint:** `/wp-json/wp/v2/posts/{id}`
 
-This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
-parameters are determined by WordPress core functionality.
+This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
 
 ### WordPress Documentation
 - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)

package/docs/api/tools/wp_get_post_revisions.md

@@ -2,7 +2,7 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Retrieves revisions for a specific post.
+Retrieves the revision history for a specific post showing author and modification dates.
 
 ## Parameters
 

package/docs/api/tools/wp_list_posts.md

@@ -2,7 +2,15 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Lists posts from a WordPress site, with filters.
+Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and category/tag filtering with enhanced metadata display.
+
+**Usage Examples:**
+• Basic listing: `wp_list_posts`
+• Search posts: `wp_list_posts --search="AI trends"`
+• Filter by status: `wp_list_posts --status="draft"`
+• Category filtering: `wp_list_posts --categories=[1,2,3]`
+• Paginated results: `wp_list_posts --per_page=20 --page=2`
+• Combined filters: `wp_list_posts --search="WordPress" --status="publish" --per_page=10`
 
 ## Parameters
 
@@ -92,8 +100,7 @@ wp_list_posts --per_page="10" --search="wordpress" --status="publish" --categori
 
 **Endpoint:** `/wp-json/wp/v2/posts`
 
-This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
-parameters are determined by WordPress core functionality.
+This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
 
 ### WordPress Documentation
 - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)

package/docs/api/tools/wp_list_users.md

@@ -2,7 +2,14 @@
 
 ![user](https://img.shields.io/badge/category-user-lightgrey)
 
-Lists users from a WordPress site, with filters.
+Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status.
+
+**Usage Examples:**
+• List all users: `wp_list_users`
+• Search users: `wp_list_users --search="john"`
+• Filter by role: `wp_list_users --roles=["editor","author"]`
+• Find admins: `wp_list_users --roles=["administrator"]`
+• Combined search: `wp_list_users --search="smith" --roles=["subscriber"]`
 
 ## Parameters
 

package/docs/api/tools/wp_search_site.md

@@ -2,7 +2,14 @@
 
 ![site](https://img.shields.io/badge/category-site-lightblue)
 
-Performs a site-wide search for content.
+Performs a site-wide search for content across posts, pages, and media with comprehensive results and metadata.
+
+**Usage Examples:**
+• Search everything: `wp_search_site --term="WordPress"`
+• Search posts only: `wp_search_site --term="tutorial" --type="posts"`
+• Search pages: `wp_search_site --term="about" --type="pages"`
+• Search media: `wp_search_site --term="logo" --type="media"`
+• Find specific content: `wp_search_site --term="contact form"`
 
 ## Parameters
 

package/docs/api/tools/wp_test_auth.md

@@ -2,7 +2,14 @@
 
 ![auth](https://img.shields.io/badge/category-auth-darkblue)
 
-Tests the authentication and connectivity for a configured WordPress site.
+Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.
+
+**Usage Examples:**
+• Test connection: `wp_test_auth`
+• Multi-site test: `wp_test_auth --site="my-site"`
+• Verify setup: Use this after configuring new credentials
+• Troubleshoot: Run when experiencing connection issues
+• Health check: Regular verification of WordPress connectivity
 
 ## Parameters
 

package/docs/api/tools/wp_update_post.md

@@ -2,7 +2,7 @@
 
 ![post](https://img.shields.io/badge/category-post-lightgrey)
 
-Updates an existing post.
+Updates an existing WordPress post with validation and detailed confirmation.
 
 ## Parameters
 
@@ -73,8 +73,7 @@ wp_update_post --id="123" --title="Example Post Title" --content="This is exampl
 
 **Endpoint:** `/wp-json/wp/v2/posts/{id}`
 
-This tool directly interfaces with the WordPress REST API endpoint above. The response format and available
-parameters are determined by WordPress core functionality.
+This tool directly interfaces with the WordPress REST API endpoint above. The response format and available parameters are determined by WordPress core functionality.
 
 ### WordPress Documentation
 - [WordPress REST API Handbook](https://developer.wordpress.org/rest-api/)