wp-ssh-mcp
Enables exporting Elementor page data and setting/importing Elementor designs, allowing page designs to be moved between connected WordPress sites.
Provides tools for interacting with WooCommerce data on the connected WordPress site, such as retrieving orders and updating order statuses, along with related product and media operations in write mode.
Allows managing a self-hosted WordPress site through the WP SSH plugin's HTTPS endpoint, including site diagnostics, posts, options, file reads, and read-only database queries. Write and full modes add content changes, file writes, SQL writes, search-replace, and plugin activation/deactivation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wp-ssh-mcp run diagnostics on my WordPress site and summarize any issues"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wp-ssh-mcp: WordPress MCP server for the WP SSH plugin

Let Claude, Cursor, Claude Code and other MCP clients manage your self-hosted WordPress site (posts, WooCommerce, Elementor, diagnostics, files) without SSH access.
wp-ssh-mcp is a small program that runs on your own computer. It turns the WP SSH plugin's HTTPS endpoint into MCP tools, so your AI sees post_list, order_get, elementor_data_set and so on, with proper parameter schemas. No hosted relay, no accounts: your key stays on your machine.
This needs two pieces. The WordPress plugin does the real work on your site;
wp-ssh-mcponly connects your AI app to it.
Claude Desktop / Cursor / Claude Code
│ MCP (local, stdio)
▼
wp-ssh-mcp ← this repo, runs on your computer
│ HTTPS + X-WPSSH-Key
▼
your WordPress site ← WP SSH plugin (separate repo)Quick start
Step 1: install the plugin on your WordPress site (once per site)
Get it from MSSOFTPC/wp-ssh (Releases →
wp-ssh.zip).WordPress admin: Plugins → Add New → Upload Plugin → Activate.
Tools → WP SSH: tick Enable bridge, copy the Secret key.
Step 2: connect your AI app (see Install for Claude Desktop, Claude Code and Cursor)
claude mcp add my-site -e WPSSH_URL=https://yoursite.com -e WPSSH_KEY=your-key -- npx -y wp-ssh-mcpThen ask: "Run diagnostics on my site."
Related MCP server: WordPress MCP Server
Safe by default
The server starts in read mode. Write tools are not even shown to the AI until you opt in.
| What the AI can do | Action tools |
| Look, never touch: site info, diagnostics, posts, orders, options, file reads, SELECT queries, dry-run search-replace, Elementor export | 21 |
| + content changes: create/update posts, order status, Elementor data/import, product attributes, cache clear, media upload, menus | 34 |
| + risky: file writes/restore, write SQL, permanent delete, real search-replace, plugin activate/deactivate | 41 |
More safety built in:
Risky tools are marked destructive, so MCP clients show an approval prompt.
db_queryaccepts one read-only statement only. Writes need the separatedb_query_writetool (full mode).search_replace_previewalways sendsdry_run: true; the model cannot override it.confirm: trueis never added automatically. The model must pass it, and tool descriptions tell it to do so only after your approval.The plugin's own protections still apply (Read-only mode, IP allowlist, lockout, auto-backups, activity log).
Refuses plain
http://(except localhost), refuses to follow redirects (the key is never forwarded), and never prints your key.
Install
Requires Node.js 18+ and the WP SSH plugin active on your site (Tools → WP SSH → copy the secret key, tick Enable bridge).
Claude Desktop
Edit claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"my-site": {
"command": "npx",
"args": ["-y", "wp-ssh-mcp"],
"env": {
"WPSSH_URL": "https://yoursite.com",
"WPSSH_KEY": "your-64-char-secret-key",
"WPSSH_MODE": "read"
}
}
}
}Restart Claude Desktop.
Claude Code
claude mcp add my-site -e WPSSH_URL=https://yoursite.com -e WPSSH_KEY=your-key -- npx -y wp-ssh-mcpCursor
~/.cursor/mcp.json (or project .cursor/mcp.json): same mcpServers block as above.
Several sites
"env": {
"WPSSH_SITES": "[{\"name\":\"shop\",\"url\":\"https://shop.com\",\"key\":\"...\"},{\"name\":\"blog\",\"url\":\"https://blog.com\",\"key\":\"...\"}]",
"WPSSH_MODE": "read"
}Every tool then gets a required site parameter (shop or blog).
Run from source
git clone https://github.com/MSSOFTPC/wp-ssh-mcp
cd wp-ssh-mcp
npm install && npm run build
# then use "command": "node", "args": ["/full/path/to/wp-ssh-mcp/dist/index.js"]Configuration
Variable | Meaning |
| One site. URL like |
| Optional name for the single site (default |
| JSON array for several sites (see above) |
|
|
|
|
| Request timeout, default |
| Max characters returned per call (default |
Example prompts
"Run diagnostics on my site and tell me what is slowing it down."
"List draft posts tagged ready and show me before publishing any."
"Preview a search-replace from
http://old.comtohttps://new.com. Don't apply it.""Export the Elementor design of page 120 from
shopand import it as a draft onblog.""Show today's WooCommerce orders and summarise by status."
ChatGPT, n8n, Make, Zapier (no MCP needed)
This repo also ships OpenAPI 3.1 files generated from the same action list:
openapi.json: read + content-write actions (use this one)openapi.full.json: everything, including risky actions (only for agents you fully trust)
Custom GPT: Configure → Actions → Import the file → set the server URL to your site → Authentication: API Key, Custom, header name X-WPSSH-Key.
Note that ChatGPT calls your site from OpenAI's servers, so an IP allowlist is not practical there; keep the plugin in Read-only mode unless you are actively making changes.
Regenerate after changing src/spec.ts: npm run build && npm run gen:openapi.
Privacy
wp-ssh-mcp talks only to the site URLs you configure. No telemetry, no analytics, no third-party servers. What the AI sees is the output of the tools you allow, and it is handled under your AI provider's terms.
Troubleshooting
Symptom | Fix |
"wrong or missing secret key" | Re-copy the key from Tools → WP SSH (regenerating invalidates the old one) |
403 | Bridge disabled, Read-only mode on in the plugin, or your IP is not on the allowlist |
404 | Plugin inactive, or permalinks/REST API blocked by a security plugin or server rule |
"redirect" error | Use the exact final URL (https vs http, www vs non-www) |
Tools missing | You are in |
Nothing shows in Claude Desktop | Check JSON syntax, fully restart the app, run |
Development
npm install
npm test # builds and runs the end-to-end smoke test against a mock endpoint
npm run gen:openapisrc/spec.ts is the single list of actions. Add an action there and both the MCP tool and the OpenAPI schema appear.
License
GPL-2.0-or-later, same as the plugin.
Available Tools
23 toolscron_listcron_listBRead-onlyIdempotent
All scheduled WP-Cron events, soonest first.
Inputs: no named parameters.
db_querydb_queryARead-onlyIdempotent
Run a read-only SQL query (SELECT / SHOW / DESCRIBE / EXPLAIN, one statement). Use LIMIT.
Inputs: sql (required).
diagnosticsdiagnosticsBRead-onlyIdempotent
PHP/memory config, autoload options size, DB size and largest tables, transients/revisions counts, active caching plugins.
Inputs: no named parameters.
elementor_data_getelementor_data_getBRead-onlyIdempotent
Raw _elementor_data JSON of a page. Can be very large.
Inputs: post_id (required).
file_listfile_listBRead-onlyIdempotent
List a directory inside wp-content.
Inputs: path.
file_readfile_readBRead-onlyIdempotent
Read a file inside wp-content.
Inputs: path (required).
health_check_runhealth_check_runARead-onlyIdempotent
Run the health check now (DB connection, PHP fatals in debug.log, low disk space, bridge disabled).
Inputs: no named parameters.
health_check_statushealth_check_statusARead-onlyIdempotent
Result of the last hourly self-check (if health checks are enabled).
Inputs: no named parameters.
media_listmedia_listCRead-onlyIdempotent
List media library items.
Inputs: limit.
option_getoption_getBRead-onlyIdempotent
Read a WordPress option by name.
Inputs: name (required).
order_getorder_getBRead-onlyIdempotent
Full order detail including line items and addresses.
Inputs: id (required).
order_listorder_listBRead-onlyIdempotent
List WooCommerce orders (WooCommerce must be active).
Inputs: limit, search, status.
plugin_listplugin_listARead-onlyIdempotent
List installed plugins and their active state.
Inputs: no named parameters.
post_getpost_getBRead-onlyIdempotent
Get one post by ID.
Inputs: id (required).
post_listpost_listCRead-onlyIdempotent
List posts/pages/custom post types.
Inputs: limit, search, post_type, post_status.
search_replace_previewsearch_replace_previewARead-onlyIdempotent
DRY RUN of a serialization-safe search/replace across the database. Shows what would change, changes nothing.
Inputs: search (required), replace (required), tables.
site_infosite_infoARead-onlyIdempotent
Site name, label, URL, WordPress / theme / WooCommerce versions. Good first call.
Inputs: no named parameters.
template_exporttemplate_exportARead-onlyIdempotent
Export a page's Elementor data + settings so it can be copied to another site with template_import.
Inputs: post_id (required).
term_listterm_listCRead-onlyIdempotent
List taxonomy terms.
Inputs: taxonomy.
theme_listtheme_listARead-onlyIdempotent
List installed themes.
Inputs: no named parameters.
wpssh_pingPing siteARead-only
Check that the WP SSH plugin is installed and reachable (no key needed). Returns plugin, version, site, label.
Inputs: no named parameters.
wpssh_sitesList configured sitesARead-only
List the WordPress sites this server can reach and the current safety mode ("read"). Never shows keys.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Most tools target clearly distinct resources and actions, such as order_list vs order_get and file_list vs file_read. There is mild overlap among site-introspection tools (wpssh_sites, wpssh_ping, site_info), but descriptions make their purposes distinguishable.
Many tools follow a resource_verb pattern (order_list, post_get, option_get), but the set also includes bare nouns (diagnostics), prefixed tools (wpssh_sites, wpssh_ping), and mixed orderings (health_check_run, search_replace_preview). It remains readable but is not a single predictable convention.
At 23 tools the surface is heavy for a WordPress admin server, though the breadth of resources justifies some of it. Several list/get pairs could be consolidated or grouped, making it borderline rather than well-scoped.
The read-only surface covers posts, terms, menus, media, plugins, themes, options, cron, orders, files, Elementor data, diagnostics, and raw DB reads. Some common read operations are missing (users, comments, WooCommerce products beyond orders), but db_query provides a workaround and the absence of writes is consistent with the stated read safety mode.
Maintenance
Related MCP Connectors
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Manage a WordPress site from your AI assistant: read, search, propose edits, Search Console data.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to manage WordPress sites with 190+ tools for content management, theme/plugin customization, file system operations, WooCommerce, and complete site control through natural language.10028 npm55MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage WordPress sites through the WordPress REST API, supporting content, media, users, settings, and Elementor management with safety policies for production use.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with WordPress websites through structured tools, supporting posts, pages, media, users, categories, tags, plugins, themes, menus, and WooCommerce with secure authentication.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read and edit WordPress pages, posts, terms, media and menus through 15 guarded tools, with content saved as drafts, no deletions, block allowlists, single-use image uploads and dry-run menu changes that keep a human in control.GPL 2.0