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": "…"}'