What is InstaWP mcp-wp?
InstaWP mcp-wp is an open source MCP server for WordPress, published on npm as @instawp/mcp-wp. It connects an MCP client to one or more sites through Application Passwords and offers tools for content, taxonomies, media, users, comments and plugins.
InstaWP mcp-wp is a Model Context Protocol server for WordPress. It lets an MCP compatible client work with a site in natural language, and it exposes WordPress data and actions as tools over the REST API.
One server instance can manage several sites. All content and taxonomy tools take an optional site_id, so a client can target production, staging or development from the same configuration.
What the tools cover
- Multi-site management: list, inspect and test configured sites.
- Unified content tools for posts, pages and custom post types, including URL lookup and partial edits.
- Unified taxonomy tools for categories, tags and custom taxonomies.
- Media, users, comments and plugins, plus plugin search on the WordPress.org repository.
- An optional read-only SQL query tool that needs a custom endpoint on the site.
Who it is for
Best for
- Editors and developers who want a client to draft, update and organise content across one or several sites.
- Teams that already use Application Passwords and want a plain REST based setup.
- Anyone who wants to run an MCP server with a single npx command.
Not for
- Writing SEO plugin fields. The README says Yoast, Rank Math and All in One SEO keys are not writable by default, because WordPress drops unregistered meta keys.
- Anything that needs control beyond the REST API without extra setup on the site.
Use it with UiChemy
This server manages content on a WordPress site you already have. UiChemy Composer has its own MCP that works on your own WordPress site. For the design side, see the Figma MCP server and AI to WordPress for freelance designers. Click Get Started on uichemy.com.
Connect InstaWP MCP WP: Manage WordPress Content From an MCP Client to your AI client
npx -y @instawp/mcp-wpCreate an Application Password
In WordPress, generate an Application Password for the user the server will act as. The README links the WordPress guide for this.
Add the server to your client
Paste the config into your MCP client. The README's walkthrough uses Claude Desktop settings under the Developer tab, with the example config file and your own site values.
Set the site variables
Use WORDPRESS_API_URL, WORDPRESS_USERNAME and WORDPRESS_PASSWORD for one site. For several sites use WORDPRESS_N_URL, _USERNAME, _PASSWORD, and optional _ID, _DEFAULT and _ALIASES.
Restart the client
Save the configuration and restart your MCP client so it loads the server. Try it on a staging site first, since the tools can create, update and delete content.
Client configuration
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["-y", "@instawp/mcp-wp"],
"env": {
"WORDPRESS_API_URL": "https://your-site.example",
"WORDPRESS_USERNAME": "username",
"WORDPRESS_PASSWORD": "Application Password"
}
}
}
}What you can do with it
- One server, several sitesUp to ten sites can be configured with numbered environment variables, each with an optional ID and aliases for site detection.
- Any content typeOne set of content tools covers posts, pages and custom post types, so you do not need a tool per type.
- URL based lookupHand the server a page URL and it resolves the matching content, with an option to update it in the same call.
- Media from file or URLUpload from a local path on the machine running the server or from a remote URL, then use the returned ID as featured media.
- Trimmed responsesBy default it strips the Yoast head fields from REST responses to keep results small. An environment variable changes the list.
- Visible meta dropsWhen WordPress silently drops unregistered meta keys, the server prepends a warning to the result so the client can see it.
Tools it exposes
list_sites
Lists all configured WordPress sites.
test_site
Tests the connection to a specific site.
list_content
Lists any content type with filtering and pagination.
create_content
Creates content of any type.
update_content
Updates content, including targeted partial edits.
find_content_by_url
Finds, and optionally updates, content from a WordPress URL.
get_content_summary
Returns a compact summary with title, slug, status, excerpt, taxonomies and Yoast fields.
list_terms
Lists terms in any taxonomy.
create_media
Creates a media item from a URL or local file path.
list_plugins
Lists plugins installed on the site.
search_plugins
Searches the WordPress.org plugin repository.
execute_sql_query
Runs read-only SQL queries, which requires a custom endpoint on the site.
Frequently asked questions
What is InstaWP mcp-wp?
It is an open source MCP server for WordPress from InstaWP. It uses the WordPress REST API and Application Passwords to let an MCP client manage content, taxonomies, media, users, comments and plugins on one or several sites.
How do I install InstaWP mcp-wp?
Run it with npx -y @instawp/mcp-wp from your MCP client configuration, and set WORDPRESS_API_URL, WORDPRESS_USERNAME and WORDPRESS_PASSWORD. Use a WordPress Application Password, not your login password. Restart the client afterwards so it loads the server.
Can mcp-wp manage more than one WordPress site?
Yes. The README supports multi-site management through numbered variables such as WORDPRESS_1_URL and WORDPRESS_2_URL, with optional IDs and aliases. Content and taxonomy tools accept a site_id to choose the target.
Can mcp-wp edit Yoast or Rank Math fields?
Not by default. The README says WordPress silently drops meta keys that are not registered for the REST API, so SEO plugin keys need a small companion plugin that registers them. The server warns when keys are dropped.
Does mcp-wp run SQL queries?
It lists an execute_sql_query tool for read-only queries, but the README says it needs a custom REST endpoint added to your WordPress site. It is optional and off until you set that endpoint up.
What license does InstaWP mcp-wp use?
The package.json in the repository lists GPL-3.0-or-later. GitHub does not detect a separate license file, so check the repository itself before you redistribute or modify the code in your own projects.
Is it safe to give an MCP server my WordPress credentials?
The README advises never committing secrets, using HTTPS and validating inputs. The server acts with the permissions of the user whose Application Password you give it, so use a limited account and a staging site first.
What are alternatives to InstaWP mcp-wp?
For page builder work see Respira WordPress MCP or MCP Abilities Elementor. For a plugin based setup with abilities, see Novamira or WP MCP Ultimate. This server suits REST based content management.


