@respira/wordpress-mcp-server 2.0.6 → 2.0.7

package/README.md

@@ -8,81 +8,90 @@
 
 <p align="center">
   <strong>The only WordPress MCP with page builder support.</strong><br>
-  Edit Divi, Elementor, Bricks + 7 more builders with AI. Duplicate-before-edit safety. SEO analysis. 60+ tools.
+  Edit Divi, Elementor, Bricks & 7 more builders with Cursor, Claude Code & Windsurf.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@respira/wordpress-mcp-server"><img src="https://img.shields.io/npm/v/@respira/wordpress-mcp-server.svg?style=flat-square&color=blue" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/@respira/wordpress-mcp-server"><img src="https://img.shields.io/npm/dm/@respira/wordpress-mcp-server.svg?style=flat-square" alt="npm downloads"></a>
-  <a href="https://github.com/webmyc/respira-wordpress"><img src="https://img.shields.io/github/stars/webmyc/respira-wordpress?style=flat-square" alt="GitHub stars"></a>
-  <a href="https://respira.press"><img src="https://img.shields.io/badge/website-respira.press-purple?style=flat-square" alt="Website"></a>
+  <img src="https://img.shields.io/badge/page%20builders-10-green?style=flat-square" alt="10 Page Builders">
+  <img src="https://img.shields.io/badge/tools-60%2B-purple?style=flat-square" alt="60+ Tools">
+  <img src="https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
+  <a href="https://respira.press"><img src="https://img.shields.io/badge/website-respira.press-orange?style=flat-square" alt="Website"></a>
 </p>
 
 <p align="center">
   <a href="https://respira.press">Website</a> •
-  <a href="https://respira.press/docs">Documentation</a> •
-  <a href="https://respira.press/support">Support</a> •
-  <a href="https://github.com/webmyc/respira-wordpress">GitHub</a>
+  <a href="https://respira.press/documentation">Documentation</a> •
+  <a href="https://respira.press/releases">Download Plugin</a> •
+  <a href="https://respira.press/support">Support</a>
 </p>
 
 ---
 
 ## Why Respira?
 
-Most WordPress MCP servers only work with Gutenberg. **Respira is the only MCP that supports real page builders** — the tools that power 50%+ of WordPress sites.
+**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 |
+
+### Supported Page Builders
 
-### Feature Comparison
-
-| Feature | Respira | mcp-wordpress | wordpress-mcp |
-|---------|---------|---------------|---------------|
-| **Divi Builder** (200+ modules) | ✅ | ❌ | ❌ |
-| **Elementor** (widgets, templates) | ✅ | ❌ | ❌ |
-| **Bricks Builder** | ✅ | ❌ | ❌ |
-| **Oxygen Builder** | ✅ | ❌ | ❌ |
-| **WPBakery / Visual Composer** | ✅ | ❌ | ❌ |
-| **Beaver Builder** | ✅ | ❌ | ❌ |
-| **Thrive Architect** | ✅ | ❌ | ❌ |
-| **Brizy** | ✅ | ❌ | ❌ |
-| Gutenberg (Block Editor) | ✅ | ✅ | ✅ |
-| Duplicate-before-edit safety | ✅ | ❌ | ❌ |
-| SEO analysis tools | ✅ | ❌ | ❌ |
-| Performance / Core Web Vitals | ✅ | ❌ | ❌ |
-| AI Engine Optimization (AEO) | ✅ | ❌ | ❌ |
-| Menu management (full CRUD) | ✅ | ❌ | Limited |
-| Media upload & management | ✅ | ✅ | ✅ |
-| WPML multilingual support | ✅ | ❌ | ❌ |
-| Multi-site switching | ✅ | ❌ | ❌ |
-| Plugin management | ✅ | ❌ | ❌ |
-| **Total tools** | **60+** | ~15 | ~20 |
-
-### What Makes Respira Different
-
-1. **Page Builder Intelligence** — AI understands Divi sections, Elementor widgets, Bricks elements. Not just raw HTML.
-
-2. **Duplicate-Before-Edit Safety** — Respira creates a duplicate before editing any live page. Review changes in WordPress admin before they go live. Your production site is never touched until you approve.
-
-3. **SEO & Performance Analysis** — Built-in tools for comprehensive SEO audits, Core Web Vitals, and AI Engine Optimization (AEO) for ChatGPT/Perplexity visibility.
+<p align="center">
+  <img src="https://img.shields.io/badge/Divi-200%2B%20modules-purple?style=for-the-badge" alt="Divi">
+  <img src="https://img.shields.io/badge/Elementor-Full%20Support-92003B?style=for-the-badge" alt="Elementor">
+  <img src="https://img.shields.io/badge/Bricks-Full%20Support-orange?style=for-the-badge" alt="Bricks">
+  <img src="https://img.shields.io/badge/Oxygen-Full%20Support-00D084?style=for-the-badge" alt="Oxygen">
+</p>
 
