Wordpress Mcp Server

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

Gets the current authentication status for a configured WordPress site.

Switches the authentication method for a site for the current session and verifies the new credentials with a live request. The switch is in-memory only — it does not persist across server restarts; update your configuration file for that.

Get cache statistics for a WordPress site.

Clear cache for a WordPress site.

Pre-warm cache with essential WordPress data.

Get detailed cache configuration and status information.

Lists comments from a WordPress site, with filters.

Retrieves a single comment by its ID.

Creates a new comment on a post.

Updates an existing comment.

Deletes a comment.

Approves a pending comment.

Marks a comment as spam.

Lists media items from a WordPress site, with filters.

Retrieves a single media item by its ID.

Uploads a file to the WordPress media library.

Updates the metadata of an existing media item.

Deletes a media item.

Lists pages from a WordPress site, with filters.

Retrieves a single page by its ID, optionally including full content for editing.

Creates a new page.

Updates an existing page.

Deletes a page.

Retrieves revisions for a specific page.

Get real-time performance statistics and metrics. Note: Top-level metrics (totalRequests, averageResponseTime, errorRate) are session-wide aggregates across all sites. Per-site cache and client stats are shown in the siteSpecific section when a site parameter is provided.

Get historical performance data and trends

Compare current performance against industry benchmarks. Note: Benchmarks are based on session-wide aggregated metrics across all sites, not per-site metrics.

Get performance alerts and anomaly detection results

Get optimization recommendations and insights

Export comprehensive performance report

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`

Retrieves detailed information about a single post including metadata, content statistics, and management links. Optionally includes full HTML content for editing. **Usage Examples:** • Basic metadata: `wp_get_post --id=123` • With full content: `wp_get_post --id=123 --include_content=true`

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]` • Post with featured image: `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42` • Remove featured image: `wp_create_post --title="My Post" --featured_media=0` • 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"`

Updates an existing WordPress post with comprehensive validation and change tracking. All parameters except ID are optional - only provided fields will be updated. **Usage Examples:** • Update title: `wp_update_post --id=123 --title="New Title"` • Update content: `wp_update_post --id=123 --content="<p>Updated content</p>"` • Change status: `wp_update_post --id=123 --status="publish"` • Update categories: `wp_update_post --id=123 --categories=[1,5,10]` • Set featured image: `wp_update_post --id=123 --featured_media=42` • Remove featured image: `wp_update_post --id=123 --featured_media=0` • Multiple updates: `wp_update_post --id=123 --title="New Title" --status="publish" --categories=[1,2]`

Deletes a WordPress post with options for trash or permanent deletion. Includes safety confirmations and detailed feedback on the deletion action. **Usage Examples:** • Trash a post: `wp_delete_post --id=123` (moves to trash) • Permanent deletion: `wp_delete_post --id=123 --force=true` • Bulk operations: Use multiple calls with different IDs

Retrieves the revision history for a specific post, including details about changes, dates, and authors for content management and auditing purposes.

Analyze WordPress post content for SEO optimization opportunities including readability, keyword density, structure, and technical factors

Generate SEO-optimized metadata including title tags, meta descriptions, OpenGraph, and Twitter Card data

Update SEO metadata for multiple posts with progress tracking and error handling

Generate JSON-LD structured data schema for enhanced search results

Validate JSON-LD schema markup for correctness and compliance

Analyze content and suggest relevant internal linking opportunities for better SEO

Perform comprehensive SEO audit of the WordPress site including technical, content, and performance analysis

Track search engine result page positions for target keywords

Research keywords and get suggestions based on topic and competition analysis

Test SEO plugin integration and detect available SEO plugins on the WordPress site

Retrieve live SEO data from WordPress including plugin-specific metadata and configurations

Retrieves the general settings for a WordPress site. Requires administrator role (manage_options capability).

Updates one or more general settings for a WordPress site. Requires administrator role (manage_options capability).

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"`

Lists application passwords for a specific user.

Creates a new application password for a user.

Revokes an existing application password.

Check if a newer version of mcp-wordpress is available. Returns current version, latest version, and download URL if update is available.

Lists categories from a WordPress site.

Retrieves a single category by its ID.

Creates a new category.

Updates an existing category.

Deletes a category.

Lists tags from a WordPress site.

Retrieves a single tag by its ID.

Creates a new tag.

Updates an existing tag.

Deletes a tag.

Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status. **Note:** Role, email, and registration date fields require **administrator** privileges. Non-admin users will see limited metadata due to WordPress REST API restrictions. **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"]`

Retrieves a single user by their ID.

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

Creates a new user.

Updates an existing user.

Deletes a user.