PlugsightDocs

Mailchimp tools

Every Mailchimp tool in the developer API, with arguments and examples: audiences, campaigns, reports and subscribers.

Needs: A Mailchimp account. 5 tools.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

Tool What it does Kind
mailchimp_list_audiences List Mailchimp audiences Read
mailchimp_list_campaigns List Mailchimp campaigns Read
mailchimp_campaign_report Mailchimp campaign report Read
mailchimp_audience_growth Mailchimp audience growth Read
mailchimp_find_subscriber Find a Mailchimp subscriber Read

The example requests fill in only the required arguments, with placeholder values.

mailchimp_list_audiences

List Mailchimp audiences · Read

Audiences (lists) with subscribers, unsubscribes, cleaned addresses, average open and click rates and how many campaigns each has had. Use the ids in the other Mailchimp tools.

Argument Type Required What it is
account string No Mailchimp connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/mailchimp_list_audiences \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

mailchimp_list_campaigns

List Mailchimp campaigns · Read

Campaigns, newest first, with subject, audience, emails sent, open and click rates, and orders and revenue when the store is connected to Mailchimp. Filter by status, send date or audience. Use mailchimp_campaign_report for one campaign in full.

Argument Type Required What it is
status string No sent (default), save (drafts), schedule, sending, paused. One of: sent, save, schedule, sending, paused. Default "sent".
sent_from string No YYYY-MM-DD
sent_to string No YYYY-MM-DD
audience_id string No Audience id from mailchimp_list_audiences
limit integer No Most results to return. Default 25.
offset integer No Results to skip, for paging. Default 0.
account string No Mailchimp connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/mailchimp_list_campaigns \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

mailchimp_campaign_report

Mailchimp campaign report · Read

One sent campaign's full results: opens, clicks, bounces, unsubscribes, spam complaints, orders and revenue, how it compares with the audience's average and the industry, and its most-clicked links.

Argument Type Required What it is
campaign_id string Yes Campaign id from mailchimp_list_campaigns
top_links integer No How many most-clicked links to list. Default 10.
account string No Mailchimp connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/mailchimp_campaign_report \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id": "…"}'

mailchimp_audience_growth

Mailchimp audience growth · Read

Month-by-month growth of one audience: new subscribers (opt-ins and imports), unsubscribes, cleaned addresses and the total at month end.

Argument Type Required What it is
audience_id string Yes Audience id from mailchimp_list_audiences
months integer No How many months back. Default 12.
account string No Mailchimp connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/mailchimp_audience_growth \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audience_id": "…"}'

mailchimp_find_subscriber

Find a Mailchimp subscriber · Read

Looks someone up by email address or name across audiences: their status (subscribed, unsubscribed, cleaned), when they joined, tags, rating and average open and click rates.

Argument Type Required What it is
query string Yes Email address, or part of a name or email
audience_id string No Only this audience
account string No Mailchimp connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/mailchimp_find_subscriber \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "…"}'