What is Stonewright?
Stonewright is a public beta WordPress MCP project made of a plugin with 397 abilities and a companion with 105 pluginless Direct tools. Elementor is its first-class surface, with Gutenberg, WooCommerce and WP-CLI beside it. Writes use permissions, snapshots, validation, readback, audit records and restore paths.
Stonewright describes itself as guarded, recoverable WordPress and Elementor automation for AI agents. It has a WordPress plugin, which the README calls Plugin mode, and a Node.js companion that also offers a pluginless Direct mode over core REST.
The README does not promise that automation cannot fail. It adds controls around supported changes: permissions, operating modes, confirmation tokens, pre-write snapshots, validation, typed readback, audit evidence and restore paths.
Plugin mode and Direct mode
| Plugin mode | Direct mode | |
|---|---|---|
| Size | 397 abilities | 105 tools |
| Needs the plugin | Yes | No, uses an application password |
| Elementor | Validated DesignSpec and V3 and V4 writers | Data get and update with file backup, no schema validation |
| WooCommerce | Catalogue writes, dry run first | Read only |
| Recovery | Snapshots, change history, rescue | Saved copies you can restore |
The safety model
- Inspect, plan or dry run, approve when required, back up, write, read back and verify.
- Custom code stops for human approval before anything is applied.
- Destructive operations in production-safe mode need a scoped confirmation token.
- Rescue checks that the site still loads after a risky write and rolls back if it does not.
Who it is for
Best for
- Agencies repairing Elementor pages who want a recorded before and after for each change.
- Teams that need staging, development and production-safe operating modes.
- Developers who want tokenized WP-CLI recipes beside Elementor and Gutenberg work.
Not for
- Anyone needing a stable, frozen API. The README calls this a public beta and says behaviour may change before 1.0.
- Quick one-off edits where a smaller server is enough, such as MCP Abilities Elementor.
Use it with UiChemy
Stonewright maintains an existing WordPress site. UiChemy produces the design side: Composer writes HTML, CSS and JS for Elementor or Gutenberg, and Figma to WordPress converts a Figma file into an editable page. Click Get Started on uichemy.com.
Connect Stonewright MCP: Guarded WordPress and Elementor Automation to your AI client
npx -y --package https://github.com/cosmincraciun97/stonewright-wp-mcp/releases/download/vVERSION/stonewright-companion-VERSION.tgz stonewright connect add --alias site-a --url https://site-a.example --username editor --env production --mode plugin-only --client codex-cliDownload the plugin
Get the current plugin ZIP from the latest release and install it under Plugins, Add New, Upload Plugin.
Run Setup
Open Stonewright, Setup, turn on AI abilities in Settings and connect your client through the guided OAuth or application password flow.
Restart and verify
Fully restart the client and run the generated connection check. The README says a parseable config is not runtime proof.
Call task start first
Confirm stonewright-task-start is visible and call it first with the real task. Use the essential profile for normal work.
Use staging
The README advises staging or local sites first, and independent backups for production.
Client configuration
{
"mcpServers": {
"stonewright": {
"command": "npx",
"args": ["-y", "--package", "https://github.com/cosmincraciun97/stonewright-wp-mcp/releases/download/vVERSION/stonewright-companion-VERSION.tgz", "stonewright-mcp"],
"env": {
"STONEWRIGHT_MODE": "direct",
"STONEWRIGHT_WP_URL": "http://your-local-site.local",
"STONEWRIGHT_WP_USERNAME": "admin",
"STONEWRIGHT_WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
"STONEWRIGHT_MCP_TOOL_PROFILE": "essential"
}
}
}
}Endpoints and ports
/wp-json/mcp/stonewrightPlugin and MCP adapter route./wp-json/mcp/stonewright-oauthRemote HTTP with OAuth.WordPress 6.7+, PHP 8.1+, Node.js 20+Elementor 3.21+ only when using Elementor abilities.STONEWRIGHT_WP_URL, STONEWRIGHT_WP_USERNAME, STONEWRIGHT_WP_APP_PASSWORDConfig example for pluginless Direct mode.What you can do with it
- Elementor firstPlugin mode has per-widget builders, V3 structure edits, batch mutations, kit globals and experimental V4 atomic nodes.
- Snapshots and readbackSupported Elementor and design writes take a snapshot first and are read back after the write.
- Change history with undoEach change keeps its content before and after, with a diff view and undo or redo, for 90 days by default.
- RescueA health probe after risky writes triggers an automatic rollback if the site stops loading.
- Gutenberg and block themesAbilities cover block parsing, insertion, query loops, theme.json, templates and patterns.
- Operating modesDevelopment, staging and production-safe modes control how strict the gates are.
- Tokenized WP-CLISaved recipes are planned, approved with a one-use hash and read back on every run.
- Pluginless Direct modeCore REST workflows work from the companion without installing the plugin.
Tools it exposes
stonewright-task-start
The first call of a task. Starts the session profile and returns the rules digest.
stonewright-site-discover
Reports endpoint and capability details for the site.
stonewright-elementor-data-get
Direct mode: reads a document's Elementor data.
stonewright-elementor-data-update
Direct mode: writes Elementor data with a file backup and readback.
stonewright-elementor-css-regenerate
Rebuilds generated CSS for the resolved post after an Elementor write.
stonewright-elementor-post-write-verify
Observation only check after an Elementor write.
stonewright-direct-backup-list
Lists saved copies made before Direct writes.
stonewright-direct-backup-restore
Restores a saved copy, hash checked and confirmed.
stonewright-change-history-list
Lists the recorded change history.
stonewright-change-rollback
Rolls a recorded change back. Code changes need an administrator in wp-admin.
stonewright-rules-get
Fetches the native operating rules, cached by digest.
Frequently asked questions
What is Stonewright MCP?
Stonewright is an open source WordPress MCP project with a plugin, offering 397 abilities, and a companion that also offers 105 Direct tools without the plugin. It focuses on Elementor, Gutenberg, WooCommerce and WP-CLI work, with snapshots, readback, audit and restore.
Is Stonewright production ready?
The README calls the current release a public beta and says APIs, tools and behaviour may change before 1.0. It advises testing on staging or local sites first, keeping independent backups and using production-safe mode on live sites.
Which Elementor version does Stonewright need?
The README lists Elementor 3.21 or later, needed only when you use Elementor abilities. It lists WordPress 6.7 or later, PHP 8.1 or later and Node.js 20 or later for the companion. Elementor V4 support is marked experimental.
What is the difference between Plugin mode and Direct mode?
Plugin mode needs the Stonewright plugin and exposes the full ability set including validated Elementor writes, memory and audit. Direct mode needs only an application password, covers core REST and read only WooCommerce, and has no Elementor schema validation.
How do I install Stonewright?
Download the plugin ZIP from the latest GitHub release and install it in WordPress. Then use the Setup screen to connect your client, restart it and run the generated verification. The companion is distributed through GitHub Releases rather than the npm registry.
Can Stonewright undo an agent's changes?
Where supported, yes. Pre-write snapshots, a change history with before and after content and rescue rollback cover posts, Elementor documents, options and more. Rescue cannot fix a fatal in WordPress core or wp-config.php, or a database that is down.
Does Stonewright let agents run PHP?
Only through stonewright-php-execute, which is on the full profile that an administrator chooses in wp-admin. The README says it is gated and audited but is not a strict sandbox, and prefers typed abilities.
How does Stonewright compare with lighter Elementor MCP tools?
It is larger and includes recovery features such as snapshots, change history and rescue, but it also has a bigger setup and is still a beta. For a smaller add-on see MCP Abilities Elementor, or Respira for several builders.


