PlugsightDocs

Mailchimp

Connect Mailchimp with an API key so your AI can report on campaign results, audience growth and subscribers. Read-only.

Connect Mailchimp and your AI can tell you how your newsletters are doing: opens, clicks, revenue, unsubscribes and audience growth. You connect with an API key you create in Mailchimp. Plugsight only reads: it never sends, schedules, edits or deletes campaigns, audiences or contacts.

What your AI can do

  • List audiences (lists) with subscribers, unsubscribes, cleaned addresses, average open and click rates, and how many campaigns each has had.
  • List campaigns, newest first, with subject, audience, emails sent, open and click rates, and orders and revenue when your store is connected to Mailchimp. Filter by status (sent, drafts, scheduled, sending or paused), send date or audience.
  • Campaign report for one sent campaign: opens, clicks, bounces, unsubscribes, spam complaints, orders and revenue, how it compares with your audience's average and your industry, and its most-clicked links.
  • Audience growth, month by month: new subscribers (opt-ins and imports), unsubscribes, cleaned addresses and the total at the end of each month.
  • Find a subscriber by email address or name, across audiences: their status (subscribed, unsubscribed, cleaned), when they joined, tags, rating and average open and click rates.

Example questions

  • "Which of last quarter's campaigns had the best click rate, and what did their subject lines have in common?"
  • "How does our latest newsletter compare with our audience average and the industry?"
  • "Is our list growing? Show new subscribers and unsubscribes by month for the last year."
  • "Which links got the most clicks in last week's campaign?"
  • "Is jane@example.com still subscribed, and when did she join?"

What you need

  • Any plan. Mailchimp is in Email marketing, not marketing & analytics, so it's on the Free plan too.
  • A Mailchimp login that can create API keys.

Connect Mailchimp

This takes about a minute.

  1. Log in to Mailchimp and open API keys (or click your profile picture → Profile → Extras → API keys).
  2. Click Create A Key, name it "Plugsight" and click Generate Key.
  3. Copy the key. Mailchimp shows it only once. It ends with something like -us21.
  4. In Plugsight, open Connections, click Add connection and choose Mailchimp.
  5. Paste the key into API key. Optionally give the connection a Name, such as "Newsletter".
  6. Click Test connection & save. Plugsight checks the key with Mailchimp before saving anything.

When it works, you see a message like "Connected Acme Ltd (12,480 subscribers), id "…"."

Then add the connection to an MCP server. If this is your first Mailchimp connection, refresh the tools list in your AI app and start a new chat.

New Mailchimp API keys expire after a year. When yours does, create a new key and connect Mailchimp again with it.

What it can and can't change

Mailchimp is read-only in Plugsight. Your AI can't create, send, schedule or edit campaigns, or add, change or remove contacts.

To cut access, delete the key in Mailchimp under API keys, and remove the connection on Connections.

Limits

  • Campaign lists return up to 100 campaigns at a time (25 by default). Sent campaigns are listed by default.
  • Audience growth covers up to 60 months (12 by default).
  • Campaign reports list up to 50 most-clicked links (10 by default).
  • Up to 100 audiences are listed.
  • Orders and revenue only appear when your online store is connected to Mailchimp.

Troubleshooting

That isn't a Mailchimp API key. It ends with a dash and your data centre, like -us21.

What it means: The key you pasted is incomplete, or isn't a Mailchimp API key.

How to fix it: Copy the whole key again, including the ending such as -us21.

Mailchimp didn't accept that API key. Check you copied all of it, including the ending like -us21, and that it hasn't been deleted.

What it means: Mailchimp doesn't recognise the key.

How to fix it: Check you copied all of it. If it was deleted or you can't copy it again, create a new key.

Mailchimp rejected the API key; it may have been deleted or disabled. Reconnect Mailchimp on the Connections page in Plugsight.

What it means: The key stopped working, for example because it was deleted or it expired. The connection shows Reconnect needed.

How to fix it: Create a new key in Mailchimp and connect Mailchimp again with it.

Mailchimp couldn't find that. Check the id (list tools return valid ids).

What it means: Your AI asked for a campaign or audience that doesn't exist.

How to fix it: Ask your AI to list campaigns or audiences first, then pick one.