Mailchimp
Connect Claude, ChatGPT or Cursor to Mailchimp via MCP. Read audiences, campaigns, reports, and search members with a Marketing API key.
Overview
Connect Mailchimp so AI clients can browse audiences, campaigns, performance reports, and search subscribers via the Mailchimp Marketing API.
This integration is read-first: list and search tools only. Creating campaigns, sending email, or updating subscribers is not included.
Prerequisites
- A Mailchimp account with Marketing API access
- Permission to create API keys (Account Owner or Admin)
- A stackgate.ai account
Getting credentials
- Sign in to Mailchimp for the account you want to connect.
- Open your profile menu → Account & billing → Extras → API keys (or Profile → Extras → API keys).
- Create an API key and copy it immediately. Keys end with your datacenter suffix (e.g.
-us1,-us21). - In stackgate.ai, open My Integrations → Mailchimp.
- Paste the Marketing API key and save. stackgate.ai verifies the key against Mailchimp's
/pingendpoint and stores the correct datacenter host. - Optionally use Edit tool access to keep the connection read-only.
See the Mailchimp Marketing API quick start.
Using with AI clients
- Dedicated endpoint:
POST /mcp/mailchimpwith a Sanctum bearer token - Private gateway: one config for all integrations — use
mailchimp__*namespaced tools
Example prompts:
- "List my Mailchimp audiences."
- "Show the report for campaign ID abc123."
- "Search Mailchimp members for john@example.com."
Troubleshooting
- 422 integration not configured — complete the API key form in My Integrations.
- 401 Unauthorized — regenerate the API key in Mailchimp and update My Integrations.
- Invalid datacenter suffix — Mailchimp keys must include the
-us1style suffix from the key creation screen. - 429 Too many requests — Mailchimp limits concurrent connections (about 10). Retry after a short delay or reduce parallel tool calls.
- Empty campaign report — reports are only available for sent campaigns; draft or scheduled campaigns return errors from Mailchimp.
Available tools
-
list_audiences
List Mailchimp audiences (lists) with optional pagination.
-
get_audience
Get a Mailchimp audience (list) by ID, including stats and campaign defaults.
-
list_campaigns
List Mailchimp campaigns with optional status filter and pagination.
-
get_campaign_report
Get performance report metrics for a sent Mailchimp campaign.
-
search_members
Search Mailchimp audience members by email address or name.
MCP endpoint:
https://stackgate.ai/mcp/mailchimp
(HTTP) or via the
private gateway.