cosmincraciun97/stonewright-wp-mcp
View on GitHub ↗Guarded, recoverable WordPress MCP automation for Elementor, Gutenberg, WooCommerce, content, and code - with backups, validation, and audit trails.
15 ★0 forksPHPUpdated 23d ago
What you need to know
Stonewright — guarded, recoverable WordPress and Elementor automation for AI agents: it proves what changed (snapshots, typed readback, audit evidence) and gives a way back (restore path), exposing 361 Plugin-mode abilities or 101 pluginless Direct tools with an inspect -> plan -> approve -> back up -> write -> verify -> audit cycle.
Install
Download the current plugin ZIP (1.0.0-beta.10 Public Beta) and install via Plugins -> Add New -> Upload Plugin (docs/installation.md). Open Stonewright -> Setup, enable the site, and connect the client via guided OAuth or Application Password flow. Fully restart the client and run the generated connection verification — a saved/parseable config alone is not runtime proof. Direct mode (no plugin): create a WP Application Password and register with npx stonewright connect add --mode direct-only.
Usage
- •Confirm stonewright-task-start is visible and call it first with the real task; use the bounded 'essential' profile for normal work (bootstrap is startup diagnostics only).
- •Repair an Elementor page: read the live control schema, plan one surgical batch, snapshot the document, write once, verify, then complete the browser recipe.
- •Change custom code: discover the provider, dry-run the exact target, stop for human approval, apply approved bytes, read back, retain rollback evidence.
- •MCP surface modes (bootstrap / essential-static / essential / full) control how many abilities appear to clients; Elementor multi-step edits use a transaction envelope.
Key features
- ✓361 Plugin abilities (94 Elementor widget compat, 33 Elementor V3, 14 V4, design, Gutenberg/FSE, WP-CLI, WooCommerce, custom-code providers) and 101 Direct tools with a generated ability-truth matrix.
- ✓Gates selected by typed ability/mode/surface/risk: custom code stops for human approval, supported writes snapshot before mutation, destructive production-safe ops need a scoped confirmation token.
- ✓Durable audit, OAuth, write-receipt, and diagnostics contracts; incidents produce ranked actions and lessons.
- ✓Safety: staging + normal infrastructure backups recommended; plugin AGPL-3.0-or-later, companion MIT; PHP >=8.1, WordPress >=6.7.
Best for
Teams that need AI agents to edit WordPress/Elementor with an evidence trail — proof of change and a restore path — instead of an unguarded API bridge.
Caveats
- ⚠Current release is 1.0.0-beta.10 Public Beta; does not promise automation cannot fail, just concrete controls around supported changes.
- ⚠Direct mode does not write custom PHP/CSS/JS/HTML (no authenticated wp-admin grant boundary).
- ⚠Companion CLI is distributed via GitHub Releases (tgz), not the npm registry — commands reference vVERSION.
- ⚠Busy surface: enable only the tool profile you need; OAuth remote HTTP is a separate connection to /wp-json/mcp/stonewright-oauth.
Platforms: Local
Reviewed 2026-08-18
Topics
ai-agentselementorgutenbergmcpmcp-servermodel-context-protocolwoocommercewordpresswordpress-pluginwp-cli
- Stars
- 15★
- Forks
- 0
- Language
- PHP
- License
- AGPL-3.0
- Created
- 2026-05-22
- Last push
- 2026-08-12