Claudeus WordPress MCP

A server for integrating with WordPress sites, enabling content management and interaction via the Model Context Protocol.

GitHub

🤘 Claudeus WordPress MCP 🎸

"The Most Comprehensive WordPress MCP Server - 145 Tools, Zero Compromise!" 🖤

License Node GitHub Stars NPM Version MCP Standard

Claudeus WordPress MCP Server

🔥 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)

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

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

Node.js ≥ 22.0.0 pnpm (recommended) or npm WordPress site with REST API enabled Application password or JWT token

Installation

Via NPM (Recommended)

Install globally

npm install -g claudeus-wp-mcp

Or use directly with npx

npx claudeus-wp-mcp

For Development

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:

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

Log into WordPress Admin
Go to Users → Profile
Scroll to Application Passwords
Enter a name (e.g., "Claude MCP")
Click Add New
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:

{ "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:

Restart Claude Desktop completely
Look for the 🔨 hammer icon in the input box
Click it to see all 145 WordPress tools
Start automating! 🤘

🎸 Using the MCP Inspector

The Inspector UI lets you test and explore all tools visually:

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:

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

🔒 Always Backup: Before bulk operations
🧪 Test First: Use staging environment
👀 Review Changes: Verify AI-generated content
🔐 Secure Credentials: Protect application passwords
📊 Monitor Usage: Track API calls and performance

🧪 Testing

Run the comprehensive test suite:

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:

Create feature branch
Write tests
Follow coding standards
Submit PR for review

**Want to join the team?**Contact: [email protected]

🎸 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 Amadeus Samiel H.

145 Tools. Zero Compromise. Pure Metal. 🎸🔥

MseeP.ai Security Assessment Badge