Content
# <span style="color: #A351D6">🤘 Claudeus WordPress MCP</span> 🎸
> *"The Most Comprehensive WordPress MCP Server - 145 Tools, Zero Compromise!"* <span style="color: #000000">🖤</span>


[](https://github.com/deus-h/claudeus-wp-mcp/stargazers)
[](https://www.npmjs.com/package/claudeus-wp-mcp)
[](https://github.com/deus-h/claudeus-wp-mcp)

## 🔥 The Complete WordPress AI Powerhouse
**145 Production-Ready Tools** covering every aspect of WordPress management, from content creation to site health monitoring, all powered by AI and built with enterprise-grade quality.
```
╔═══════════════════════════════════════════════════════╗
║ 🎯 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?
### 🎸 **Complete WordPress Ecosystem Coverage**
- **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
### 💪 **Enterprise-Grade Architecture**
- **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
### 🚀 **Built for AI**
- **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
### 1. Content Management (25 tools)
#### 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
### 2. Media & Assets (6 tools)
- `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. Taxonomies (12 tools)
#### 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`
### 4. User Management (10 tools)
- `get_users`, `get_user`, `get_me`
- `create_user`, `update_user`, `delete_user`
- `create_app_password`, `list_app_passwords`
- `revoke_app_password`, `introspect_password`
### 5. Comments & Moderation (8 tools)
- `get_comments`, `get_comment`
- `create_comment`, `update_comment`, `delete_comment`
- `approve`, `spam`, `trash` (moderation actions)
### 6. Menus & Navigation (10 tools)
#### 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`
### 7. Full Site Editing - FSE (27 tools)
#### 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)
### 8. Astra Pro Integration (11 tools)
#### 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`
### 9. Site Configuration (15 tools)
#### 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`
### 10. Site Health & Diagnostics (8 tools)
- `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
### 11. Search & Discovery (5 tools)
- `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
### 12. WooCommerce (3 tools)
- `get_products` - Product catalog
- `get_orders` - Order management
- `get_sales` - Sales analytics
### 13. System Discovery (5 tools)
- `discover_endpoints` - List all available endpoints
- Theme, plugin, and capability discovery
---
## 🚀 Quick Start
### Prerequisites
```bash
Node.js ≥ 22.0.0
pnpm (recommended) or npm
WordPress site with REST API enabled
Application password or JWT token
```
### Installation
#### 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
### 1. Create wp-sites.json
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`)
### 2. Configure Claude Desktop
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. Restart Claude Desktop
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
### Modular Design
```
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
```
### Key Features
| 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
### Authentication
- ✅ Basic Auth (Application Passwords)
- ✅ JWT Token support
- ✅ Secure credential management
### Validation
- ✅ Input sanitization
- ✅ Output escaping
- ✅ Schema validation
- ✅ Type checking
### Protection
- ✅ SQL injection prevention
- ✅ XSS protection
- ✅ CSRF protection
- ✅ Rate limiting support
---
## 📈 Performance & Scalability
### Pagination Support
All list endpoints support pagination with metadata:
```json
{
"data": [...],
"pagination": {
"total": 150,
"totalPages": 15,
"currentPage": 1,
"perPage": 10,
"hasMore": true
}
}
```
### Batch Operations
- Bulk content updates
- Mass media processing
- Multi-site operations
### Caching
- Response caching
- Query optimization
- Efficient data fetching
---
## 🎯 Use Cases
### Content Creators
- ✅ AI-powered blog post generation
- ✅ Bulk content updates
- ✅ SEO optimization
- ✅ Media management
### Developers
- ✅ Headless CMS integration
- ✅ Custom theme development
- ✅ Plugin testing & debugging
- ✅ API automation
### Site Administrators
- ✅ Multi-site management
- ✅ User & access control
- ✅ Site health monitoring
- ✅ Performance optimization
### Agencies
- ✅ Client site management
- ✅ Deployment automation
- ✅ Content migration
- ✅ Maintenance workflows
---
## ⚠️ Important Notes
### Danger Levels
| 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` |
### Best Practices
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](SETUP-GUIDE.md)** - Detailed installation & configuration
- **[Security Guide](SECURITY.md)** - Security best practices
- **[Contributing](CONTRIBUTING.md)** - Development guidelines
- **[Changelog](CHANGELOG.md)** - 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
### Deusware AB
**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`
> — Amadeus Samiel H.
---
> Made with 🤘❤️ by [<span style="color: #A351D6">Amadeus Samiel H.</span>](mailto:deus.h@outlook.com)
**145 Tools. Zero Compromise. Pure Metal.** 🎸🔥
Connection Info
You Might Also Like
MarkItDown
Python tool for converting files and office documents to Markdown.
Fetch
Retrieve and process content from web pages by converting HTML into markdown format.
chatbox
User-friendly Desktop Client App for AI Models/LLMs (GPT, Claude, Gemini, Ollama...)
Continue
Continue is an open-source project for seamless server management.
semantic-kernel
Build and deploy intelligent AI agents with Semantic Kernel's orchestration...
repomix
Repomix packages your codebase into AI-friendly formats for easy integration.