Blueprint URL Parameters Collect Blueprint User Details How to Upload and Host a HTML/PHP Site on WPAI How to Connect a Custom Domain to Your WPAI Site How to Migrate Websites into WPAI How to access Experimental Features? Using WPAI MCP with AI Tools

1. Customize Site With Astra
2. Customize Page With Spectra
3. Add A Blog
4. Built-In Features
5. How to Enable Branded Site URL in WPAI

How to Claim Your Business Cloud’s Complimentary Access? Upgrade or Downgrade Plan Delete Account Premium Plan Benefits Account Restriction Issues Request Refund

Host A Site Sites Allowed Per Organization Become An Affiliate Prerequisites

How to Connect Your Domain and Go Live with WPAI Cloud? What is WPAI Cloud? Understanding the WPAI Cloud Dashboard Connecting a Custom Domain to Your Site (Nameserver vs. CNAME) Why is My WordPress Site Not Loading? (Common Causes & Fixes) Disk Usage & File Limits (Inodes) Explained AI Troubleshooter

/ Documentation / How To / Using WPAI MCP with AI Tools Using WPAI MCP with AI Tools Imagine telling your AI assistant, “Create a new site for my bakery” and just watching it happen. No clicking around dashboards, no hunting through menus. That’s exactly what WPAI’s new MCP integration makes possible. WPAI now supports the Model Context Protocol (MCP) , an open standard that lets AI tools like Claude connect directly to your WPAI account and manage your WordPress sites through plain conversation. It’s kind of like giving your AI a backstage pass to your account. So What Exactly Is MCP? MCP stands for Model Context Protocol, and while that sounds technical, the idea is simple: it’s a secure bridge between your AI assistant and the apps you use. Once connected, your AI can list your sites, spin up new ones, clone templates, and more, all from a chat window. You talk, it acts. That’s really it! Permissions & Tools When you authorize WPAI, you choose exactly what your AI assistant is allowed to do. It includes actions from listing sites to creating or deleting them. Below is a full breakdown of the available permissions and the tools each one unlocks. Scope What it allows Default Read ( mcp:read ) List your sites, templates, and blueprints Required — always on Write ( mcp:write ) Create and clone sites On by default Delete ( mcp:delete ) Permanently delete sites Off by default — you must opt in Tool What it does Scope needed list-sites List and search your sites mcp:read get-site-progress Check live build progress mcp:read list-templates Browse templates by category or keyword mcp:read list-blueprints Browse your saved blueprints mcp:read create-blank-site Create a blank site with optional plugins & themes mcp:write create-ai-site Generate a site from a template + your business info mcp:write create-site-from-blueprint Build a new site from one of your blueprints mcp:write clone-site Clone an existing site mcp:write delete-site Permanently delete a site (requires confirmation) mcp:delete How to Get Started WPAI MCP uses OAuth for authentication. Follow the steps below to connect to any of the AI tool you’re using! When authorizing, WPAI requests the following scopes: Claude Code (CLI) Configuration type: Terminal command Run the following command in your terminal from any directory: claude mcp add wpai –transport http https://api.wpai.shop/mcp/wpai Steps Run the command above in your terminal. Start Claude Code by running claude in your terminal. Type /mcp and select wpai from the list. Click Authenticate — your browser will open the WPAI authorization page. Select a team, review permissions, and click Authorize . Return to Claude Code — WPAI tools are now available.

Claude Desktop Configuration type: JSON Config file location: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

1. {
2. "mcpServers": {
3. "wpai": {
4. "command": "npx",
5. "args": [
6. "mcp-remote@latest",
7. "https://api.wpai.shop/mcp/wpai"
8. ]
9. }
10. }
11. } Steps Open the config file at the location shown above (create it if it doesn’t exist).
12. Paste the configuration and save the file.
13. Restart Claude Desktop.
14. When you use a WPAI tool for the first time, your browser will open the WPAI authorization page.
15. Select a team, review permissions, and click Authorize .
16. ChatGPT
17. Configuration type: JSON
18. {
19. "url": "https://api.wpai.shop/mcp/wpai"
20. } Steps Open ChatGPT Settings Tools & Integrations (Connectors) .
21. Click Add MCP Server and paste the server URL.
22. Your browser will open the WPAI authorization page.
23. Select a team, review permissions, and click Authorize .
24. Return to ChatGPT — WPAI tools are now available.
25. Cursor
26. Configuration type: JSON
27. Config file location:
28. Project-scoped: .cursor/mcp.json in your project root
29. Global: ~/.cursor/mcp.json

