Check out our new products...
" - } -}); - -// 3. Send test -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_campaigns_test", - arguments: { - campaign_id: campaign.id, - test_emails: ["test@mybrand.com"], - send_type: "html" - } -}); - -// 4. Send campaign -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_campaigns_send", - arguments: { - campaign_id: campaign.id - } -}); +} ``` ---- - -### Example 2: Add Member with Tags +### Get Campaign Report ```typescript -// Add member to list -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_lists_members_add", - arguments: { - list_id: "abc123", - email_address: "customer@example.com", - status: "subscribed", - merge_fields: { - FNAME: "Jane", - LNAME: "Doe" - } - } -}); - -// Add tags -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_members_tags_add", - arguments: { - list_id: "abc123", - email_address: "customer@example.com", - tags: [ - { name: "VIP", status: "active" }, - { name: "Product-Launch-2024", status: "active" } - ] - } -}); +{ + "campaign_id": "abc123" +} ``` ---- +## ๐งช Testing -### Example 3: Create Automated Welcome Series - -```typescript -// Create automation -const automation = await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_automations_create", - arguments: { - recipients: { - list_id: "abc123" - }, - trigger_settings: { - workflow_type: "emailAdded" - }, - settings: { - title: "Welcome Series", - from_name: "MyBrand", - reply_to: "hello@mybrand.com" - } - } -}); - -// Automation emails are managed via the API or UI -// Start the automation -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_automations_start", - arguments: { - workflow_id: automation.id - } -}); +```bash +npm run typecheck # TypeScript type checking +npm test # Run tests (if configured) ``` ---- - -### Example 4: Track E-commerce Order - -```typescript -// Record an order -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_ecommerce_orders_create", - arguments: { - store_id: "mystore", - order: { - id: "order_12345", - customer: { - id: "customer_abc", - email_address: "customer@example.com", - opt_in_status: true - }, - currency_code: "USD", - order_total: 99.99, - lines: [ - { - id: "line_1", - product_id: "prod_123", - product_variant_id: "var_456", - quantity: 2, - price: 49.99 - } - ] - } - } -}); -``` - ---- - -### Example 5: Analyze Campaign Performance - -```typescript -// Get campaign report -const report = await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_reports_get", - arguments: { - campaign_id: "campaign_xyz" - } -}); - -console.log(`Open Rate: ${(report.opens.open_rate * 100).toFixed(2)}%`); -console.log(`Click Rate: ${(report.clicks.click_rate * 100).toFixed(2)}%`); - -// Get click details -const clicks = await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_reports_click_details", - arguments: { - campaign_id: "campaign_xyz" - } -}); - -// Most clicked link -const topLink = clicks.urls_clicked[0]; -console.log(`Most clicked: ${topLink.url} (${topLink.total_clicks} clicks)`); -``` - ---- - ## ๐๏ธ Architecture ``` -mailchimp-mcp-server/ +mailchimp/ โโโ src/ -โ โโโ index.ts # MCP server entry point +โ โโโ index.ts # MCP server entry point โ โโโ clients/ -โ โ โโโ mailchimp.ts # Mailchimp API client +โ โ โโโ mailchimp.ts # Mailchimp API client +โ โโโ tools/ +โ โ โโโ campaigns-tools.ts +โ โ โโโ lists-tools.ts +โ โ โโโ members-tools.ts +โ โ โโโ automations-tools.ts +โ โ โโโ templates-tools.ts +โ โ โโโ reports-tools.ts +โ โ โโโ landing-pages-tools.ts +โ โ โโโ ecommerce-tools.ts +โ โ โโโ tags-tools.ts +โ โ โโโ search-tools.ts โ โโโ types/ -โ โ โโโ index.ts # TypeScript type definitions -โ โโโ tools/ # Tool implementations (104 tools) -โ โ โโโ campaigns-tools.ts # 15 campaign tools -โ โ โโโ lists-tools.ts # 14 list/audience tools -โ โ โโโ members-tools.ts # 12 member tools -โ โ โโโ templates-tools.ts # 6 template tools -โ โ โโโ automations-tools.ts # 10 automation tools -โ โ โโโ reports-tools.ts # 8 report tools -โ โ โโโ landing-pages-tools.ts # 8 landing page tools -โ โ โโโ ecommerce-tools.ts # 28 e-commerce tools -โ โ โโโ tags-tools.ts # 1 tag tool -โ โ โโโ search-tools.ts # 2 search tools +โ โ โโโ index.ts # TypeScript type definitions โ โโโ ui/ -โ โโโ react-app/ # React MCP apps (15 apps) +โ โโโ react-app/ # 15+ React applications โ โโโ campaign-dashboard/ -โ โโโ campaign-detail/ -โ โโโ campaign-builder/ -โ โโโ audience-dashboard/ -โ โโโ audience-grid/ -โ โโโ member-detail/ -โ โโโ tag-manager/ -โ โโโ automation-dashboard/ -โ โโโ automation-detail/ -โ โโโ report-dashboard/ -โ โโโ report-detail/ -โ โโโ growth-chart/ -โ โโโ ecommerce-dashboard/ -โ โโโ landing-page-grid/ -โ โโโ template-gallery/ -โ โโโ ab-test-results/ -โ โโโ search-results/ -โโโ scripts/ -โ โโโ build-apps.js # React app bundler +โ โโโ audience-manager/ +โ โโโ subscriber-grid/ +โ โโโ ... (12+ more apps) +โโโ dist/ # Compiled JavaScript โโโ package.json โโโ tsconfig.json โโโ README.md ``` ---- +## ๐ License -## ๐ง Development - -### Build - -```bash -npm run build -``` - -Compiles TypeScript and bundles all React apps. - -### Development Mode - -```bash -npm run dev -``` - -Runs TypeScript in watch mode. - -### Type Checking - -```bash -npm run typecheck -``` - ---- - -## ๐ API Documentation - -This MCP server covers the Mailchimp Marketing API v3. For full API documentation: - -- [Mailchimp Marketing API Reference](https://mailchimp.com/developer/marketing/api/) -- [Campaign API Docs](https://mailchimp.com/developer/marketing/api/campaigns/) -- [Lists API Docs](https://mailchimp.com/developer/marketing/api/lists/) -- [Automation API Docs](https://mailchimp.com/developer/marketing/api/automation/) -- [E-commerce API Docs](https://mailchimp.com/developer/marketing/api/ecommerce-stores/) - ---- - -## โก Rate Limiting - -Mailchimp enforces rate limits on API requests (typically 10 requests/second). This MCP server handles rate limiting automatically with exponential backoff and retry logic. - ---- - -## ๐ Security Best Practices - -1. **Never commit API keys** โ use environment variables -2. **Rotate API keys** regularly -3. **Use read-only keys** when possible (Mailchimp doesn't support this yet) -4. **Monitor API usage** in your Mailchimp account -5. **Restrict MCP access** to trusted users/environments - ---- - -## ๐ Troubleshooting - -### "Error: MAILCHIMP_API_KEY environment variable is required" - -Set your API key: -```bash -export MAILCHIMP_API_KEY="your_key-us19" -``` - -### "Invalid API Key" - -Check: -- API key format includes datacenter (e.g., `-us19`) -- API key is active in your Mailchimp account -- No extra spaces or quotes in the environment variable - -### "Rate Limit Exceeded" - -The server will automatically retry with exponential backoff. If persistent: -- Reduce request frequency -- Check Mailchimp account limits -- Consider upgrading Mailchimp plan - -### "List Not Found" - -Ensure you're using the correct `list_id`. Get list IDs via: -```typescript -await use_mcp_tool({ - server_name: "mailchimp", - tool_name: "mailchimp_lists_list" -}); -``` - ---- - -## ๐ Comparison: Mailchimp MCP vs. GoHighLevel MCP - -| Metric | Mailchimp MCP | GoHighLevel MCP | -|--------|---------------|-----------------| -| **Tools** | 104 | 474 | -| **React Apps** | 15 | 65 | -| **API Coverage** | Mailchimp Marketing API v3 | GoHighLevel API v2 | -| **Focus** | Email marketing, automation, e-commerce | CRM, marketing automation, sales funnels | -| **Complexity** | Medium | High | -| **Use Case** | Email campaigns, newsletters, e-commerce stores | Agency/SaaS white-label platform | - -Both servers provide **comprehensive MCP coverage** of their respective platforms with rich UI apps and complete API tool sets. - ---- +MIT ## ๐ค Contributing -Contributions welcome! Please: - -1. Fork the repository -2. Create a feature branch -3. Add tests for new tools -4. Submit a pull request - ---- - -## ๐ License - -MIT License - see LICENSE file for details - ---- - -## ๐ Acknowledgments - -- Built with the [Model Context Protocol SDK](https://modelcontextprotocol.io) -- Powered by [Mailchimp Marketing API v3](https://mailchimp.com/developer/) -- Part of the [MCPEngine](https://github.com/BusyBee3333/mcpengine) project - ---- +Contributions welcome! Please read our contributing guidelines and submit PRs. ## ๐ Support -- **Issues:** [GitHub Issues](https://github.com/BusyBee3333/mcpengine/issues) -- **Documentation:** [MCPEngine Docs](https://github.com/BusyBee3333/mcpengine) -- **Mailchimp API:** [Mailchimp Developer Docs](https://mailchimp.com/developer/) +- [Mailchimp API Documentation](https://mailchimp.com/developer/marketing/api/) +- [MCP Documentation](https://modelcontextprotocol.io/) +- Issues: GitHub Issues + +## ๐ Related + +- [Mailchimp Marketing API v3.0](https://mailchimp.com/developer/marketing/api/) +- [Model Context Protocol](https://modelcontextprotocol.io/) +- [MCPEngine](https://github.com/BusyBee3333/mcpengine) --- -**Made with โค๏ธ by the MCPEngine team** +**Built with โค๏ธ for the MCP community** diff --git a/servers/mailchimp/src/ui/react-app/ab-test-results/app.tsx b/servers/mailchimp/src/ui/react-app/ab-test-results/app.tsx index 08782b9..a1b7a3f 100644 --- a/servers/mailchimp/src/ui/react-app/ab-test-results/app.tsx +++ b/servers/mailchimp/src/ui/react-app/ab-test-results/app.tsx @@ -1,284 +1,21 @@ -import React, { useState, useEffect } from 'react'; -import { createRoot } from 'react-dom/client'; -import { useApp } from '@modelcontextprotocol/ext-apps/react'; +import React, { useState } from 'react'; +import { createMCPClient } from '@modelcontextprotocol/ext-apps'; -function App() { - const app = useApp(); - const [campaignId, setCampaignId] = useState(''); - const [campaign, setCampaign] = useStateLoading A/B test results...
-{error}
- -Enter an A/B test campaign ID:
- setCampaignId(e.target.value)} - placeholder="Campaign ID" - style={{ - padding: 8, - background: '#1e1e1e', - color: '#e0e0e0', - border: '1px solid #333', - borderRadius: 4, - marginRight: 8 - }} - /> - -This campaign (type: {campaign.type}) is not an A/B split test.
-Loading...
Campaign ID: {report.id}
+Loading campaign dashboard...
-{error}
- -| Campaign | -Status | -Sent | -Emails | -Open Rate | -Click Rate | -
|---|---|---|---|---|---|
| {campaign.title} | -- - {campaign.status} - - | -{campaign.send_time ? new Date(campaign.send_time).toLocaleDateString() : '-'} | -{campaign.emails_sent.toLocaleString()} | -{campaign.open_rate ? `${(campaign.open_rate * 100).toFixed(1)}%` : '-'} | -{campaign.click_rate ? `${(campaign.click_rate * 100).toFixed(1)}%` : '-'} | -
Loading...
+Loading e-commerce data...
-Loading...
| Product | -Price | -Variants | -
|---|---|---|
|
- {product.title}
- {product.id}
- |
- - ${parseFloat(product.variants?.[0]?.price || 0).toFixed(2)} - | -{product.variants?.length || 0} | -
| Order ID | -Customer | -Total | -Status | -Date | -
|---|---|---|---|---|
| {order.id} | -{order.customer?.first_name} {order.customer?.last_name} | -- ${parseFloat(order.order_total || 0).toFixed(2)} - | -- - {order.financial_status || 'pending'} - - | -- {order.processed_at_foreign ? new Date(order.processed_at_foreign).toLocaleDateString() : 'โ'} - | -
No e-commerce stores connected
-Loading...
+Loading growth data...
-