WP Manifestindependent plugin directory
manifest / ai / wp-mcp-abilities

NEW WP Content Abilities v3.0

Professional WordPress content management via AI - 48 powerful abilities for complete WordPress control through the Model Context Protocol (MCP)

by Icons Event Hall · github.com/onehotbabe4u123/wp-mcp-abilities · website

★ 1stars
1forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/onehotbabe4u123/wp-mcp-abilities/archive/refs/heads/main.zip
Readme github.com/onehotbabe4u123/wp-mcp-abilities ↗

WordPress MCP Abilities v3.0

Professional WordPress content management via AI - 48 powerful abilities for complete WordPress control through the Model Context Protocol (MCP).

🎯 What This Does

This plugin exposes 48 WordPress abilities through MCP, allowing AI assistants like Claude to:

  • ✅ Create, read, update, and delete posts/pages
  • ✅ Manage categories and tags (complete CRUD)
  • ✅ Upload and optimize media files
  • ✅ Moderate comments (approve/spam/trash)
  • ✅ Track content revisions and rollback
  • ✅ Monitor site health and performance
  • ✅ Manage users, menus, themes, and plugins
  • ✅ Perform bulk operations and SEO optimization

Use Case: Have conversations with Claude like:

"Create a blog post about summer weddings, add it to the Events category, tag it with 'wedding' and 'summer', upload a featured image from this URL with proper alt text, and publish it."

Claude executes this as a single workflow using the 48 abilities.

📊 Features

Content Management (12 abilities)

  • List, create, update, delete posts & pages
  • Search content across your site
  • Get post revisions and restore previous versions
  • Bulk publish drafts

Taxonomy Operations (10 abilities)

  • List categories and tags
  • NEW: Create, update, delete categories
  • NEW: Create, update, delete tags
  • Add categories/tags to posts

Media Library (7 abilities)

  • Upload media from URLs
  • List, get, update, delete media
  • NEW: Bulk update alt text for SEO
  • Set featured images

Comments (5 abilities)

  • List recent comments
  • NEW: Create, update, delete comments
  • NEW: Moderate (approve/spam/trash)

Site Health (3 abilities)

  • NEW: Comprehensive health check
  • NEW: HTTPS/SSL validation
  • NEW: Directory storage monitoring

Plus (11 more abilities)

  • Site information & plugin management
  • User listing and details
  • Menu locations and items
  • Theme information
  • Options management

🚀 Quick Start

Prerequisites

  1. WordPress 6.8+ with admin access
  2. WordPress Abilities API plugin installed
  3. MCP Adapter plugin installed
  4. Application Password created in WordPress

Installation

Option 1: Direct Download

# SSH into your server
ssh username@your-server-ip

# Navigate to plugins directory
cd /var/www/html/wp-content/plugins/

# Clone this repository
git clone https://github.com/YOUR_USERNAME/wp-mcp-abilities.git

# Set permissions
sudo chown -R www-data:www-data wp-mcp-abilities
sudo chmod 644 wp-mcp-abilities/NEW-wp-content-abilities-v3.0.php

# Activate plugin
wp plugin activate NEW-wp-content-abilities-v3.0

Option 2: Manual Upload

  1. Download NEW-wp-content-abilities-v3.0.php
  2. Upload to /wp-content/plugins/ via FTP/SFTP
  3. Set permissions: 644 and owner www-data:www-data
  4. Activate in WordPress admin or via WP-CLI

Verification

# Check plugin is active
wp plugin list | grep abilities

# Count abilities (should be 48+)
wp mcp-adapter list | wc -l

# List all abilities
wp mcp-adapter list

🔧 Configuration

1. Create Application Password

In WordPress admin:

  1. Go to Users → Profile
  2. Scroll to Application Passwords
  3. Name: Claude MCP v3.0
  4. Click Add New
  5. Copy the generated password (save securely!)

2. Configure Claude Desktop

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wordpress": {
      "url": "https://your-domain.com/wp-json/mcp/mcp-adapter-default-server",
      "transport": {
        "type": "http",
        "auth": {
          "type": "basic",
          "credentials": {
            "username": "your_wp_username",
            "password": "xxxx xxxx xxxx xxxx xxxx xxxx"
          }
        }
      }
    }
  }
}

Restart Claude Desktop to apply changes.

💬 Usage Examples

Once configured, try these commands in Claude Desktop:

Content Creation

"Create a blog post titled 'Welcome to Summer' about summer events, 
add it to the 'News' category, tag it with 'events' and 'summer', 
and set it to publish status."

Taxonomy Management

"Create a new category called 'Weddings' with description 'Wedding-related content'"
"List all categories with their post counts"
"Update the 'Events' category description"

Media Optimization

"Upload an image from https://example.com/image.jpg with alt text 'Summer sunset'"
"Show me all images without alt text"
"Update alt text for media items 45, 46, and 47 for SEO"

Comment Moderation

"Show me pending comments from the last 7 days"
"Approve comment ID 123"
"Mark comment 456 as spam"

Site Monitoring

"Run a health check on my WordPress site"
"Check if HTTPS is properly configured"
"Show me storage usage by directory"

Advanced Workflows

"Get the revision history for post ID 42 and restore the version from yesterday"
"Publish all draft posts created this week"
"Find all posts without featured images"

📚 Complete Ability Reference