1. {
2. "mcpServers": {
3. "wpai": {
4. "type": "streamable-http",
5. "url": "https://api.wpai.shop/mcp/wpai"
6. }
7. }
8. } Steps Open or create the config file at the location shown above.
9. Paste the configuration and save the file.
10. Restart Cursor.
11. When you use a WPAI tool for the first time, your browser will open the WPAI authorization page.
12. Select a team, review permissions, and click Authorize .
13. Windsurf Configuration type: JSON
14. Config file location: ~/.codeium/windsurf/mcp_config.json

{ "mcpServers": { "wpai": { "serverUrl": "https://api.wpai.shop/mcp/wpai" } } } Steps Open or create the config file at ~/.codeium/windsurf/mcp_config.json . Paste the configuration and save the file. Restart Windsurf. When you use a WPAI tool for the first time, your browser will open the WPAI authorization page. Select a team, review permissions, and click Authorize . Cline (VS Code Extension) Configuration type: JSON Config file location: Cline MCP Settings (via the VS Code extension sidebar) { "mcpServers": { "wpai": { "url": "https://api.wpai.shop/mcp/wpai" } } } Steps Open the Cline panel in VS Code and navigate to MCP settings. Paste the configuration and save. When you use a WPAI tool for the first time, your browser will open the WPAI authorization page. Select a team, review permissions, and click Authorize . Return to VS Code — WPAI tools are now available. Other / Generic MCP Clients For any other MCP-compatible client, use the following standard configuration: MCP Server URL: https://api.wpai.shop/mcp/wpai { "mcpServers": { "wpai": { "url": "https://api.wpai.shop/mcp/wpai" } } } Refer to your MCP client’s documentation for the exact config file location and format. Once configured, restart the client and authorize WPAI via the browser pop-up when you first use a WPAI tool. What Happens During Authorization When authorization is triggered for the first time: Your browser opens https://app.wpai.shop/mcp/authorize . You are shown the name of the client requesting access (e.g. “Claude Code”) and your WPAI account email. You see a list of permissions being requested. You can uncheck Delete if you don’t want the tool to be able to remove sites. If you belong to multiple teams, a team selector appears. Choose which team the AI assistant should operate on. Click Authorize to complete the connection. The browser redirects back to your AI tool automatically. The authorized connection will then appear in Account Settings MCP Connections , where you can view its last-used time, revoke access, or delete it. Managing Connections You can manage all active MCP connections at Account Settings MCP Connections . From that page you can: See each connection’s name, key, permissions, status, and last-used time. Edit the connection name. Revoke a connection (disables it without deleting — can be re-activated). Delete a connection permanently.

What You Can Ask Your AI Assistant Once connected, you can give natural-language instructions such as: “Create a new WordPress site on WPAI called My Portfolio” “Clone the e-commerce blueprint and name it Client Shop” “List all my active WPAI sites” “Delete the staging site named test-site” “Show available WPAI templates”

Troubleshooting Symptom Likely cause Fix Browser doesn’t open for authorization Client isn’t connecting to the MCP server Double-check the server URL and config key names (e.g. serverUrl for Windsurf) “Invalid or missing authorization parameters” Authorization was started but not completed Restart the connection from your MCP client and re-authorize Connection shows as Inactive Token was revoked Re-authorize from your MCP client WPAI tools appear but actions fail Wrong team selected during authorization Delete the connection and re-authorize, selecting the correct team Config changes not taking effect Tool not fully restarted after saving config Fully quit and reopen the AI tool Getting started takes just a few minutes. Add the server URL to your AI tool, authorize via your browser, and you’re ready to create and manage WordPress sites through natural conversation. If you run into any issues, the troubleshooting table above covers the most common ones. In case you need further help, feel free to reach us at support@wpai.shop !