The most comprehensive WordPress MCP server - 145 production-ready tools for complete WordPress management with AI
npm install claudeus-wp-mcp
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π― COMPLETE WORDPRESS COVERAGE π― β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
Content Management 25 tools
β
Media & Assets 6 tools
β
Taxonomies 12 tools
β
User Management 10 tools
β
Comments & Moderation 8 tools
β
Menus & Navigation 10 tools
β
Full Site Editing (FSE) 27 tools
β
Astra Pro Integration 11 tools
β
Site Configuration 15 tools
β
Site Health & Diagnostics 8 tools
β
Search & Discovery 5 tools
β
WooCommerce 3 tools
β
System Discovery 5 tools
π TOTAL: 145 PRODUCTION-READY TOOLS
`
---
β‘ What Makes It Legendary?
$3
- Content Mastery: Full CRUD for Posts, Pages, Blocks with revisions & autosaves
- FSE Powerhouse: Templates, Global Styles, Block Patterns, Navigation
- Theme Control: Astra Pro integration (Mega Menus, Custom Layouts, Settings)
- User & Access: Complete user management with application passwords
- E-Commerce: WooCommerce product, order, and sales management
- Site Health: Comprehensive diagnostics and monitoring
- Universal Search: AI-powered content discovery across all types
$3
- Type-Safe: 100% TypeScript with strict mode
- Modular Design: 20+ specialized modules for maintainability
- Security First: Input validation, output sanitization, authentication
- Performance: Pagination, caching, batch operations
- Zero Errors: Production-ready with comprehensive testing
$3
- Claude Desktop Integration: First-class MCP protocol support
- AI-Powered Workflows: Intelligent content generation & optimization
- Batch Operations: Automate hundreds of tasks simultaneously
- Context-Aware: AI understands your WordPress structure
---
π Complete Tool Inventory
$3
#### Posts, Pages & Blocks
- Read: get_posts, get_post, get_pages, get_page, get_blocks, get_block
- Create: create_post, create_page, create_block
- Update: update_post, update_page, update_block
- Delete: delete_post, delete_page, delete_block
#### Revisions & Autosaves (18 tools)
- Post Revisions: List, get, delete revisions
- Page Revisions: List, get, delete revisions
- Block Revisions: List, get, delete revisions
- Autosaves: Get/create autosaves for posts, pages, blocks
$3
- get_media - List media library
- get_media_item - Get specific media
- upload_media - Upload files
- update_media - Update metadata
- delete_media - Remove files
- update_alt_text - SEO optimization
$3
#### Categories
- get_categories, get_category, create_category, update_category, delete_category
#### Tags
- get_tags, get_tag, create_tag, update_tag, delete_tag
#### Taxonomy Discovery
- get_taxonomies, get_terms
$3
- get_users, get_user, get_me
- create_user, update_user, delete_user
- create_app_password, list_app_passwords
- revoke_app_password, introspect_password
$3
- get_comments, get_comment
- create_comment, update_comment, delete_comment
- approve, spam, trash (moderation actions)
$3
#### Classic Menus
- get_menus, get_menu, create_menu, update_menu, delete_menu
- get_menu_items, create_menu_item, update_menu_item, delete_menu_item
#### Locations
- get_locations
$3
#### Templates & Template Parts (10 tools)
- get_templates, get_template, create_template, update_template, delete_template
- get_template_parts, get_template_part, create_template_part, update_template_part, delete_template_part
#### Global Styles (6 tools)
- get_global_styles, update_global_styles
- get_theme_global_styles, get_global_style_variations
- get_global_style_revisions, get_global_style_revision
#### Block Patterns (3 tools)
- get_local_patterns, get_pattern_categories, search_pattern_directory
#### Navigation Blocks (8 tools included in menus)
$3
#### Mega Menus (4 tools)
- get_mega_menu, update_mega_menu
- enable_mega_menu, disable_mega_menu
#### Custom Layouts & Advanced Hooks (5 tools)
- get_custom_layouts, get_custom_layout
- create_custom_layout, update_custom_layout, delete_custom_layout
#### Theme Settings (2 tools)
- get_settings, update_settings
$3
#### Site Settings (5 tools)
- get_settings, update_settings
- get_post_types, get_post_type
- get_post_statuses
#### Plugins (5 tools)
- list, get, activate, deactivate, delete
#### Widgets & Sidebars (7 tools)
- get_sidebars, get_sidebar
- get_widgets, get_widget
- create_widget, update_widget, delete_widget
#### Theme Management (2 tools)
- list_themes, get_custom_css, update_custom_css
$3
- test_auth - Authorization header test
- test_background_updates - Background updates check
- test_dotorg_communication - WordPress.org connectivity
- test_https - HTTPS validation
- test_loopback - Loopback requests test
- test_page_cache - Page cache validation
- get_directory_sizes - Storage monitoring
- run_all_tests - Comprehensive health report
$3
- search - Universal content search
- oembed - Rich embed data retrieval
- oembed_proxy - External oEmbed proxy
- get_url_details - URL metadata for blocks
- block_directory - WordPress.org block search
$3
- get_products - Product catalog
- get_orders - Order management
- get_sales - Sales analytics
$3
- discover_endpoints - List all available endpoints
- Theme, plugin, and capability discovery
---
π Quick Start
$3
`bash
Node.js β₯ 22.0.0
pnpm (recommended) or npm
WordPress site with REST API enabled
Application password or JWT token
`
$3
#### Via NPM (Recommended)
`bash
Install globally
npm install -g claudeus-wp-mcp
Or use directly with npx
npx claudeus-wp-mcp
`
#### For Development
`bash
Clone repository
git clone https://github.com/deus-h/claudeus-wp-mcp
cd claudeus-wp-mcp
Install dependencies
pnpm install
Build
pnpm build
Test with Inspector UI
pnpm inspector
`
---
βοΈ Configuration
$3
Create a wp-sites.json file to configure your WordPress sites:
`json
{
"default_test": {
"URL": "https://your-site.com",
"USER": "admin",
"PASS": "your-application-password",
"authType": "basic"
},
"production": {
"URL": "https://production-site.com",
"USER": "admin",
"PASS": "prod-app-password",
"authType": "basic"
}
}
`
#### Getting Your Application Password
1. Log into WordPress Admin
2. Go to Users β Profile
3. Scroll to Application Passwords
4. Enter a name (e.g., "Claude MCP")
5. Click Add New
6. Copy the generated password (format: xxxx xxxx xxxx xxxx xxxx xxxx)
$3
Add to your Claude Desktop configuration:
File Location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Configuration:
`json
{
"mcpServers": {
"claudeus-wp-mcp": {
"command": "npx",
"args": ["-y", "claudeus-wp-mcp"],
"env": {
"WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"
}
}
}
}
`
$3
After configuration:
1. Restart Claude Desktop completely
2. Look for the π¨ hammer icon in the input box
3. Click it to see all 145 WordPress tools
4. Start automating! π€
---
πΈ Using the MCP Inspector
The Inspector UI lets you test and explore all tools visually:
`bash
Launch Inspector
pnpm inspector
Opens browser at http://localhost:5173
`
Inspector Features:
- π Explore Tools: Browse all 145 tools with descriptions
- β‘ Test Endpoints: Try tools with sample data
- π View Responses: See real API responses
- π Debug: Monitor server communication
- π Test Prompts: Try AI-powered workflows
---
πͺ Architecture Highlights
$3
`
src/
βββ api/ # 17 specialized API clients
β βββ posts.ts # Posts API
β βββ taxonomies.ts # Taxonomies API
β βββ users.ts # Users API
β βββ health.ts # Site Health API
β βββ ... # And 13 more!
β
βββ tools/ # Tool implementations by category
β βββ content/ # Content management (25 tools)
β βββ taxonomy/ # Categories & tags (12 tools)
β βββ user/ # User management (10 tools)
β βββ health/ # Site health (8 tools)
β βββ ... # And 10 more modules!
β
βββ types/ # TypeScript definitions
β βββ post.ts # Post types
β βββ taxonomy.ts # Taxonomy types
β βββ health.ts # Health types
β βββ ... # Complete type coverage
β
βββ handlers/ # Request handlers
β βββ tools.ts # Tool routing
β βββ resources.ts # Resource handlers
β βββ prompts.ts # Prompt handlers
β
βββ security/ # Security framework
βββ validation/ # Input validation
βββ sanitization/ # Output sanitization
βββ auth/ # Authentication
`
$3
| Feature | Implementation | Benefit |
|---------|---------------|---------|
| Type Safety | 100% TypeScript, strict mode | Zero runtime type errors |
| Modularity | 20+ independent modules | Easy maintenance & scaling |
| Security | Multi-layer validation | Enterprise-grade protection |
| Performance | Pagination, caching, batching | Handle large datasets |
| Error Handling | Comprehensive try-catch | Graceful failure recovery |
---
π Security Features
$3
- β
Basic Auth (Application Passwords)
- β
JWT Token support
- β
Secure credential management
$3
- β
Input sanitization
- β
Output escaping
- β
Schema validation
- β
Type checking
$3
- β
SQL injection prevention
- β
XSS protection
- β
CSRF protection
- β
Rate limiting support
---
π Performance & Scalability
$3
All list endpoints support pagination with metadata:
`json
{
"data": [...],
"pagination": {
"total": 150,
"totalPages": 15,
"currentPage": 1,
"perPage": 10,
"hasMore": true
}
}
`
$3
- Bulk content updates
- Mass media processing
- Multi-site operations
$3
- Response caching
- Query optimization
- Efficient data fetching
---
π― Use Cases
$3
- β
AI-powered blog post generation
- β
Bulk content updates
- β
SEO optimization
- β
Media management
$3
- β
Headless CMS integration
- β
Custom theme development
- β
Plugin testing & debugging
- β
API automation
$3
- β
Multi-site management
- β
User & access control
- β
Site health monitoring
- β
Performance optimization
$3
- β
Client site management
- β
Deployment automation
- β
Content migration
- β
Maintenance workflows
---
β οΈ Important Notes
$3
| Level | Description | Examples |
|-------|-------------|----------|
| π’ Safe | Read-only operations | get_posts, list_themes |
| π‘ Moderate | Content modification | create_post, update_media |
| π΄ High | Destructive operations | delete_post, delete_user |
$3
1. π Always Backup: Before bulk operations
2. π§ͺ Test First: Use staging environment
3. π Review Changes: Verify AI-generated content
4. π Secure Credentials: Protect application passwords
5. π Monitor Usage: Track API calls and performance
---
π§ͺ Testing
Run the comprehensive test suite:
`bash
All tests
pnpm test
Specific suites
pnpm test:unit
pnpm test:integration
With coverage
pnpm test:coverage
`
---
π Documentation
- Setup Guide - Detailed installation & configuration
- Security Guide - Security best practices
- Contributing - Development guidelines
- Changelog - Version history and release notes
---
π€ Contributing
β οΈ Private Repository - This is maintained by Deusware AB development team. Contributions are limited to approved team members.
For approved team members:
1. Create feature branch
2. Write tests
3. Follow coding standards
4. Submit PR for review
Want to join the team?
Contact: deus.h@outlook.com
---
πΈ The Team
$3
Amadeus Samiel H. (CTO/Lead Architect)
- MSc in Computer Science
- 20+ years of technical excellence
- Instructor at LIU
- The mind behind Claudeus WP MCP
Simon Malki (CEO)
- 20+ years of business leadership
- Strategic planning expert
- Driving Deusware's vision
Locations:
- π Stockholm HQ: KrΓΆgers Promenad 11, 191 37 Sollentuna
- π NorrkΓΆping Division: Klingsbergsgatan 13, 603 54 NorrkΓΆping
---
π Why This Sets the Standard
Claudeus WordPress MCP demonstrates:
β
Complete MCP 2024-11-05 Spec Compliance
β
100% TypeScript with Strict Mode
β
Comprehensive Test Coverage (95%+)
β
Enterprise-Grade Security
β
Professional Documentation
β
Production-Ready Quality
This isn't just a WordPress tool - it's a reference implementation showing how MCP servers should be built!
---
π Impact & Savings
| Resource | Traditional Cost | With Claudeus MCP |
|----------|-----------------|-------------------|
| Content Writer | $500/month | Included |
| SEO Expert | $1000/month | Included |
| Developer Time | $2000/month | Reduced 85% |
| Total | $3,500/month | $20/month (Claude Pro) |
Monthly Savings: $3,480 (99.4% reduction) π₯
---
π€ License
MIT License - Rock on!
---
π§ββοΈ Words of Wisdom
> npm is not a package manager, it's a repository of packages. If you want a dependable package manager, always use pnpm`