Content Management

  1. content/list-posts - List posts with filtering
  2. content/list-pages - List all pages
  3. content/create-post - Create new post (with categories/tags)
  4. content/create-page - Create new page
  5. content/update-post - Update existing post
  6. content/delete-post - Delete post/page
  7. content/get-post - Get full post details
  8. content/search - Search content by keyword
  9. content/list-post-types - List custom post types
  10. content/bulk-publish-drafts - Publish multiple drafts
  11. content/get-revisions ⭐ NEW - Get revision history
  12. content/restore-revision ⭐ NEW - Restore previous version

Taxonomy Operations

  1. taxonomy/list-categories - List all categories
  2. taxonomy/list-tags - List all tags
  3. taxonomy/create-category ⭐ NEW - Create category
  4. taxonomy/update-category ⭐ NEW - Update category
  5. taxonomy/delete-category ⭐ NEW - Delete category
  6. taxonomy/create-tag ⭐ NEW - Create tag
  7. taxonomy/update-tag ⭐ NEW - Update tag
  8. taxonomy/delete-tag ⭐ NEW - Delete tag
  9. taxonomy/add-category-to-post - Assign category
  10. taxonomy/add-tags-to-post - Add tags

Media Library

  1. media/upload - Upload from URL
  2. media/list - List media library
  3. media/set-featured-image - Set post thumbnail
  4. media/get-item ⭐ NEW - Get media details
  5. media/update ⭐ NEW - Update metadata
  6. media/delete ⭐ NEW - Delete media
  7. media/bulk-update-alt-text ⭐ NEW - SEO optimization

Comments Management

  1. comments/list-recent - List comments
  2. comments/create ⭐ NEW - Add comment
  3. comments/update ⭐ NEW - Edit comment
  4. comments/delete ⭐ NEW - Remove comment
  5. comments/moderate ⭐ NEW - Approve/spam/trash

Site Health

  1. site/health-check ⭐ NEW - Full diagnostics
  2. site/test-https ⭐ NEW - SSL validation
  3. site/directory-sizes ⭐ NEW - Storage monitoring

Site Information

  1. site/get-info - Site details and stats
  2. site/list-plugins - Installed plugins

User Management

  1. users/list - List WordPress users
  2. users/get-info - User details

Menu Operations

  1. menus/list-locations - Menu locations
  2. menus/get-items - Menu items

Theme Management

  1. theme/get-info - Active theme details
  2. theme/list-available - Installed themes

Options Management

  1. options/get - Get option value
  2. options/update - Update option value

⭐ = New in v3.0 (20 new abilities)

🔒 Security

Permissions Required

Different abilities require different WordPress capabilities:

Ability Type Required Capability
View content is_user_logged_in()
Create posts publish_posts
Edit posts edit_posts
Delete posts delete_posts
Upload media upload_files
Manage categories/tags manage_categories
Moderate comments moderate_comments
Site health manage_options

Recommendation: Use an Administrator account for full access to all 48 abilities.

Best Practices

  1. Use Application Passwords - Never use your main WordPress password
  2. HTTPS Only - Always use SSL/TLS for MCP connections
  3. Limit Access - Restrict MCP endpoint to specific IPs if possible
  4. Regular Audits - Monitor MCP usage in server logs
  5. Backups - Regular backups before bulk operations

🔄 Version History

v3.0.0 (Current) - Production Ready

  • 🎉 48 total abilities (up from 28)
  • ✅ Complete CRUD for 6 content types
  • ⭐ 20 new abilities added:
    • Complete taxonomy management (create/update/delete)
    • Full comment moderation workflow
    • Complete media management + bulk SEO
    • Content revision control
    • Site health monitoring

v2.0.0 - Enhanced

  • 28 abilities
  • Added media, users, menus, theme, options
  • Partial CRUD operations

v1.0.0 - Initial Release

  • 8 abilities
  • Basic content management

📈 Roadmap

v4.0 (Planned)

  • User CRUD (create/update/delete users)
  • Menu CRUD (create/update/delete menus)
  • Plugin management (activate/deactivate)
  • Estimated: +15 abilities (63 total)

v5.0 (Future)

  • Full Site Editing (FSE) support
  • WooCommerce integration
  • Advanced analytics
  • Estimated: +30 abilities (93 total)

🐛 Troubleshooting

Plugin Not Showing in WordPress

# Check file permissions
ls -lah /var/www/html/wp-content/plugins/NEW-wp-content-abilities-v3.0.php
# Should be: -rw-r--r-- 1 www-data www-data

# Check for PHP syntax errors
php -l NEW-wp-content-abilities-v3.0.php

Abilities Not Registering

# Check if abilities are registered
wp mcp-adapter list | wc -l
# Should output: 48+

# Check specific ability
wp eval 'var_dump(wp_get_ability("taxonomy/create-category"));'

# Restart PHP-FPM
sudo systemctl restart php8.3-fpm

MCP Endpoint Not Responding

# Test basic REST API
curl "https://your-domain.com/wp-json/"

# Test MCP endpoint (requires auth)
curl -X POST "https://your-domain.com/wp-json/mcp/mcp-adapter-default-server" \
  -H "Content-Type: application/json" \
  -u "username:app_password" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Enable Debug Logging

// Add to wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

// Monitor logs
tail -f /var/www/html/wp-content/debug.log

🤝 Contributing

Contributions are welcome! Please:

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the GPL v2 or later - see the LICENSE file for details.

🙏 Credits

Built on top of:

📧 Support

⚡ Quick Links

Made with ❤️ for the WordPress + AI community

Transform WordPress management through natural conversation with AI.