Ultimate Elementor MCP

# ⚡ Ultimate Elementor MCP - Quick Start Guide Get up and running in 5 minutes! --- ## 🎯 **5-Minute Setup** ### **Step 1: Get the Code (1 minute)** ```bash git clone https://github.com/mbrown1837/Ultimate-Elementor-MCP.git cd Ultimate-Elementor-MCP npm install npm run build ``` ### **Step 2: Get WordPress Application Password (1 minute)** 1. Login to WordPress Admin 2. Go to **Users** → **Your Profile** 3. Scroll to **Application Passwords** 4. Enter name: "Ultimate Elementor MCP" 5. Click **Add New** 6. **Copy the password** (remove spaces!) ### **Step 3: Create Configuration (1 minute)** Create `.env` file in project root: ```env WORDPRESS_BASE_URL=https://your-site.com WORDPRESS_USERNAME=your-username WORDPRESS_APPLICATION_PASSWORD=xxxxxxxxxxxxxxxxxxxx MCP_MODE=full ``` ### **Step 4: Add to Cursor (1 minute)** 1. Open Cursor Settings (`Ctrl/Cmd + ,`) 2. Search for "MCP" 3. Click "Edit Config" 4. Add: ```json { "mcpServers": { "ultimate-elementor-mcp": { "command": "node", "args": [ "C:/absolute/path/to/ultimate-elementor-mcp/dist/index.js" ], "env": { "WORDPRESS_BASE_URL": "https://your-site.com", "WORDPRESS_USERNAME": "your-username", "WORDPRESS_APPLICATION_PASSWORD": "xxxxxxxxxxxxxxxxxxxx", "MCP_MODE": "full" } } } } ``` **Important**: Replace with **your actual absolute path**! ### **Step 5: Test It! (1 minute)** 1. **Restart Cursor** (close and reopen) 2. **Start a new chat** 3. **Type:** ``` List all available MCP tools ``` 4. **You should see 60 tools!** 🎉 --- ## 🚀 **Your First Commands** ### **Test WordPress Connection** ``` Test the WordPress connection and show me the results ``` **Expected:** Connection successful with site details --- ### **List Your Content** ``` Show me all my published pages ``` **Expected:** List of all pages with IDs and titles --- ### **Create Your First Page** ``` Create a new page called "Test Page" with a heading "Hello World" and text "This is my first AI-generated page" ``` **Expected:** Page created with Elementor layout --- ### **Check Configuration** ``` What configuration mode is the Ultimate Elementor MCP running in, and how many features are enabled? ``` **Expected:** Mode info and feature count --- ## 🎓 **Next Steps** Now that you're set up: 1. 📖 **Learn the basics**: [User Guide](USER_GUIDE.md) 2. 💡 **See examples**: [Examples](EXAMPLES.md) 3. 🔧 **Explore tools**: [Tools Reference](TOOLS_REFERENCE.md) 4. 🐛 **If issues**: [Troubleshooting](TROUBLESHOOTING.md) --- ## 🔧 **Configuration Modes Explained** ### **Essential Mode (20 tools)** ```env MCP_MODE=essential ``` **Best for:** Learning, basic tasks **Includes:** WordPress CRUD + Basic Elementor ### **Standard Mode (32 tools) - Default** ```env MCP_MODE=standard ``` **Best for:** Most users **Includes:** Essential + Page building + Element management ### **Advanced Mode (42 tools)** ```env MCP_MODE=advanced ``` **Best for:** Power users **Includes:** Standard + Performance tools + Advanced operations ### **Full Mode (60 tools)** ```env MCP_MODE=full ``` **Best for:** Complete control **Includes:** Everything! Templates, global settings, file operations, debugging --- ## ✅ **Verification Checklist** After setup, verify: - [ ] MCP server shows in your client - [ ] Tools are listed (20-60 depending on mode) - [ ] WordPress connection test succeeds - [ ] Can list pages/posts - [ ] Can create test content - [ ] Elementor operations work --- ## 🆘 **Quick Troubleshooting** ### **No tools showing?** → Check WordPress credentials in `.env` ### **Connection failed?** → Verify WordPress URL and Application Password ### **Path errors?** → Use **absolute path** in MCP config ### **Server not starting?** → Run `npm run build` first --- ## 💬 **Example First Conversation** **You:** > Hi! I just set up the Ultimate Elementor MCP. Can you test the connection? **AI:** > I'll test the WordPress connection using the health_check tool... > > ✅ Connection successful! > - WordPress version: 6.4.2 > - REST API: Working > - Elementor: Installed > - MCP Mode: Full (60 tools) > > You're all set! What would you like to create? **You:** > Create a simple "Welcome" page with a heading **AI:** > I've created a new page called "Welcome" with a heading widget... > > ✅ Page created successfully! > - Page ID: 234 > - URL: https://your-site.com/welcome/ > - Status: Draft > > Would you like to add more content or publish it? --- ## 🎉 **You're Ready!** **Congratulations! You now have access to 60 powerful tools for WordPress and Elementor management!** Start creating amazing websites with AI! 🚀 --- **🔧 Questions? Check the [Full Documentation](README.md) or [Ask for Help](https://github.com/mbrown1837/Ultimate-Elementor-MCP/issues)**