What is WPVibe MCP?
WPVibe is an open source WordPress plugin that turns a self-hosted site into something an MCP client can manage. It pairs with a hosted WPVibe MCP service and offers REST content calls, sandboxed theme editing, 34 allowlisted WP-CLI commands and Abilities API access, under GPL-2.0-or-later.
WPVibe is a WordPress plugin built by Awesome Motive. It exposes WordPress operations as REST endpoints that an MCP gateway can call, so an AI assistant can manage content, theme files and plugins through conversation.
The repository holds only the WordPress side. The gateway that handles OAuth, routing and tool registration is a hosted service at wpvibe.ai and is closed source, so you need both pieces for the full setup.
What an agent can do with it
- Create, update and publish posts, pages and custom post types by calling any WordPress REST endpoint.
- Edit theme files inside a draft theme, check the preview, then publish, with a PHP syntax check on every saved file.
- Run 34 allowlisted WP-CLI commands through native PHP, with no wp-cli binary needed on the server.
- Discover and run abilities that other plugins register through the WordPress Abilities API on WordPress 6.9 and later.
- Pull images from a URL or Unsplash into the media library.
Who it is for
Best for
- Site owners who want conversational control of a self-hosted site without pasting between chat and wp-admin.
- Developers who want a reviewable draft, preview and publish loop for theme changes.
- Agencies who prefer OAuth over handing out application passwords.
Not for
- Teams that need the whole stack to be self-hosted. The gateway is a hosted, closed source service.
- Anyone who needs unrestricted shell or database access. Queries are limited to SELECT and commands to an allowlist.
Safeguards in the plugin
The README describes per-endpoint capability checks, path sandboxing for file writes, a default-deny WP-CLI list, and a rule that deleting posts moves them to trash. Credentials are encrypted with AES-256-GCM at rest.
Use it with UiChemy
WPVibe edits the site and its theme through conversation. For page design, WP Theme Development skill covers theme review, and UiChemy Composer writes HTML, CSS and JS for WordPress pages. Click Get Started on uichemy.com.
Connect WPVibe MCP: Connect an AI Agent to Your WordPress Site to your AI client
claude mcp add wpvibe https://mcp.wpvibe.ai/mcpInstall the plugin
Install WPVibe from the WordPress.org plugin directory (slug vibe-ai) or clone the repository into wp-content/plugins/vibe-ai/, then activate it.
Authorize the site
Open the WPVibe page in wp-admin and click the OAuth authorization link. No application password is typed into chat.
Add the server URL
Give your MCP client the WPVibe server URL. The README lists the Claude Code command shown above, plus settings panels for Claude Desktop, Cursor, Windsurf and ChatGPT connectors.
Start read first
Ask for site info or a list of installed plugins before you let the agent edit theme files or content.
Client configuration
{
"mcpServers": {
"wpvibe": {
"url": "https://mcp.wpvibe.ai/mcp"
}
}
}Endpoints and ports
https://mcp.wpvibe.ai/mcpHosted WPVibe gateway named in the README Quick startWordPress 6.0+, PHP 7.4+Tested up to WordPress 6.9; Abilities API needs 6.9What you can do with it
- Draft theme workflowChanges go into a draft theme with a preview URL, so a theme edit is reviewed before publish_draft_theme makes it live.
- PHP lint on saveEvery saved PHP file passes an in-process syntax check before it is written.
- Allowlisted WP-CLIOnly 34 listed commands run, dangerous flags are stripped and shell metacharacters are blocked.
- Abilities API bridgeAbilities registered by other plugins can be discovered and called on WordPress 6.9 and later.
- OAuth connectionAuthorization is a one-click OAuth step instead of application passwords in chat.
- Capability checksEach endpoint checks the matching WordPress capability, such as edit_themes or manage_options.
- Trash on deleteDeleting posts and pages moves them to trash rather than removing them permanently.
Tools it exposes
connect_site / site_info / list_sites / remove_site
Register a site and read its details.
rest_api
Call any WordPress REST endpoint with GET, POST, PUT or DELETE.
upload_media / search_images
Add media from a URL or an Unsplash search.
discover_abilities / get_ability_info / run_ability
List and run abilities registered through the Abilities API.
read_file / edit_file / write_file / delete_file / list_files / search_files / get_file_outline
Work with theme files inside the sandbox.
create_draft_theme / publish_draft_theme / delete_draft_theme / get_preview_url / create_classic_theme
Draft, preview and publish theme changes.
run_wp_cli
Run one of 34 allowlisted WP-CLI commands.
get_page_html / navigate
Read rendered page HTML.
load_skill
Load step-by-step instructions for common WordPress workflows.
Frequently asked questions
What is WPVibe MCP?
WPVibe is an open source WordPress plugin by Awesome Motive that exposes site operations as MCP tools. Together with the hosted WPVibe MCP service, it lets an MCP client such as Cursor, Windsurf or ChatGPT manage content, themes, media and WP-CLI tasks on a self-hosted site.
How do I install WPVibe?
Install the plugin from the WordPress.org directory under the slug vibe-ai, or clone the repository into wp-content/plugins/vibe-ai/. Activate it, click the OAuth authorization link on the WPVibe admin page, then add the WPVibe MCP server URL to your AI client.
Is the WPVibe MCP server open source?
Only the WordPress plugin is. It is GPL-2.0-or-later and lives in the repository. The hosted gateway that handles OAuth, routing and tool registration is a closed source service at wpvibe.ai, so the full setup is not self-contained.
Which AI clients does WPVibe work with?
The README names Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, OpenCode, Continue and Cody, plus any other MCP compatible client. It gives a setup route for each of the first five, such as a claude mcp add command for Claude Code.
Can WPVibe run WP-CLI commands on my server?
Yes, but only 34 explicitly allowlisted commands, run through native PHP so no wp-cli binary is required. Dangerous flags are removed and shell metacharacters are blocked. Plugin install and update use a two phase confirmation step.
Is it safe to let an AI edit my theme with WPVibe?
The README describes a draft, preview and publish flow, PHP syntax validation, path sandboxing to the active theme and an extension allowlist. It still changes a real site, so test on staging and keep backups before you publish a theme change.
Does WPVibe work with page builders like Elementor?
The README lists no page builder specific tools. It offers REST access, theme files, WP-CLI and abilities. For builder layouts, see MCP Abilities Elementor or Respira for WordPress, which target builders directly.
What does WPVibe require?
The README states WordPress 6.0 or later, tested up to 6.9, and PHP 7.4 or later with 8.x recommended. The Abilities API tools need WordPress 6.9. You also need a client that supports a remote MCP server URL.


