
WSP WordPress MCP
โ 17from bilalnaseer
Free WordPress MCP For Connecting AI Coding Agents
WSP WordPress MCP โ Connect AI Agents to WordPress
By WebSensePro โ Official Shopify Partner & WordPress Agency
๐ฌ Watch the Tutorial
โจ What's New in v2.3.0
- ๐งฉ Advanced Custom Fields Suite โ 27 new tools for ACF: field groups, fields, field values with dot-notation deep access (e.g.
repeater.0.subfield), custom post types, taxonomies, and options pages. All off by default and only registered when ACF is active; structural changes (create/update/delete groups, fields, CPTs, taxonomies) requiremanage_options, with per-object capability checks on every value read/write. - ๐ท๏ธ Plugin slug renamed to
wsp-mcp-ai-agents-connectorto match the public name ahead of WordPress.org submission. โ ๏ธ Breaking on existing installs โ WordPress treats the renamed folder as a separate plugin, so remove the oldwebsensepro-mcp-abilitiescopy and activate the new one. Saved settings, the sessions table, and the API key are preserved (no reconfiguration needed).
โจ What's New in v2.2.0
- ๐งน Native-Only โ the legacy dual-mode Abilities-API / MCP-Adapter registration path and the MCP > Config Files page have been removed. The built-in native server is now the single transport.
- ๐ Seamless Redirects โ old bookmarks to the Config Files page now redirect to MCP > Connection.
- โ ๏ธ Breaking โ connections made before v2.0 through the WordPress MCP Adapter must be re-created using the native endpoint on MCP > Connection. New installs and native connections are unaffected.
Previous Releases
v2.1.0 โ ๐ WooCommerce Suite โ 15 new tools covering products (list, get, create, create variation, update), orders (list, update status, refund), coupons (create, list), order notes, customers, sales reports, low-stock alerts, and review moderation. All off by default and only registered when WooCommerce is active; financial/PII tools require the manage_woocommerce capability.
v2.0.0
- ๐ Built-in Native MCP Server โ the plugin ships its own MCP server at
/wp-json/wsp-mcp/v1/mcp. No companion plugin, WordPress MCP Adapter, or Node.js bridge required. - ๐ MCP > Connection Page โ endpoint URL, API key (with one-click regenerate), and ready-to-paste config tabs for Claude Desktop, Cursor, Codex, Antigravity, and OpenClaw โ the API key is pre-filled for you.
- ๐ Flexible Auth โ connect with a WordPress Application Password or the plugin's API key (
Authorization: Bearer), with per-tool capability enforcement. - ๐๏ธ Cleaner Settings โ ability groups are now collapsible accordions with live enabled/total counts.
v1.3.0 โ ๐ Yoast SEO abilities (read/update SEO title, meta description, focus keyphrase); group only appears when Yoast is active.
v1.2.1 โ Add OpenClaw tab to Config Files page
v1.2.0
- โก Elementor Abilities โ list pages, get page structure, find/get/update elements, add widgets & containers, remove elements
- ๐๏ธ Modular Plugin Architecture โ refactored into
includes/with separate files per feature group - ๐ง Auto Config Generator โ generates ready-to-paste configs for Claude Desktop & Codex from wp-admin
- ๐ Granular Ability Controls โ enable/disable each ability individually; Elementor group only shown when Elementor is active
- ๐ฆ WP.org Ready โ proper headers, license,
uninstall.php, and PHP 7.2+ support
๐ ๏ธ Available Abilities
Core WordPress
| Ability | Access |
|---|---|
| Read / Create / Update / Delete Posts | read / write |
| Read / Create / Update / Delete Pages | read / write |
| Read Categories & Tags / Create | read / write |
| Read / Approve / Delete Comments | read / write |
| Read Media Library | read |
| Read Users | read |
| Search Content | read |
| Read Site Info & Active Plugins | read |
Yoast SEO (requires Yoast SEO plugin)
| Ability | Access |
|---|---|
| Get Yoast SEO Meta (title, meta description, focus keyphrase) | read |
| Update Yoast SEO Meta | write |
Elementor (requires Elementor plugin)
| Ability | Access |
|---|---|
| List Elementor Pages | read |
| Get Page Structure (element tree) | read |
| Get Element Settings | read |
| Find Element by type or content | read |
| List Templates | read |
| Update Element settings | write |
| Add Widget to page | write |
| Add Container / Section | write |
| Remove Element | write |
WooCommerce (requires WooCommerce plugin)
| Ability | Access |
|---|---|
| List / Get Products | read |
| Create Product / Create Variation | write |
| Update Product | write |
| List Orders / Update Order Status | read / write |
Refund Order (requires manage_woocommerce) | write |
Create / List Coupons (requires manage_woocommerce) | write / read |
| Create Order Note | write |
List Customers (requires manage_woocommerce) | read |
| Sales Report | read |
| Low-Stock Alerts | read |
| Moderate Product Reviews | write |
Advanced Custom Fields (requires ACF plugin)
| Ability | Access |
|---|---|
| List / Get Field Groups | read |
| Create / Update / Delete Field Group | write |
| Import Field Groups (JSON) | write |
| List / Get Fields | read |
| Create / Update / Delete / Duplicate Field | write |
| Force Sync Fields | write |
| Get / Get-All / Get Field Object (values) | read |
| Update Deep / Bulk Update / Delete Value | write |
| List Post Types / Taxonomies | read |
| Create Custom Post Type / Taxonomy (ACF 6.1+) | write |
| List / Create Options Page (create needs ACF Pro) | read / write |
| Get / Update Option Value | read / write |
Value reads/writes accept a target of a post/page ID,
user_<id>,term_<id>, oroptions, and enforce per-object capabilities (e.g.edit_post,edit_user,manage_categories,manage_options). Structural changes requiremanage_options.
๐ข About WebSensePro
Built by WebSensePro โ WordPress & Shopify agency from Queens, NY.
- ๐ Official Shopify Partner
- ๐ฅ 140K+ YouTube Subscribers
- ๐ค Official n8n Creator
- ๐ง info@websensepro.com
๐ Quick Start
Prerequisites: WordPress 6.2+, PHP 7.4+ โ that's it. No companion plugin, no MCP Adapter, no Node.js for natively-supported clients (Cursor, Codex, Antigravity). Claude Desktop & OpenClaw use the mcp-remote bridge, which needs Node.js 18+.
- Install & activate this plugin
- Go to MCP > Settings in wp-admin and enable the abilities you need
- Go to MCP > Connection and pick your client tab (Claude Desktop, Cursor, Codex, Antigravity, or OpenClaw)
- Copy the snippet โ the endpoint URL and API key are already filled in โ and paste it into your client's config
- Reconnect / restart the client and start prompting your AI agent
Upgrading from before v2.0? As of v2.2 the legacy MCP-Adapter / Abilities-API path and the MCP > Config Files page have been removed. Re-create your connection using the native endpoint on MCP > Connection.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under GPL-2.0โ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