-4. **Module-Level Precision** — Update a specific Divi module or Elementor widget by its admin label or path, without touching the rest of the page.
+- **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 (2 Minutes)
+## Quick Start (3 Minutes)
 
-### Step 1: Install the WordPress Plugin
+### Step 1: Install WordPress Plugin
 
-1. Download from [respira.press](https://respira.press)
-2. Upload to WordPress: **Plugins → Add New → Upload Plugin**
-3. Activate and go to **Respira → API Keys**
+1. Download from [respira.press/releases](https://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_`)
 
-### Step 2: Configure Your AI Assistant
+### Step 2: Configure Your AI Tool
 
 <details>
 <summary><b>Cursor</b></summary>
 
-Create or edit `.cursor/mcp.json` in your project:
-
+Create `.cursor/mcp.json` in your project:
 ```json
 {
   "mcpServers": {
@@ -99,8 +108,7 @@ Create or edit `.cursor/mcp.json` in your project:
 <details>
 <summary><b>Claude Code</b></summary>
 
-Add to your Claude Code config (`~/.claude.json` or project settings):
-
+Add to `~/.claude.json`:
 ```json
 {
   "mcpServers": {
@@ -118,7 +126,6 @@ Add to your Claude Code config (`~/.claude.json` or project settings):
 <summary><b>Windsurf</b></summary>
 
 Add to your Windsurf MCP configuration:
-
 ```json
 {
   "mcpServers": {
@@ -136,7 +143,6 @@ Add to your Windsurf MCP configuration:
 <summary><b>Claude Desktop</b></summary>
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
-
 ```json
 {
   "mcpServers": {
@@ -150,10 +156,9 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 </details>
 
-### Step 3: Create Config File
+### Step 3: Add Your Site
 
 Create `~/.respira/config.json`:
-
 ```json
 {
   "sites": [
@@ -161,157 +166,77 @@ Create `~/.respira/config.json`:
       "id": "my-site",
       "name": "My WordPress Site",
       "url": "https://yoursite.com",
-      "apiKey": "respira_your-api-key-here",
+      "apiKey": "respira_your-api-key",
       "default": true
     }
   ]
 }
 ```
 
-**That's it!** Restart your AI assistant and start editing.
+**Done!** Restart your AI tool and start editing.
 
 ---
 
-## Page Builder Support
-
-### Divi Builder
-- 200+ module types supported
-- Section, row, and module-level editing
-- Update by admin label: `"Find the module labeled 'Hero CTA' and change the button text"`
-- Preserves all Divi styling and settings
-
-### Elementor
-- Widget-level precision editing
-- Template and section support
-- CSS cache regeneration after updates
-- Compatible with Elementor Pro
-
-### Other Builders
-- **Bricks** — Elements and containers
-- **Oxygen** — Components and templates
-- **WPBakery** — Shortcode-based editing
-- **Beaver Builder** — Modules and rows
-- **Thrive Architect** — Elements and templates
-- **Brizy** — Blocks and elements
-- **Visual Composer** — Elements and grids
+## Safe Editing (Unique to Respira)
 
----
+Unlike other MCP servers that edit live pages directly, Respira:
 
-## Safe Editing Workflow
+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
 
-Respira never edits your live pages directly:
-
-1. AI requests a page update
-2. Respira **creates a duplicate** of the page
-3. AI edits the duplicate
-4. You **review changes** in WordPress admin
-5. One-click to approve and replace the original
-
-Go to **Respira → Approve Edits** to review pending changes.
+Your live site is never at risk.
 
 ---
 
-## Available Tools (60+)
+## 60+ Tools
 
-### Content Management
-| Tool | Description |
+### Page Builder Tools
+| Tool | What it does |
 |------|-------------|
-| `wordpress_list_pages` | List all pages |
-| `wordpress_read_page` | Get page content with builder data |
-| `wordpress_update_page` | Update page (auto-creates duplicate) |
-| `wordpress_create_page_duplicate` | Manually create safe duplicate |
-| `wordpress_list_posts` | List all posts |
-| `wordpress_read_post` | Get post content |
-| `wordpress_update_post` | Update post content |
-
-### Page Builders
-| Tool | Description |
-|------|-------------|
-| `wordpress_get_builder_info` | Get available modules/widgets for detected builder |
-| `wordpress_extract_builder_content` | Extract structured content (sections, rows, modules) |
-| `wordpress_inject_builder_content` | Inject structured builder content |
-| `wordpress_update_module` | Update specific module by admin_label or path |
+| `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 |
 
-### Media Management
-| Tool | Description |
+### Content Management
+| Tool | What it does |
 |------|-------------|
-| `wordpress_list_media` | List all media files |
-| `wordpress_upload_media` | Upload images, videos, documents |
-| `wordpress_update_media` | Update alt text, title, caption |
-| `wordpress_delete_media` | Delete media files |
+| `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 |
 
 ### Menu Management
-| Tool | Description |
+| Tool | What it does |
 |------|-------------|
 | `wordpress_list_menus` | List all navigation menus |
-| `wordpress_get_menu` | Get menu with all items |
-| `wordpress_create_menu` | Create new menu |
-| `wordpress_update_menu` | Update menu structure |
-| `wordpress_list_menu_locations` | List theme menu locations |
-| `wordpress_assign_menu_location` | Assign menu to location |
-| `wordpress_create_menu_item` | Add menu item |
-| `wordpress_update_menu_item` | Update menu item |
-
-### SEO & Performance
-| Tool | Description |
+| `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 |
+
+### Analysis Tools
+| Tool | What it does |
 |------|-------------|
-| `wordpress_analyze_seo` | Comprehensive SEO analysis with recommendations |
-| `wordpress_check_seo_issues` | Quick SEO issue checker |
-| `wordpress_analyze_performance` | Performance metrics and bottlenecks |
+| `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 (ChatGPT, Perplexity) |
-| `wordpress_check_structured_data` | Schema markup validation |
-| `wordpress_analyze_images` | Image optimization opportunities |
-| `wordpress_analyze_readability` | Content readability scores |
+| `wordpress_analyze_aeo` | AI search engine optimization check |
+| `wordpress_analyze_readability` | Flesch score, sentence analysis |
 
-### Users & Comments
-| Tool | Description |
-|------|-------------|
-| `wordpress_list_users` | List all users |
-| `wordpress_create_user` | Create new user |
-| `wordpress_update_user` | Update user details |
-| `wordpress_list_comments` | List comments |
-| `wordpress_create_comment` | Create comment |
-| `wordpress_update_comment` | Update/moderate comment |
-
-### Taxonomies & Terms
-| Tool | Description |
-|------|-------------|
-| `wordpress_list_taxonomies` | List all taxonomies |
-| `wordpress_list_terms` | List terms in taxonomy |
-| `wordpress_create_term` | Create category/tag/term |
-| `wordpress_update_term` | Update term |
+### Media, Users, Taxonomies, Plugins
 
-### Custom Post Types
-| Tool | Description |
-|------|-------------|
-| `wordpress_list_post_types` | List registered CPTs |
-| `wordpress_list_custom_posts` | List CPT entries |
-| `wordpress_create_custom_post` | Create CPT entry |
-| `wordpress_update_custom_post` | Update CPT entry |
+Full CRUD operations for all WordPress content types.
 
-### Plugin Management (Experimental)
-| Tool | Description |
-|------|-------------|
-| `wordpress_list_plugins` | List installed plugins |
-| `wordpress_install_plugin` | Install from WordPress.org |
-| `wordpress_activate_plugin` | Activate plugin |
-| `wordpress_deactivate_plugin` | Deactivate plugin |
-| `wordpress_update_plugin` | Update to latest version |
-
-### Site Context
-| Tool | Description |
-|------|-------------|
-| `wordpress_get_site_context` | Get site info, theme, plugins, builders |
-| `wordpress_get_theme_docs` | Get theme documentation |
-| `wordpress_switch_site` | Switch to different site (multi-site) |
+[Full Tool Reference](https://respira.press/documentation/tools)
 
 ---
 
 ## Multi-Site Support
 
 Manage multiple WordPress sites from one config:
-
 ```json
 {
   "sites": [
@@ -332,74 +257,93 @@ Manage multiple WordPress sites from one config:
 }
 ```
 
-Switch sites with: `wordpress_switch_site`
+Switch sites with `wordpress_switch_site`.
 
 ---
 
 ## WPML Multilingual Support
 
-Full support for WPML multilingual sites:
-- Menu translations
-- Page/post language detection
-- Translation links
+Full support for multilingual WordPress sites:
+- Detect content language automatically
+- Access all translations
+- Menu translations with language codes
 - Language-aware content queries
 
 ---
 
-## Windows Troubleshooting
+## Troubleshooting
 
-If you see `'npx' is not recognized`:
-
-### Option 1: Use Full Path (Recommended)
+### Windows: 'npx' not recognized
 
+**Option 1:** Use full path to npx:
 ```json
 {
-  "mcpServers": {
-    "respira-wordpress": {
-      "command": "C:\\Program Files\\nodejs\\npx.cmd",
-      "args": ["-y", "@respira/wordpress-mcp-server"]
-    }
-  }
+  "command": "C:\\Program Files\\nodejs\\npx.cmd",
+  "args": ["-y", "@respira/wordpress-mcp-server"]
 }
 ```
 
-### Option 2: Install Globally
-
+**Option 2:** Install globally first:
 ```bash
 npm install -g @respira/wordpress-mcp-server
 ```
 
 Then use:
-
 ```json
 {
-  "mcpServers": {
-    "respira-wordpress": {
-      "command": "respira-wordpress-mcp"
-    }
-  }
+  "command": "respira-wordpress-mcp"
 }
 ```
 
+### Connection Failed
+
+1. Check your API key in WordPress > Respira > API Keys
+2. Verify your site URL includes `https://`
+3. Make sure the Respira plugin is activated
+4. Check if your hosting blocks REST API requests
+
+### Tools Not Showing in AI Tool
+
+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
+
+### "Page not found" Errors
+
+1. The page ID might be wrong - use `wordpress_list_pages` first
+2. Check if the page is in trash
+3. Verify your API key has access to that page
+
 ---
 
-## Environment Variables
+## Installation Options
+
+### NPX (Recommended)
+```bash
+npx -y @respira/wordpress-mcp-server
+```
 
-Instead of config file, use `.env`:
+### Global Install
+```bash
+npm install -g @respira/wordpress-mcp-server
+respira-wordpress-mcp
+```
 
+### Environment Variables (Alternative to config file)
 ```bash
-WP_SITE_URL=https://your-site.com
-WP_API_KEY=respira_your-api-key
+export WP_SITE_URL=https://your-site.com
+export WP_API_KEY=respira_your-api-key
 ```
 
 ---
 
-## Need Help?
+## Links
 
-- [Documentation](https://respira.press/docs)
+- [Website](https://respira.press)
+- [Documentation](https://respira.press/documentation)
+- [Download Plugin](https://respira.press/releases)
 - [Support](https://respira.press/support)
-- [Report Issues](https://github.com/webmyc/respira-wordpress/issues)
-- [Contact](mailto:support@respira.press)
 
 ---
 
@@ -410,6 +354,6 @@ MIT © [Respira](https://respira.press)
 ---
 
 <p align="center">
-  <strong>Built for the WordPress community</strong><br>
-  <a href="https://respira.press">respira.press</a>
+  <strong>The only WordPress MCP with page builder support.</strong><br>
+  Built for WordPress developers who use AI.
 </p>

package/dist/server.js

@@ -14,7 +14,7 @@ export class RespiraWordPressServer {
     constructor(siteConfigs) {
         this.server = new Server({
             name: 'respira-wordpress',
-            version: '2.0.6',
+            version: '2.0.7',
         }, {
             capabilities: {
                 tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@respira/wordpress-mcp-server",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "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.",
   "main": "dist/index.js",
   "bin": {
@@ -85,11 +85,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/webmyc/respira-wordpress"
+    "url": "https://respira.press"
   },
   "homepage": "https://respira.press",
   "bugs": {
-    "url": "https://github.com/webmyc/respira-wordpress/issues"
+    "url": "https://respira.press/support"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.0",