@noleemits/vision-builder-mcp

MCP Server for Noleemits Vision Builder - 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:

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

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

Noleemits Vision Builder MCP