What is the MainWP MCP server?
The MainWP MCP server is a Node.js tool that connects an MCP compatible AI client to a MainWP Dashboard. It runs on your own computer, uses a WordPress Application Password, and offers around 70 tools for sites, updates, plugins, themes and clients, with approval gates for destructive actions.
MainWP MCP is the server the README calls the official MainWP MCP Server. It sits between an AI client and MainWP, the self-hosted dashboard for running many WordPress sites, so you can ask about updates, connectivity and plugins in plain English.
It runs on the computer where your AI tool runs. The README states that nothing new is installed on your Dashboard or on the child sites it manages.
What it covers
- Sites: list, sync, check connectivity, add, reconnect or remove child sites.
- Updates: see pending core, plugin, theme and translation updates across the network and apply them.
- Plugins and themes: view, activate, deactivate or delete.
- Clients and tags: manage client records, assign sites and track costs.
- Guided workflows: network summaries, site reports, security audits and update plans.
Who it is for
Best for
- Agencies and freelancers who look after many WordPress sites and want help with maintenance.
- Teams already running a MainWP Dashboard 6.0 or later over HTTPS.
Not for
- Building or editing page layouts. This server manages sites and maintenance, not design.
- People without MainWP. It needs a Dashboard to talk to and Node.js 20.19 or later.
Control and safety
By default, deleting a site, plugin or theme shows a preview and waits for your yes. Safe mode blocks destructive operations outright, and allow and block lists choose which tools the AI can see at all.
Use it with UiChemy
MainWP handles upkeep after launch. For the build stage, see AI website builders for WordPress compared or the WordPress developer MCP server. Click Get Started on uichemy.com.
Connect MainWP MCP Server: Manage Many WordPress Sites to your AI client
npx -y @mainwp/mcpCreate an Application Password
In the Dashboard, open Users, then Profile, then Application Passwords, and add one named MainWP MCP Server. It is separate from your login password and can be revoked.
Add the server to your client
Paste the JSON config into your AI tool and fill in the Dashboard URL, user and password.
Restart and test
Restart the client and ask it to list all your sites. A working setup returns child sites by name and URL.
Claude Code plugin
The README also offers a Claude Code plugin that installs the server, an agent skill and ten workflow commands, with credentials still coming from your environment.
Client configuration
{
"mcpServers": {
"mainwp": {
"command": "npx",
"args": ["-y", "@mainwp/mcp"],
"env": {
"MAINWP_URL": "https://your-dashboard.com",
"MAINWP_USER": "admin",
"MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}Endpoints and ports
https://your-dashboard.comYour Dashboard, reachable over HTTPS20.19 or laterNeeded on the machine that runs the client6.0 or laterSome tools need a newer versionWhat you can do with it
- Approval before deletesDeleting a site, plugin or theme shows a preview first and runs only after you confirm.
- Safe modeBlocks destructive operations with no prompt while you get comfortable.
- Tool allow and block listsDecide which tools the AI can see at all.
- Revocable credentialsIt signs in with an Application Password you can revoke, and talks only to your Dashboard.
- Local by designRuns next to your AI tool, with nothing added to the Dashboard or child sites.
- Prompt cookbookReady to use prompts by task are linked from the README.
Tools it exposes
Sites
List, sync, add, reconnect, remove and check child sites.
Updates
Review and apply pending core, plugin, theme and translation updates.
Plugins and themes
See what is installed, then activate, deactivate or delete.
Clients and tags
Manage client records, site assignment and costs.
Knowledge
Agency, client and site notes, skills and memories on Dashboard 6.3 and later.
Guided workflows
Network summaries, site reports, security audits and update plans.
Frequently asked questions
What is the MainWP MCP server?
It is a Node.js server that connects MCP compatible AI tools to a MainWP Dashboard. You ask in plain English which sites need updates or which are disconnected, and it calls MainWP on your behalf with about 70 tools.
How do I install MainWP MCP?
Add the npx command for the @mainwp/mcp package to your client config with the Dashboard URL, user and Application Password. Restart the client and ask it to list your sites. You need Node.js 20.19 or later.
Does the MainWP MCP server work with Cursor and Codex?
Yes. The README says it connects Claude, Cursor, OpenAI Codex, VS Code Copilot and other MCP compatible tools, and links a client setup guide with config file locations for each.
Is it safe to let AI update my sites?
The README describes approval previews for deletions, and for updates on Dashboard 6.3 and later. Safe mode blocks destructive actions, and tool lists limit what the AI sees. Start with safe mode on and a staging group.
What do I need before using it?
You need Node.js 20.19 or later on your computer, a MainWP Dashboard 6.0 or later reachable over HTTPS, and an MCP compatible client. Some tools need a newer Dashboard, and the quickstart lists which.
Does it install anything on my child sites?
No. The README states that nothing new is installed on your Dashboard or child sites. The server runs on your own computer and communicates with the Dashboard through its REST interface.
Can it build or design pages?
No. It is a maintenance and fleet management server. For content or page building use a plugin based server such as Elementor Abilities MCP or Respira, and keep MainWP for updates and reports.
Which license does MainWP MCP use?
The repository uses GPL-3.0. The README shows the license badge and points to the LICENSE file. Check it before you redistribute or modify the code, and read the project's security policy before reporting issues.


