Update 📢
You can now enable MCP for any InstaWP site with a click of a button, no need to mess around with JSON files or create Application keys, its plug and play. Watch this video for more information: Enable MCP Server on InstaWP.
Ever wish you could just tell your website what to do?
With the release of the InstaWP WordPress MCP Server, that’s now a reality. Built for developers, agencies, and tech-savvy creators, this open-source tool lets you manage WordPress using AI, all through natural language. Whether you’re publishing posts, toggling plugins, or managing users, you can now do it simply by speaking or typing a prompt.
At the heart of this innovation is Model Context Protocol (MCP), which allows AI agents like Claude Desktop to securely translate plain-English commands into structured WordPress REST API calls.
No plugin overload. No confusing menus. Just say:
“Create a post titled ‘Summer Update'”
And watch it happen.
Learn more about this amazing tool as the blog proceeds.
Table of Contents
TL;DR – What You Need to Know
What it is: A Node. js-based open-source WordPress MCP server that lets AI agents manage WordPress via REST API
Who it’s for: Developers, agencies, and even non-technical users who want conversational control over WordPress
Why it matters: Secure, scalable, AI-native workflows without needing to build a plugin for every task
How to try it: Use npx @instawp/mcp-wp or clone the GitHub repo and start controlling WordPress with Claude Desktop
WordPress MCP Server by InstaWP: An Overview
The WordPress MCP Server by InstaWP is an open-source backend that acts as a bridge between AI tools (like Claude Desktop) and your WordPress site. It listens for structured requests sent by an AI, performs the appropriate REST API actions on your site, and returns results—all securely and in real time.
It’s not just a chatbot or integration layer. This server is designed to be the foundation of AI-first WordPress workflows, enabling conversational control over core site operations like publishing, user management, plugin handling, and more.
See it in action here:
Here’s how the flow works:
- You prompt an AI agent like Claude:
“Create a post titled ‘July Sale’ with the content ‘50% off until Sunday.'” - The AI translates this into a structured MCP request.
- The MCP Server receives the request and makes authenticated REST API calls to your WordPress site.
- The response is sent back to the AI, which delivers the result conversationally.
All this happens in seconds, without you touching the dashboard. Everything from listing posts to toggling plugins or managing users can be handled via natural language, through a system that’s designed to be secure, extensible, and intuitive.
With InstaWP’s WordPress MCP Server, developers can orchestrate full site operations using natural language:
- Manage posts, pages, and media
- Handle users and roles
- Toggle themes and plugins
- Extend it to support custom tools
Here is a quick overview of the power you can experience when you have InstaWP’s WordPress MCP server by your side.
What’s Inside the Codebase of InstaWP’s MCP Server?
The InstaWP WordPress MCP Server is engineered for developers who want speed, structure, and security when building AI-first WordPress integrations. It’s built with modern tooling like Node.js, TypeScript, and the official Model Context Protocol (MCP) SDK, making it incredibly easy to customize and extend.
Let’s break down the architecture and how it empowers you to manage WordPress with AI.
1. Node.js + TypeScript
The server is written in Node.js for high-performance, asynchronous operations and uses TypeScript to provide static typing. This ensures:
- Easy onboarding for developers familiar with modern JavaScript
- Cleaner, more maintainable code
- Fewer runtime bugs
2. Model Context Protocol SDK (MCP SDK)
This SDK acts as the brain of the server, interpreting structured requests from an AI agent (like Claude) into executable tasks. It:
- Defines each available “tool” (e.g., create post, delete user)
- Ensures data passed to tools is valid and secure
- Acts as a translator between AI and WordPress
3. Application Passwords (WordPress Auth)
Instead of using OAuth or API keys, this WordPress MCP server uses Application Passwords—a secure WordPress feature that allows fine-grained access control.
- No full admin access required
- Easy to revoke or rotate keys
- Ensures actions happen under the correct user scope
4. .env-Based Configuration
Site credentials, URLs, and passwords are managed via a .env file. This makes the system:
- Safer (credentials are kept out of code)
- Portable (easily move between dev/stage/prod environments)
- Easy to set up (just edit one file)
5. Modular Tool Handlers
Each WordPress action, like working with posts, pages, plugins, or media, is encapsulated in a self-contained file under the /tools directory.
- Want to add WooCommerce support? Just drop in a new
tools/woocommerce.ts. - Each file defines parameters, validation logic, and how the REST API call should be made.
6. CLI & Build Tools
npxsupport: Run the server instantly without installing globallyesbuild: Fast and modern JavaScript bundler for production builds- Docker support: Run the server as a container anywhere
- CLI runner: Test tools locally before wiring up to AI agents
With these components in place, you can confidently delegate tasks to an AI that talks to WordPress your way—without giving up security, performance, or flexibility.
7. Security Features
Security is fundamental when allowing AI to perform automated actions on a WordPress site. The following best practices are built into the design of this WordPress MCP server.
- Least Privilege Access: Use WordPress users with only the permissions needed for your use case.
- Application Password Scoping: Generate unique, revocable keys for each MCP integration.
- HTTPS-Only Communication: Ensure secure transport, especially for remote or cloud-deployed servers.
- Input Validation: Every tool handler validates incoming parameters to prevent injection and unexpected behavior.
- Password Rotation: App passwords can be regenerated as needed without affecting core account credentials.
- Staging First: Use sandbox environments to test before deploying MCP integrations on production sites.
How to Use InstaWP’s MCP Server on Your WordPress Site?
Getting started with the InstaWP WordPress MCP Server is fast and developer-friendly. Whether you want to test it locally, extend it with custom tools, or connect it to Claude Desktop for real-time AI interaction, you’ll be up and running in minutes.
Follow this simple setup guide to launch your own MCP-powered WordPress assistant. Make sure you have:
- An active InstaWP account
- ChatGPT Plus or any other LLM tools’s subscription with Developer Mode, OR Claude Desktop app
- 5 minutes
Step 1: Create a WordPress Site on InstaWP
Navigate to instawp.com and sign up or log in. From your dashboard, click “Create New Site”.
Select your preferred configuration:
- WordPress version (latest recommended)
- PHP version (8.1+ recommended)
- Site name (e.g.,
my-ai-site)
Click Create and wait ~30 seconds for provisioning. Your WordPress site is now live with a temporary URL like my-ai-site.instawp.xyz.
Must Read: Create Site | InstaWP Docs
Step 2: Enable the MCP Server
In your InstaWP dashboard, click on your site to open the Site Detail page. In the left sidebar, locate and click “MCP”.
Click the “Enable MCP” button.
As you do so, InstaWP installs the WordPress MCP plugin automatically and a secure authentication token is generated.
Step 3: Copy Your MCP Connection URL
After enabling, you’ll see your MCP URL displayed in the dashboard. It looks something like:
https://my-ai-site.instawp.xyz/wp-json/instawp-mcp/v1/sse?token=abc123xyz...<br>
Click the copy icon to copy this URL to your clipboard.
🔒 Security Note: This URL contains your authentication token. Treat it like a password—don’t share it publicly or commit it to version control.
Watch the video below to see it in action.
Step 4: Connect to ChatGPT or Claude
ChatGPT, Claude, or Cursor supports MCP connections through its Developer Mode. Here’s how to set it up:
We have a detailed guide on ‘ How to Connect ChatGPT to WordPress‘. Read it to learn how to set-up InstaWP’s WordPress MCP server to use ChatGPT on your WordPress site.
If you prefer Claude over ChatGPT, you need to download and install Claude Desktop and go to Connectors in the sidebar, and click “Add Custom Connector”.
Paste your InstaWP MCP URL. Enter a name (e.g., WordPress - Client Site) and click Add. After adding, click Configure to see all available WordPress tools and pre-approve specific actions.
Step 6: Verify the Connection
Open a new conversation in ChatGPT or Claude and test the connection:
Test prompt:
List all posts on my WordPress siteThe AI will call the MCP server, retrieve your posts via the REST API, and display them in a formatted list with titles, IDs, and status.
More test commands:
Show me the 5 most recent draft posts
What plugins are currently active on my site?
List all categories and their post countsReal-World Use Cases for the WordPress MCP Server
The WordPress MCP Server isn’t just a tech demo; it’s a practical, AI-powered assistant that can replace dozens of repetitive dashboard clicks with a single natural-language command. Here’s how developers, agencies, and content teams are already putting it to work:
| Scenario | Example Prompt | Why It’s a Game-Changer |
|---|---|---|
| AI-Driven Content Management | Onboard or off-board staff in seconds, even from a mobile AI chat. | Publish, update, or delete posts without opening wp-admin—perfect for editorial calendars. |
| Plugin & Theme Control | “Deactivate Old-Gallery plugin and switch to Twenty Twenty-Four theme.” | Safe, instant toggles during audits or redesigns—no FTP or cPanel required. |
| User & Role Administration | “Add user Sara Lee with the Editor role.” | Onboard or off-board staff in seconds, even from mobile AI chat. |
| Media Library Automation | “Upload hero-banner.jpg and return its URL.” | Skip the Media Library UI and insert assets programmatically. |
| Multi-Site Bulk Actions | “Update all plugins across my 12 client sites.” | Agencies save hours by issuing one command to multiple connected sites. |
| Custom Compound Workflows | “Prepare Black-Friday campaign.” (Creates a category, drafts three posts, activates coupon plugin.) | Chain tasks into a single conversational macro—no custom scripts needed. |
Who Should Use This WordPress MCP Server?
The WordPress MCP Server by InstaWP is designed to help anyone interact with WordPress more intuitively—whether you’re writing code, managing client sites, or just tired of clicking through menus.
Here’s how different types of users can benefit:
| Developers | Agencies | Non-Technical Users | |
|---|---|---|---|
| Primary Benefit | Automation & reduced boilerplate | Scalable client management | Dashboard-free WordPress |
| Use Cases | Setup tasks, dev tools, testing workflows, API abstraction | Client onboarding, multi-site management, team enablement | Content creation, media uploads, page management |
| Time Saved | Hours per project | Hours per client per week | Minutes per task (no learning curve) |
| Technical Skill Needed | Uses existing skills more efficiently | Minimal—empower whole team | Zero—plain English commands |
| Example Prompt | “Generate three draft posts under the SEO category” | “List all sites with outdated plugins” | “Create a contact page” |
No matter your role, the MCP Server helps you do more in less time by simply talking to WordPress.
How to Extend the WordPress MCP Server for Custom Workflows
One of the biggest strengths of the InstaWP WordPress MCP Server is its plugin-agnostic, modular architecture, built for developers and agencies who want to tailor AI workflows to their exact needs.
If your site uses WooCommerce, SEO tools, LMS plugins, or custom post types, you can extend the server to support them, all with just a few lines of code.
Add a New Tool in 3 Simple Steps
- Create a New File in
/tools/
Example:tools/woocommerce.ts - Define Your Tool Logic
Include parameter definitions, validation rules, and the WordPress REST API call. - The Server Auto-Registers It
The tool becomes immediately available to any connected AI agent.
✅ You don’t need to modify any core logic—the server is built for plug-and-play extensibility.
Here’s what you can build on top of the current repo:
Beyond WordPress, you can integrate with:
- CRM platforms (e.g., HubSpot, Zoho)
- Email marketing tools (e.g., Mailchimp)
- Analytics APIs
- Internal admin panels
If an action can be executed via REST or CLI, you can wrap it into a natural language tool using MCP.
Real-World Examples
- Agency Workflow: “Launch a client site” = clone template + install plugins + set permalinks + publish welcome post.
- Team Collaboration: “Assign author Alex to the five most recent drafts”
- Support Automation: “Deactivate all plugins except security and SEO” (ideal for debugging)
The only limit is your imagination. If you can define it, the WordPress MCP Server can perform it, triggered by AI.
Final Thoughts
The InstaWP WordPress MCP Server isn’t just another dev tool; it’s a shift in how we interact with WordPress. Instead of clicking through menus or writing boilerplate code, you can now manage your site by simply speaking your intent.
Whether you’re a developer automating workflows, an agency managing dozens of installs, or a non-technical user looking for simplicity, the MCP Server unlocks a future where WordPress listens, understands, and acts; securely and instantly.
And because it’s open-source, customizable, and backed by InstaWP’s dev-first ecosystem, you don’t just use it—you build on it, fork it, shape it.
🚀 Ready to Try It?
Create a site on InstaWP now!
FAQs
What is InstaWP’s WordPress MCP Server?
InstaWP’s WordPress MCP Server is a built-in feature of the InstaWP platform that enables AI assistants like ChatGPT and Claude to interact directly with your WordPress site. Unlike standalone MCP solutions that require manual installation and configuration, InstaWP’s MCP server is pre-configured and activates with a single click from your site dashboard. It translates natural language commands into WordPress REST API actions—allowing you to manage content, plugins, users, and more through conversation.
Can I enable MCP on an existing WordPress site, or only new site?
Both. You can enable MCP on any WordPress site hosted on InstaWP—whether you just created it or imported it months ago. The MCP plugin integrates with your existing site without affecting your content, plugins, or settings.
Do I need technical skills to use InstaWP’s MCP Server?
No. The entire setup is point-and-click. You enable MCP from your dashboard, copy the generated URL, and paste it into your AI client (ChatGPT or Claude Desktop). There’s no command line, no code editing, and no server configuration required. If you can copy and paste a URL, you can set up InstaWP’s MCP Server.
Can I use MCP with a custom domain on InstaWP?
Yes. If you’ve connected a custom domain to your InstaWP site, the MCP URL will use your custom domain. The functionality remains identical.
Does InstaWP’s MCP work with WooCommerce?
The core MCP server handles standard WordPress functionality. WooCommerce-specific actions (like managing products, orders, or customers) require extended tool definitions. InstaWP is actively expanding MCP capabilities—check the documentation for the latest supported integrations.
