@respira/wordpress-mcp-server
v2.0.9TypeScript
The only WordPress MCP with page builder support. Edit Divi, Elementor, Bricks + 7 more builders with AI. Duplicate-before-edit safety. SEO analysis. 60+ tools.
mcpmodel-context-protocolwordpresswpwordpress-apiwordpress-rest-apiwordpress-pluginwordpress-developmentwordpress-editingwordpress-mcp-server
0/weekUpdated 1 months agoMITUnpacked: 462.0 KB
Published by Respira
Respira WordPress MCP Server
The only WordPress MCP with page builder support.
Edit Divi, Elementor, Bricks & 7 more builders with Cursor, Claude Code & Windsurf.
Website •
Documentation •
Download Plugin •
Support
---
Why Respira?
Other WordPress MCP servers use basic REST API calls. They can create posts and pages, but they can't touch your page builder content.
Respira includes a WordPress plugin that gives AI deep access to your page builders:
| Feature | Respira | Other MCP Servers |
|---------|---------|-------------------|
| Page Builder Support | 10 builders | None |
| Edit Divi modules | 200+ module types | - |
| Edit Elementor widgets | Full support | - |
| Edit Bricks elements | Full support | - |
| Module-level updates | By path or label | - |
| Safety Features | | |
| Duplicate-before-edit | Yes | No |
| Live page protection | Yes | No |
| Approval workflow | Yes | No |
| Analysis Tools | | |
| SEO Analysis | Yes | No |
| Core Web Vitals | Yes | No |
| AEO (AI Search Optimization) | Yes | No |
| Readability scoring | Yes | No |
| Multilingual | | |
| WPML support | Yes | No |
| Menu translations | Yes | No |
$3
- Divi - All 200+ modules with nested content
- Elementor - Widgets, sections, containers
- Bricks - Elements and nestable layouts
- Oxygen - Components and dynamic data
- Gutenberg - Core blocks
- Beaver Builder - Modules and rows
- WPBakery - Elements and templates
- Visual Composer - Elements and layouts
- Brizy - Blocks and elements
- Thrive Architect - Elements and templates
---
Quick Start (3 Minutes)
$3
1. Download from respira.press/releases
2. Upload to WordPress: Plugins > Add New > Upload Plugin
3. Activate and go to Respira > API Keys
4. Generate your API key (starts with respira_)
$3
Cursor
Create .cursor/mcp.json in your project:
``json`
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
Claude Code
Add to ~/.claude.json:`json`
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
Windsurf
Add to your Windsurf MCP configuration:
`json`
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):`json`
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}
$3
Create ~/.respira/config.json:`json`
{
"sites": [
{
"id": "my-site",
"name": "My WordPress Site",
"url": "https://yoursite.com",
"apiKey": "respira_your-api-key",
"default": true
}
]
}
Done! Restart your AI tool and start editing.
---
Safe Editing (Unique to Respira)
Unlike other MCP servers that edit live pages directly, Respira:
1. Creates a duplicate before any edit
2. Preserves the original untouched
3. Lets you preview changes before going live
4. Approve in WordPress when ready
Your live site is never at risk.
---
60+ Tools
$3
| Tool | What it does |
|------|-------------|
| wordpress_get_builder_info
| Get all available modules/widgets for the active builder |
| wordpress_extract_builder_content | Extract structured builder content from any page |
| wordpress_inject_builder_content | Replace entire page content with new builder data |
| wordpress_update_module | Update ONE specific module by path or label |$3
| Tool | What it does |
|------|-------------|
| wordpress_list_pages | List all pages with builder detection |
| wordpress_read_page | Get page with full structured content |
| wordpress_update_page | Update page (creates safe duplicate first) |
| wordpress_create_page_duplicate | Manually create working copy |$3
| Tool | What it does |
|------|-------------|
| wordpress_list_menus | List all navigation menus |
| wordpress_get_menu | Get menu with all items & hierarchy |
| wordpress_create_menu | Create new navigation menu |
| wordpress_create_menu_item | Add item to any menu |
| wordpress_assign_menu_location | Assign menu to theme location |$3
| Tool | What it does |
|------|-------------|
| wordpress_analyze_seo | Full SEO audit with actionable recommendations |
| wordpress_analyze_performance | Page speed & optimization suggestions |
| wordpress_get_core_web_vitals | LCP, FID, CLS scores |
| wordpress_analyze_aeo | AI search engine optimization check |
| wordpress_analyze_readability | Flesch score, sentence analysis |$3
Full CRUD operations for all WordPress content types.
---
Multi-Site Support
Manage multiple WordPress sites from one config:
`json
{
"sites": [
{
"id": "production",
"name": "Production Site",
"url": "https://mysite.com",
"apiKey": "respira_prod_key",
"default": true
},
{
"id": "staging",
"name": "Staging Site",
"url": "https://staging.mysite.com",
"apiKey": "respira_staging_key"
}
]
}
`Switch sites with
.---
WPML Multilingual Support
Full support for multilingual WordPress sites:
- Detect content language automatically
- Access all translations
- Menu translations with language codes
- Language-aware content queries
---
Troubleshooting
$3
Option 1: Use full path to npx:
`json
{
"command": "C:\\Program Files\\nodejs\\npx.cmd",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
`Option 2: Install globally first:
bash
npm install -g @respira/wordpress-mcp-server
`Then use:
json
{
"command": "respira-wordpress-mcp"
}
`$3
1. Check your API key in WordPress > Respira > API Keys
2. Verify your site URL includes
3. Make sure the Respira plugin is activated
4. Check if your hosting blocks REST API requests$3
1. Restart your AI tool completely (quit and reopen)
2. Verify config file JSON syntax (use a JSON validator)
3. Check the config file is in the correct location
4. Make sure you saved the file after editing
$3
1. The page ID might be wrong - use
first
2. Check if the page is in trash
3. Verify your API key has access to that page---
Installation Options
$3
`bash
npx -y @respira/wordpress-mcp-server
`$3
bash
npx -y @smithery/cli install @respira/wordpress-mcp-server --client claude
`$3
bash
npx @respira/wordpress-mcp-server --setup
`This wizard will:
- Guide you through configuration step by step
- Validate your WordPress URL and API key
- Test your connection before saving
- Generate the config file automatically
- Show you what to add to your AI tool
$3
bash
npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp
`$3
bash
npx @respira/wordpress-mcp-server --setup # Run setup wizard
npx @respira/wordpress-mcp-server --list # List configured sites
npx @respira/wordpress-mcp-server --test # Test default site connection
npx @respira/wordpress-mcp-server --help # Show help
`$3
bash
export WP_SITE_URL=https://your-site.com
export WP_API_KEY=respira_your-api-key
``---
Links
- Website
- Documentation
- Download Plugin
- Support
---
License
MIT © Respira
---
The only WordPress MCP with page builder support.
Built for WordPress developers who use AI.