# @noleemits/vision-builder-mcp

MCP Server for [Noleemits Vision Builder](https://noleemits.com) - Connect Claude Desktop to your WordPress + Elementor site.

## What it does

This MCP server gives Claude Desktop the ability to:

- **Elementor**: Create pages, add sections (hero, features, pricing, FAQ, etc.), manage style presets
- **Content Editing**: Search posts, read/update content, find & replace text, manage links
- **SEO (Rank Math)**: Read/update SEO titles, descriptions, focus keywords, Open Graph data

## Prerequisites

- **Node.js 18+** installed on your machine
- **Noleemits Vision Builder** plugin installed on your WordPress site
- A **WordPress Application Password** for authentication

## Quick Setup

### 1. Generate an Application Password

In your WordPress admin, go to **Vision Builder > Settings > MCP Config** and click **Generate Connection**.

Or manually: **Users > Profile > Application Passwords** > enter "Claude Desktop" > click **Add New**.

### 2. Add to Claude Desktop config

Open Claude Desktop > Settings > Developer > Edit Config, then add:

```json
{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "@noleemits/vision-builder-mcp"],
      "env": {
        "WP_URL": "https://your-site.com",
        "WP_USER": "your-username",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}
```

Replace the values with your actual WordPress site URL, username, and application password.

### 3. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see the MCP tools icon in the chat input.

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `WP_URL` | Yes | Your WordPress site URL (e.g., `https://example.com`) |
| `WP_USER` | Yes | WordPress username |
| `WP_APP_PASSWORD` | Yes | WordPress Application Password |

## Available Tools (40+)

### Page Management
- `create_page` - Create a new Elementor page
- `get_pages` / `get_page` / `delete_page`

### Style Presets
- `list_style_presets` / `apply_style_preset` / `detect_style_preset` / `get_style_settings`

### Section Generation
- `add_hero` - Multiple layouts (centered, split, asymmetric, overlap)
- `add_features` - Grid, bento, or magazine layout
- `add_testimonial` / `add_cta` / `add_faq` / `add_pricing` / `add_team` / `add_contact` / `add_gallery`

### Content Editing (Gutenberg)
- `search_content` / `get_post_content` / `update_post`
- `find_links` / `update_link` / `find_and_replace`

### SEO (Rank Math)
- `get_seo_data` / `update_seo_data` / `get_seo_status`

### Utilities
- `health_check` / `preview_page`

## Multiple Sites

Use a unique key name for each site:

```json
{
  "mcpServers": {
    "site-one": {
      "command": "npx",
      "args": ["-y", "@noleemits/vision-builder-mcp"],
      "env": {
        "WP_URL": "https://site-one.com",
        "WP_USER": "admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx"
      }
    },
    "site-two": {
      "command": "npx",
      "args": ["-y", "@noleemits/vision-builder-mcp"],
      "env": {
        "WP_URL": "https://site-two.com",
        "WP_USER": "editor",
        "WP_APP_PASSWORD": "yyyy yyyy yyyy yyyy"
      }
    }
  }
}
```

## Troubleshooting

**503 errors**: Whitelist `/wp-json/nvb/` in your firewall/security plugin.

**"Application passwords not available"**: Requires HTTPS or localhost.

**Test the connection**: Visit `https://your-site.com/wp-json/nvb/v1/health` in your browser.

## License

GPL-2.0-or-later