Nxt WP-MCP

WordPress plugin implementing WebMCP (Web Model Context Protocol) — allows AI agents running in the browser to interact with your WordPress site through document.modelContext.registerTool() browser-native MCP tools.

What is WebMCP?

WebMCP is a W3C Community Group specification that brings MCP (Model Context Protocol) to the browser. It allows web pages to register JavaScript-based tools that AI agents can invoke — all running client-side with the visitor's own context. Tools are registered via document.modelContext.registerTool() and can interact with the WordPress REST API, page DOM, and other browser APIs.

Spec: https://webmachinelearning.github.io/webmcp/
Chrome docs: https://developer.chrome.com/docs/ai/webmcp

Related MCP server: WP-MCP

How It Works

1. Install the plugin on any WordPress site

2. Visitors with a WebMCP-enabled browser (Chrome origin trial, Claude desktop, ChatGPT browser) can engage with the site via AI agents

3. The plugin registers MCP tools that let agents:

   • Read and search your posts, pages, and media

   • Get complete site structure and navigation

   • (Optionally) create, edit, or delete content

   • Access user data, taxonomies, comments

4. Agents can navigate between posts/pages using permalinks

5. Agents can engage by creating comments or (if enabled) editing content

Features

• 23+ MCP tools covering posts, pages, media, taxonomies, users, comments, categories, tags, site info, navigation, and search

• Permission-gated: each capability (create, edit, delete, users) can be toggled independently

• WordPress-native: uses the WordPress REST API v2 with nonce authentication

• Gutenberg block: add the WebMCP Visitor Widget to any page

• Responsive UI: floating chat container with dark/light mode support

• WP-CLI support: manage settings from the command line

• Origin isolation: automatically sends COOP/COEP headers required by WebMCP

Installation

From GitHub

# Clone and build the plugin
git clone https://github.com/pbmagnet4/nxt-wp-mcp.git
cd nxt-wp-mcp

# Install JS dependencies and build assets
npm install && npm run build

# Zip for WordPress upload
npm run zip

WordPress Upload

1. Download nxt-wp-mcp.zip

2. Go to Plugins → Add New → Upload Plugin in WordPress

3. Upload and activate

4. Go to Settings → WebMCP to configure permissions and UI

5. Add the "WebMCP Visitor Widget" block to any page, or enable the global widget

Tools Available (23+)

Configuration

Visit Settings → WebMCP to configure:

• Enable/Disable the plugin globally

• Permission toggles for each capability (create, edit, delete, users, tax, comments, plugins, themes, settings)

• Widget UI settings (position, width, collapsibility, default open state)

• Content limits (max posts, pages, media exposed)

WP-CLI Commands

wp webmcp status              # Show plugin status and settings
wp webmcp enable              # Enable the plugin
wp webmcp disable             # Disable the plugin
wp webmcp set allow_create 1  # Enable post creation
wp webmcp set allow_users 0   # Disable user access

Development

# Install dependencies
npm install

# Build assets
npm run build

# Watch mode for development
npm run dev

Build output

• dist/webmcp.js — frontend tool registration and chat widget

• dist/blocks.js — Gutenberg block editor script

• dist/manifest.php — PHP asset manifest for cache-busting

Requirements

• WordPress 6.5+

• PHP 8.1+

• HTTPS recommended (WebMCP requires SecureContext)

• Chrome 149+ or origin trial support for document.modelContext

License

GPLv2 or later — see LICENSE.