{"_id":"@alien-lifestyles/mailchimp-mcp","_rev":"5-aaf6f1a773527d7cd5066dc1a47f46fa","name":"@alien-lifestyles/mailchimp-mcp","dist-tags":{"latest":"0.4.1"},"versions":{"0.2.0":{"name":"@alien-lifestyles/mailchimp-mcp","version":"0.2.0","keywords":["mcp","mailchimp","model-context-protocol","claude","email-marketing"],"author":{"name":"alien-lifestyles"},"license":"MIT","_id":"@alien-lifestyles/mailchimp-mcp@0.2.0","maintainers":[{"name":"alienlifestyles","email":"mikefortoday@gmail.com"}],"homepage":"https://alienlifestyles.com","bugs":{"url":"https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles/issues"},"bin":{"mailchimp-mcp-setup":"scripts/setup-cli.js","mailchimp-mcp-install":"scripts/installer.js"},"dist":{"shasum":"a8596e1819c87bc8d21755464a65193b82d2ed78","tarball":"https://registry.npmjs.org/@alien-lifestyles/mailchimp-mcp/-/mailchimp-mcp-0.2.0.tgz","fileCount":18,"integrity":"sha512-LKrBoQLcP4murLNV7Co45YJfceoQY7YEYsmaf3vjJA/4DNUmZ24GWwzNhCC0CIoDhIoMXKoH65BALz9QmADQTA==","signatures":[{"sig":"MEYCIQDPyI7DytkRHNxKFY46cJ3EIK7mSBiqw7Tr3HBXgfQCLAIhAOE+ZYcEBlA3VlTZcKdyf2YrCq0A0GUmsapzKC6QixnE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":188323},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"4e5828535ed72a26988236638ee2cd5f60320e73","scripts":{"dev":"tsx watch src/index.ts","test":"vitest","build":"tsup src/index.ts src/setup/server.ts --format esm --dts --clean","setup":"tsx src/setup/server.ts","start":"node dist/index.js","test:ci":"vitest run --coverage --reporter=verbose","test:ui":"vitest --ui","postinstall":"npm run build","test:coverage":"vitest run --coverage","build:installer":"./scripts/build-installer.sh"},"_npmUser":{"name":"alienlifestyles","email":"mikefortoday@gmail.com"},"repository":{"url":"git+https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles.git","type":"git"},"_npmVersion":"11.5.1","description":"Mailchimp MCP Server for Claude Desktop integration - Free (read-only) and Paid (full access) versions","directories":{},"_nodeVersion":"24.6.0","dependencies":{"zod":"^3.23.8","open":"^10.2.0","dotenv":"^16.4.5","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","pino":"^10.1.0","tsup":"^8.2.3","vitest":"^4.0.8","@vitest/ui":"^4.0.8","typescript":"^5.5.4","@types/node":"^20.14.12","pino-pretty":"^13.1.2","@types/express":"^5.0.5","@vitest/coverage-v8":"^4.0.8"},"_npmOperationalInternal":{"tmp":"tmp/mailchimp-mcp_0.2.0_1762729701432_0.14509214596350373","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@alien-lifestyles/mailchimp-mcp","version":"0.2.1","keywords":["mcp","mailchimp","model-context-protocol","claude","email-marketing"],"author":{"name":"alien-lifestyles"},"license":"MIT","_id":"@alien-lifestyles/mailchimp-mcp@0.2.1","maintainers":[{"name":"alienlifestyles","email":"mikefortoday@gmail.com"}],"homepage":"https://alienlifestyles.com","bugs":{"url":"https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles/issues"},"bin":{"mailchimp-mcp-setup":"scripts/setup-cli.js","mailchimp-mcp-install":"scripts/installer.js"},"dist":{"shasum":"58744e842dc1721b11268cba1176b0176df32e83","tarball":"https://registry.npmjs.org/@alien-lifestyles/mailchimp-mcp/-/mailchimp-mcp-0.2.1.tgz","fileCount":19,"integrity":"sha512-cGo1aNNGvQGm00WBVwzcRU6n+OLBXcP4UNfaGMMYopLbckqa09Xp1BvAIZWdgdQsGZ8CiRXtAhaTmLtnaaXuBA==","signatures":[{"sig":"MEUCIQDfkNu77ZINwlONi0xXhJ/2s00aHWjy3pXt2tKZYc/SQgIgMhk24wbFqZPg+sHksv9KipVMeEGLOMJKRyfyDcpKDso=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":515501},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"4e5828535ed72a26988236638ee2cd5f60320e73","scripts":{"dev":"tsx watch src/index.ts","test":"vitest","build":"npx tsup src/index.ts src/setup/server.ts --format esm --dts --clean","setup":"tsx src/setup/server.ts","start":"node dist/index.js","test:ci":"vitest run --coverage --reporter=verbose","test:ui":"vitest --ui","test:coverage":"vitest run --coverage","build:installer":"./scripts/build-installer.sh"},"_npmUser":{"name":"alienlifestyles","email":"mikefortoday@gmail.com"},"repository":{"url":"git+https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles.git","type":"git"},"_npmVersion":"11.5.1","description":"Mailchimp MCP Server for Claude Desktop integration - Free (read-only) and Paid (full access) versions","directories":{},"_nodeVersion":"24.6.0","dependencies":{"zod":"^3.23.8","open":"^10.2.0","dotenv":"^16.4.5","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","pino":"^10.1.0","tsup":"^8.2.3","vitest":"^4.0.8","@vitest/ui":"^4.0.8","typescript":"^5.5.4","@types/node":"^20.14.12","pino-pretty":"^13.1.2","@types/express":"^5.0.5","@vitest/coverage-v8":"^4.0.8"},"_npmOperationalInternal":{"tmp":"tmp/mailchimp-mcp_0.2.1_1762730580701_0.7134808656351874","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@alien-lifestyles/mailchimp-mcp","version":"0.4.1","description":"The only local-first, AI-native Mailchimp assistant. Get CSM intelligence, marketing analytics, and campaign execution—all through Claude Desktop conversations. Free read-only tier available. Upgrade for full automation.","type":"module","main":"dist/index.js","scripts":{"dev":"tsx watch src/index.ts","build":"npx tsup src/index.ts src/setup/server.ts --format esm --dts --clean && mkdir -p dist/assets dist/setup/public && cp -R src/setup/public/* dist/setup/public/ && cp src/setup/public/alien-lifestyles-logo.png dist/assets/ 2>/dev/null || true","start":"node dist/index.js","setup":"tsx src/setup/server.ts","build:installer":"./scripts/build-installer.sh","prepublishOnly":"node scripts/verify-build-security.js","test":"vitest","test:ui":"vitest --ui","test:coverage":"vitest run --coverage","test:ci":"vitest run --coverage --reporter=verbose","test:endpoints":"tsx scripts/test-all-endpoints.ts"},"bin":{"mailchimp-mcp-setup":"scripts/setup-cli.js","mailchimp-mcp-config":"scripts/setup-cli.js","mailchimp-mcp-install":"scripts/installer.js","mailchimp-mcp-sync":"scripts/sync-from-web.js","mailchimp-mcp-post-install-sync":"scripts/post-install-sync.js","mailchimp-mcp-uninstall":"scripts/uninstall.js"},"keywords":["mcp","mailchimp","model-context-protocol","claude","email-marketing","email-marketing-automation","marketing-analytics","customer-success","marketing-intelligence","campaign-management","audience-segmentation","ai-assistant","marketing-automation","claude-desktop","ai-marketing","mailchimp ai","mailchimp claude desktop","mailchimp mcp","ai mailchimp integration","mailchimp automation ai","mailchimp ai assistant","mailchimp zapier alternative","mailchimp make alternative"],"author":{"name":"alien-lifestyles"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles.git"},"homepage":"https://alienlifestyles.com","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","dompurify":"^3.3.0","dotenv":"^16.4.5","express":"^5.1.0","express-rate-limit":"^8.2.1","jsdom":"^27.1.0","open":"^10.2.0","zod":"^3.23.8"},"devDependencies":{"@types/express":"^5.0.5","@types/node":"^20.14.12","@vitest/coverage-v8":"^4.0.8","@vitest/ui":"^4.0.8","pino":"^10.1.0","pino-pretty":"^13.1.2","tsup":"^8.2.3","tsx":"^4.16.2","typescript":"^5.5.4","vitest":"^4.0.8"},"engines":{"node":">=20.0.0"},"_id":"@alien-lifestyles/mailchimp-mcp@0.4.1","gitHead":"b2715c9b7159782d55bc3a21998d56c9451094d4","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles/issues"},"_nodeVersion":"24.6.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-+xJNE2qYZIADIMWjLrdStbBInTtQ2EUD5EiBxiBkWik+X3HbHrCaRa5BLG+mzM6pX0biQ4ghE3dwTbS0IHAInA==","shasum":"29f53142341a64e8f6619dd87d5472d9fa39e044","tarball":"https://registry.npmjs.org/@alien-lifestyles/mailchimp-mcp/-/mailchimp-mcp-0.4.1.tgz","fileCount":29,"unpackedSize":1574633,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIE5KXH+3kwHw545WFLfGu9+4yz2nHXHV3c+36T6M8eRHAiEA8sCXdqIvA6gUen/LMm/52K2o/yLYnXUDZgiYV1h74Lw="}]},"_npmUser":{"name":"alienlifestyles","email":"mikefortoday@gmail.com"},"directories":{},"maintainers":[{"name":"alienlifestyles","email":"mikefortoday@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mailchimp-mcp_0.4.1_1763063038413_0.5028879303640905"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-09T23:08:21.332Z","modified":"2025-11-13T19:43:58.945Z","0.2.0":"2025-11-09T23:08:21.621Z","0.2.1":"2025-11-09T23:23:00.980Z","0.4.0":"2025-11-11T02:19:48.372Z","0.4.1":"2025-11-13T19:43:58.641Z"},"bugs":{"url":"https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles/issues"},"author":{"name":"alien-lifestyles"},"license":"MIT","homepage":"https://alienlifestyles.com","keywords":["mcp","mailchimp","model-context-protocol","claude","email-marketing","email-marketing-automation","marketing-analytics","customer-success","marketing-intelligence","campaign-management","audience-segmentation","ai-assistant","marketing-automation","claude-desktop","ai-marketing","mailchimp ai","mailchimp claude desktop","mailchimp mcp","ai mailchimp integration","mailchimp automation ai","mailchimp ai assistant","mailchimp zapier alternative","mailchimp make alternative"],"repository":{"type":"git","url":"git+https://github.com/alien-lifestyles/Mailchimp-MCP-by-Alien-Lifestyles.git"},"description":"The only local-first, AI-native Mailchimp assistant. Get CSM intelligence, marketing analytics, and campaign execution—all through Claude Desktop conversations. Free read-only tier available. Upgrade for full automation.","maintainers":[{"name":"alienlifestyles","email":"mikefortoday@gmail.com"}],"readme":"# Mailchimp MCP: Your AI-Powered Mailchimp Assistant\n\n**Stop clicking. Start conversing.**\n\nTransform Mailchimp from a tool you manage into an intelligent assistant that manages, analyzes, and optimizes your email marketing—all through natural conversation with Claude.\n\n**The Problem:** Mailchimp's UI is powerful but complex. Campaign analysis takes hours. Account health monitoring is reactive. Campaign creation requires memorizing workflows.\n\n**The Solution:** Mailchimp MCP makes Mailchimp conversational. Ask Claude to analyze campaigns, monitor account health, or create campaigns—and it happens instantly.\n\n**Why It's Different:**\n- ✅ **Local-first:** Your data stays on your machine (unlike Zapier/Make)\n- ✅ **AI-native:** Built for Claude, not retrofitted\n- ✅ **Three-in-one:** CSM intelligence + Marketing Analyst + Campaign Execution\n- ✅ **Free to start:** Full read access with AI insights (no credit card)\n\n> 📚 **Documentation**: See [docs/README.md](./docs/README.md) for complete documentation index.  \n> 🚀 **Quick Start**: See [INSTALL.md](./INSTALL.md) for installation instructions.\n\n## What Is Mailchimp MCP?\n\nMailchimp MCP is your AI-powered Customer Success Manager, Marketing Analyst, and Campaign Strategist—all in one. Instead of clicking through Mailchimp's interface, you simply have a conversation with Claude:\n\n- **\"Show me my top performing campaigns this month\"** → Instant analysis with recommendations\n- **\"Create a product launch campaign for next Tuesday\"** → Campaign created in minutes\n- **\"Which accounts are at risk of churning?\"** → Proactive account health insights\n\n### Three Ways to Use Mailchimp MCP\n\n**🤖 AI CSM (Customer Success Manager)**\n- **For:** Agencies and CSMs managing client accounts\n- **Value:** Stop reacting to churn—prevent it. AI CSM monitors client Mailchimp accounts 24/7, flags risks before they become problems, and suggests retention strategies through natural conversation.\n- **Why Now:** Managing 5+ client accounts, need proactive monitoring, want to prevent churn not react to it\n\n**📊 AI Analyst (Marketing Intelligence)**\n- **For:** Marketers, marketing directors, and growth teams\n- **Value:** Turn 3-hour campaign analysis into 2-minute conversations. Get strategic recommendations, not just data dumps. AI Analyst reads your Mailchimp data and tells you what to do next.\n- **Why Now:** Managing 10+ campaigns/month, spending 5+ hours/week in Mailchimp UI, need faster analysis, want strategic insights\n\n**✍️ AI Marketer (Campaign Execution)**\n- **For:** Business owners, solo marketers, and marketing managers\n- **Value:** Skip the Mailchimp learning curve. Create campaigns, manage audiences, and automate workflows by simply telling Claude what you want. No UI memorization required.\n- **Why Now:** Solo marketer or small team, want to skip UI learning curve, need campaign creation without complexity\n\n## 🔒 Security & Privacy\n\n**Local-First Architecture:** All data processing happens on your machine. No cloud storage of your Mailchimp data.\n\n**Privacy Controls:** Optional PII masking protects sensitive information in AI conversations.\n\n**Best Practices:** Use read-only API keys, enable PII masking for sensitive accounts, review conversation history regularly.\n\n[Full Security Documentation →](./SECURITY.md)\n\n## Prerequisites\n\nBefore installing Mailchimp MCP, make sure you have:\n\n**Quick Checklist:**\n- [ ] **Claude Desktop** - Free download, no subscription required ([Download](https://claude.ai/download))\n- [ ] **Mailchimp Account** - Any plan with API access (free plan works!)\n- [ ] **Node.js 20+** - Required runtime ([Download](https://nodejs.org/))\n- [ ] **Compatible OS** - macOS 11+, Windows 10+, or Linux\n\n> 📚 **Need more details?** See the [Prerequisites and Setup Guide](./docs/prerequisites-and-setup.md) for comprehensive information about:\n> - Account requirements (Claude Desktop, Mailchimp plans)\n> - Complementary tools (Canva MCP, Python reporting tools)\n> - Setting up for immediate \"Aha!\" moments\n> - System requirements and optional tools\n\n## Quick Start\n\n> 💡 **New to Mailchimp MCP?** See [INSTALL.md](./INSTALL.md) for detailed installation instructions and troubleshooting.\n\n### 🚀 Installation Options\n\n#### Option 1: macOS Installer App (Recommended for macOS)\n\nDownload the DMG file from [GitHub Releases](https://github.com/alien-lifestyles/mailchimp-mcp-alien-lifestyles/releases):\n\n1. Download `MailchimpMCPInstaller.dmg`\n2. Open the DMG file\n3. Double-click `MailchimpMCPInstaller.app`\n4. Follow the installation wizard\n5. Enter your Mailchimp API key when prompted\n6. Restart Claude Desktop\n\nThe installer will:\n- ✅ Check prerequisites (Node.js, npm)\n- ✅ Install the package globally\n- ✅ Launch the setup UI in your browser\n- ✅ Automatically configure Claude Desktop\n- ✅ Validate that Claude Desktop will auto-start Mailchimp MCP\n\n**Uninstaller:** The DMG also includes `MailchimpMCPUninstaller.app` to completely remove Mailchimp MCP and all associated data.\n\n#### Option 2: Command Line (All Platforms)\n\n**For macOS:**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/alien-lifestyles/mailchimp-mcp-alien-lifestyles/main/install.sh | bash\n```\n\n**For All Platforms (using npx):**\n\n```bash\nnpx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-install\n```\n\n**Manual Install:**\n\n```bash\nnpm install -g @alien-lifestyles/mailchimp-mcp && mailchimp-mcp-setup\n```\n\n### 📝 Step-by-Step Installation\n\n**Step 1: Install**\n\n```bash\nnpm install -g @alien-lifestyles/mailchimp-mcp\n```\n\n**Step 2: Run Setup**\n\n```bash\nmailchimp-mcp-setup\n```\n\nOr use the shorter command:\n\n```bash\nmailchimp-mcp-config\n```\n\nOr if installed locally:\n```bash\nnpm run setup\n```\n\n**Step 3: Configure**\n\nThe setup UI will open in your browser at `http://localhost:3000`. Enter:\n- ✅ Your Mailchimp API key (required)\n- ✅ Server prefix (auto-detected from API key)\n- ⭐ License key (optional - for paid features)\n- 🔒 Privacy settings (PII masking recommended)\n\n**Step 4: Restart Claude Desktop**\n\nAfter saving your configuration, restart Claude Desktop completely for changes to take effect.\n\n**Step 5: Test**\n\nAsk Claude: \"Can you run mc_ping?\" to verify the connection.\n\n### 🗑️ Uninstallation\n\nMailchimp MCP can be uninstalled cleanly without affecting other MCP servers in your Claude Desktop config.\n\n**Quick Uninstall (CLI):**\n```bash\nnpx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-uninstall\n```\n\n**Options:**\n```bash\n# Remove config and .env files\nnpx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-uninstall --remove-env\n\n# Remove everything including npm package\nnpx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-uninstall --remove-env --remove-package\n```\n\n**macOS Uninstaller App:**\nIf you installed via the macOS DMG, use `MailchimpMCPUninstaller.app` from the DMG.\n\n**What Gets Removed:**\n- ✅ Mailchimp MCP entry from Claude Desktop config\n- ✅ Old key names (`mailchimp-mcp`, `Mailchimp MCP (Trial)`, `Mailchimp MCP`)\n- ✅ .env files (if `--remove-env` flag used)\n- ✅ npm package (if `--remove-package` flag used)\n\n**What Gets Preserved:**\n- ✅ All other MCP servers in your Claude Desktop config\n- ✅ Other configuration values\n\nSee [INSTALL.md](./INSTALL.md#uninstallation) for detailed uninstall instructions.\n\n## Your First 5 Minutes\n\nAfter installation, follow this progressive flow to see immediate value:\n\n**Minute 1: Verify Connection**\n- Prompt: \"Can you run mc_ping?\"\n- Expected: Connection confirmation\n- Success indicator: \"Connected to Mailchimp\"\n\n**Minute 2: Quick Health Check**\n- Prompt: \"Give me an account health summary\"\n- Expected: High-level overview\n- Success indicator: See audiences, recent campaigns, key metrics\n\n**Minute 3: Performance Snapshot**\n- Prompt: \"What's my best performing campaign?\"\n- Expected: Campaign analysis with metrics\n- Success indicator: See open rates, click rates, recommendations\n\n**Minute 4: Audience Insights**\n- Prompt: \"How many subscribers do I have and how are they growing?\"\n- Expected: Audience growth analysis\n- Success indicator: See subscriber counts, growth trends\n\n**Minute 5: Campaign Analysis**\n- Prompt: \"Analyze my last 5 campaigns and give me recommendations\"\n- Expected: Strategic insights\n- Success indicator: See performance patterns, optimization suggestions\n\n**After 5 Minutes:**\nYou've seen the power of AI Analyst (free). Ready to create campaigns? Upgrade to Execute.\n\n**Pro Tip:** Start with read-only queries to understand your data, then explore write capabilities with the paid version.\n\n### 🔄 Accessing Configuration Anytime\n\nYou can access the configuration page at any time to update your API keys, license key, or privacy settings:\n\n```bash\nmailchimp-mcp-config\n```\n\nOr use the original command:\n\n```bash\nmailchimp-mcp-setup\n```\n\nBoth commands launch the same setup UI in your browser at `http://localhost:3000`. Changes take effect after you save and restart Claude Desktop.\n\n### 🔄 Changing API Keys or Switching Accounts\n\n**Important:** When you change your Mailchimp API key (e.g., switching from a dev account to a production account), Claude Desktop caches MCP resources (like audience names) from the previous API key.\n\n**To see resources from your new API key:**\n\n1. Save your new API key using `mailchimp-mcp-config` or the native config window\n2. **Completely quit Claude Desktop** (⌘Q on macOS, or close all windows)\n3. **Reopen Claude Desktop** - it will reconnect to the MCP server with your new API key\n4. The resource list will refresh with audiences from your new account\n\n**Why this happens:** Claude Desktop caches MCP resources for performance. When you change API keys, the cache still contains data from the old key until Claude Desktop restarts and reconnects to the MCP server.\n\n**Note:** If you see old audience names after restarting, verify that:\n- Your new API key is correctly saved in `claude_desktop_config.json`\n- Claude Desktop has fully restarted (not just minimized/reopened)\n- The MCP server is connecting with the new API key (check Claude Desktop's MCP connection status)\n\n### 🔧 Manual Configuration (Advanced)\n\nIf you prefer manual setup, create a `.env` file:\n\n```bash\n# Required\nMAILCHIMP_API_KEY=your_api_key_here-us9\nMAILCHIMP_SERVER_PREFIX=us9\n\n# Optional\nMAILCHIMP_LICENSE_KEY=ALIEN-XXXX-XXXX-XXXX\nMAILCHIMP_MASK_PII=true\n```\n\nThen manually edit Claude Desktop config at:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\nAdd:\n\n```json\n{\n  \"mcpServers\": {\n    \"mailchimp-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/@alien-lifestyles/mailchimp-mcp/dist/index.js\"],\n      \"cwd\": \"/path/to/@alien-lifestyles/mailchimp-mcp\",\n      \"env\": {\n        \"MAILCHIMP_API_KEY\": \"your_api_key_here-us9\",\n        \"MAILCHIMP_SERVER_PREFIX\": \"us9\",\n        \"MAILCHIMP_MASK_PII\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Explore vs. Execute\n\nMailchimp MCP offers two tiers designed for different workflows:\n\n### 🆓 AI Analyst (Free - Explore) - \"The Explorer\"\n\n**Who:** Marketers analyzing performance, CSMs reviewing accounts, business owners understanding data\n\n**What you get:**\n- ✅ Full read-only access to audiences, campaigns, reports\n- ✅ AI-powered performance analysis and insights\n- ✅ 5 top-value prompts across all personas (Account Manager, Marketer, Business Owner) with visual dashboards\n- ✅ Campaign benchmarking and content analysis\n- ✅ Account health monitoring (read-only)\n\n**Value:** Understand your Mailchimp data with AI-powered insights. Full read access, perfect for analysis and reporting.\n\n**Limitation:** You can see what's happening, but can't make changes.\n\n**Upgrade Trigger:** When you're ready to act on insights—create campaigns, manage audiences, automate workflows—upgrade to Execute.\n\n### 💎 AI Marketer + CSM (Paid - Execute) - \"The Executor\"\n\n**Who:** Marketers creating campaigns, CSMs managing client accounts, business owners executing strategy\n\n**What you get:**\n- ✅ Everything in AI Analyst, plus:\n- ✅ Full write access (create, update, delete)\n- ✅ All prompts (CSM, Marketer, Business Owner)\n- ✅ Campaign creation and automation\n- ✅ Audience and member management\n- ✅ Template and file management\n- ✅ Account management workflows\n\n**Value:** From insights to execution. Create campaigns, manage audiences, automate workflows—all through conversation.\n\n**Differentiation:** Everything in Explorer, plus the power to execute.\n\n**Get started:** Requires license key from [alienlifestyles.com](https://alienlifestyles.com) - $10/month\n\n**Upgrade Messaging:**\n- \"You've analyzed your data. Now execute on insights.\"\n- \"Ready to create campaigns? Upgrade to Execute.\"\n- \"From understanding to action—upgrade when ready.\"\n\n## Available Tools\n\nTools are organized by use case to help Claude select the right tools for your needs.\n\n### Account Health Monitoring\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_getAccount` | Get account overview and settings | Free |\n| `mc_listCampaigns` | List all campaigns with filters | Free |\n| `mc_getCampaignReport` | Get comprehensive campaign performance analytics including open rates, click rates, revenue, and engagement metrics. Use when analyzing campaign effectiveness or preparing performance reports. Returns detailed metrics with AI-ready data for insights. | Free |\n\n### Campaign Creation\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_createCampaign` | Create new campaign with settings | Paid |\n| `mc_setCampaignContent` | Set campaign HTML/content | Paid |\n| `mc_sendCampaign` | Send campaign to audience | Paid |\n| `mc_updateCampaign` | Update campaign settings | Paid |\n| `mc_deleteCampaign` | Delete campaign | Paid |\n\n### Audience Analysis\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_listAudiences` | List all audiences | Free |\n| `mc_getAudience` | Get audience details and settings | Free |\n| `mc_listMembers` | List members in audience with filters | Free |\n| `mc_getMember` | Get member details and activity | Free |\n\n### Audience Management\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_createAudience` | Create new audience | Paid |\n| `mc_updateAudience` | Update audience settings | Paid |\n| `mc_deleteAudience` | Delete audience | Paid |\n| `mc_createMember` | Add member to audience | Paid |\n| `mc_updateMember` | Update member information | Paid |\n| `mc_deleteMember` | Delete member from audience | Paid |\n\n### Segmentation & Targeting\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_createSegment` | Create segment with criteria | Paid |\n| `mc_updateSegment` | Update segment criteria | Paid |\n| `mc_deleteSegment` | Delete segment | Paid |\n| `mc_createTag` | Create tag | Paid |\n| `mc_addTagToMember` | Add/remove tags from member | Paid |\n| `mc_deleteTag` | Delete tag | Paid |\n\n### Templates & Files\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_createTemplate` | Create template with MTL validation | Paid |\n| `mc_updateTemplate` | Update template | Paid |\n| `mc_deleteTemplate` | Delete template | Paid |\n| `mc_uploadFile` | Upload file to File Manager | Paid |\n| `mc_deleteFile` | Delete file from File Manager | Paid |\n| `mc_createTemplateFolder` | Create template folder | Paid |\n| `mc_deleteTemplateFolder` | Delete template folder | Paid |\n| `mc_createFileFolder` | Create file folder | Paid |\n| `mc_deleteFileFolder` | Delete file folder | Paid |\n\n### Domain Management\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_listVerifiedDomains` | List verified domains | Free |\n| `mc_getVerifiedDomain` | Get domain authentication status | Free |\n| `mc_createVerifiedDomain` | Add domain for verification | Paid |\n| `mc_deleteVerifiedDomain` | Delete verified domain | Paid |\n| `mc_sendDomainVerificationEmail` | Send domain verification email | Paid |\n\n### Connection & Testing\n\n| Tool | Description | Tier |\n|------|-------------|------|\n| `mc_ping` | Test connection to Mailchimp API | Free |\n\n### Write Tools (Paid Only - Additional)\n\n| Tool | Description |\n|------|-------------|\n| **Merge Fields** | |\n| `mc_createMergeField` | Create merge field | Paid |\n| `mc_updateMergeField` | Update merge field | Paid |\n| `mc_deleteMergeField` | Delete merge field | Paid |\n| **E-commerce Stores** | |\n| `mc_deleteStore` | Delete e-commerce store (Note: Mailchimp Stores API is read-only - stores must be deleted via web interface) | Paid |\n\n## Example Queries\n\n- \"List my Mailchimp audiences\"\n- \"How many subscribers do I have?\"\n- \"Show me my recent campaigns\"\n- \"What's my top performing campaign?\"\n- \"Check my domain authentication status\"\n\nSee [USE_CASES.md](./USE_CASES.md) for more examples.\n\n### Top Use Cases by Role\n\n**For Marketers:**\n- Campaign performance analysis and optimization\n- Content strategy insights and recommendations\n- Audience segmentation and targeting\n- ROI measurement and business intelligence\n\n**For CSMs:**\n- Account health monitoring and churn risk detection\n- Feature adoption analysis and recommendations\n- Automated account reviews and reporting\n- Proactive client management\n\n**For Business Owners:**\n- Quick campaign creation through conversation\n- Audience growth tracking and insights\n- Simple monthly performance summaries\n- List health monitoring\n\n**For Agencies:**\n- Scale client account management across multiple Mailchimp accounts\n- Proactive churn detection (prevent vs. react)\n- Consistent reporting across client accounts\n- Time savings = more billable hours\n\n[Explore all use cases →](./USE_CASES.md)\n\n## Agency & CSM Adoption\n\n### For Agencies\n\n**Value Proposition:** Manage 10+ client Mailchimp accounts without the manual work. AI CSM monitors account health 24/7, flags churn risks proactively, and generates client-ready reports—all through Claude conversations.\n\n**Key Benefits:**\n- **One license, unlimited client accounts** - Scale account management efficiently\n- **Time savings = more billable hours** - Automate monitoring and reporting\n- **Prevent churn = retain clients** - Proactive account health monitoring\n- **Consistent reporting** - Generate client-ready reports across all accounts\n\n**Use Cases:**\n- Multi-client account health monitoring\n- Proactive churn prevention\n- Automated client reporting\n- Scalable account management\n\n**Pricing Angle:** One license covers all your client accounts. Time savings translate directly to more billable hours and better client retention.\n\n### For CSMs\n\n**Value Proposition:** Transform Mailchimp from a marketing tool into a customer success platform. Monitor account health, detect churn risks, and generate retention strategies—all through AI-powered conversations.\n\n**Key Benefits:**\n- **Prevent one churn = 10x ROI** - Proactive monitoring prevents revenue loss\n- **Proactive vs. reactive = better retention** - Flag risks before they escalate\n- **Automated monitoring = scalable CSM** - Monitor more accounts with less effort\n- **Use Mailchimp as retention system** - Leverage email engagement data for success metrics\n\n**Use Cases:**\n- Account health monitoring\n- Churn risk detection before escalation\n- Feature adoption analysis\n- Retention strategy generation\n\n**Pricing Angle:** Prevent one churn and the ROI pays for itself. Automated monitoring scales your CSM efforts without scaling costs.\n\n## Environment Variables\n\n| Variable | Description | Required | Default |\n|----------|-------------|----------|---------|\n| `MAILCHIMP_API_KEY` | Mailchimp API key (with datacenter suffix) | Yes | - |\n| `MAILCHIMP_SERVER_PREFIX` | Datacenter prefix (e.g., `us9`) | Yes | `us21` |\n| `MAILCHIMP_LICENSE_KEY` | License key for paid version | No | - |\n| `MAILCHIMP_MCP_BACKEND_URL` | Backend API URL for license validation and OAuth | No | `http://localhost:3001` |\n| `MAILCHIMP_READONLY` | Enable read-only mode | No | `true` |\n| `MAILCHIMP_MASK_PII` | Mask email addresses and PII | No | `false` |\n\n## FAQ\n\n### Can I upgrade from AI Analyst to AI Marketer + CSM later?\nYes! You can upgrade at any time. Simply subscribe to AI Marketer + CSM and all features will be immediately available. Start with AI Analyst (free) to explore, then upgrade when ready to execute campaigns.\n\n### Is AI Marketer + CSM a monthly subscription?\nYes! AI Marketer + CSM is $10/month and can be cancelled anytime. You'll have access to all features as long as your subscription is active.\n\n### What's the difference between \"Explore\" and \"Execute\"?\nAI Analyst (Explore) gives you read-only access to analyze your Mailchimp data with AI insights—perfect for understanding performance and getting recommendations. AI Marketer + CSM (Execute) adds full write access so you can create campaigns, manage audiences, set up automation, and execute your email marketing strategy through conversation.\n\n### Which tier is right for me?\nIf you primarily need to analyze campaigns and understand your data, start with AI Analyst (free). If you need to create campaigns, manage audiences, set up automation, or manage client accounts, upgrade to AI Marketer + CSM.\n\n### What prompts are included with each tier?\nAI Analyst includes 5 top-value prompts across all personas (Account Manager, Marketer, Business Owner) with visual dashboards and consistent reports. AI Marketer + CSM includes all prompts organized by persona covering account management, campaign creation, audience analysis, and more.\n\n## Troubleshooting\n\n### API Key Invalid\n- Verify API key is correct and active in Mailchimp\n- Ensure datacenter prefix matches (e.g., `us9` in key and `MAILCHIMP_SERVER_PREFIX`)\n- Use full, unmasked API key including datacenter suffix\n\n### Claude Desktop Connection Issues\n- Verify paths in `claude_desktop_config.json` are correct\n- Ensure `dist/index.js` exists (run `npm run build`)\n- Check Claude Desktop logs: Settings → Developer → View Logs\n- Restart Claude Desktop after configuration changes\n\n### Still Stuck?\n- Check the [Installation Guide](./INSTALL.md) for detailed troubleshooting\n- Review [Security Documentation](./SECURITY.md) for configuration issues\n- Open an issue on [GitHub](https://github.com/alien-lifestyles/mailchimp-mcp-alien-lifestyles/issues)\n\n## Development\n\n```bash\nnpm run dev           # Development mode with watch\nnpm run build         # Build project\nnpm start             # Run built server\nnpm run setup         # Launch setup UI\nnpm run build:installer  # Build macOS installer and uninstaller apps (requires Xcode)\n```\n\n## 📚 Documentation Navigation\n\n**New to Mailchimp MCP?**\n→ Start with [Quick Start Guide](./QUICK_START.md) or [Installation Guide](./INSTALL.md)\n\n**Ready to explore use cases?**\n→ See [Use Cases](./USE_CASES.md) organized by role (Marketer, CSM, Business Owner)\n\n**Installing for the first time?**\n→ Follow [Installation Guide](./INSTALL.md) for step-by-step instructions\n\n**Security concerns?**\n→ Review [Security Documentation](./SECURITY.md) for comprehensive security information\n\n**Want to understand the architecture?**\n→ Check [Documentation Index](./docs/README.md) for technical details\n\n## Security\n\n- Never commit your `.env` file\n- Enable PII masking (`MAILCHIMP_MASK_PII=true`)\n- Use read-only API keys when possible\n- Review [SECURITY.md](./SECURITY.md) for comprehensive security documentation\n- Claude Desktop stores conversation history locally\n\n## Contributing\n\nContributions welcome. Ensure code follows TypeScript best practices and includes proper input validation.\n\n## License\n\nMIT\n\n## Support\n\n- Check Troubleshooting section\n- Review [SECURITY.md](./SECURITY.md)\n- Open an issue on GitHub\n","readmeFilename":"README.md"}