# Mailchimp tools

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

**Needs:** A Mailchimp account. 7 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](https://docs.plugsight.app/developers/calling-tools.md) for the request and response format.

| Tool                                                        | What it does                     | Kind |
| ----------------------------------------------------------- | -------------------------------- | ---- |
| [`mailchimp_list_audiences`](#mailchimp_list_audiences)     | List Mailchimp audiences         | Read |
| [`mailchimp_list_campaigns`](#mailchimp_list_campaigns)     | List Mailchimp campaigns         | Read |
| [`mailchimp_campaign_report`](#mailchimp_campaign_report)   | Mailchimp campaign report        | Read |
| [`mailchimp_audience_growth`](#mailchimp_audience_growth)   | Mailchimp audience growth        | Read |
| [`mailchimp_find_subscriber`](#mailchimp_find_subscriber)   | Find a Mailchimp subscriber      | Read |
| [`mailchimp_list_automations`](#mailchimp_list_automations) | List Mailchimp automations       | Read |
| [`mailchimp_list_segments`](#mailchimp_list_segments)       | List Mailchimp tags and segments | 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:

```bash
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:

```bash
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. For an A/B test, what was tested, each variation's results and the winner.

| 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:

```bash
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:

```bash
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, average open and click rates, their audience fields (merge fields such as name, birthday, address) and the groups (interests) they're in.

| 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:

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

## mailchimp_list_automations

**List Mailchimp automations** · Read

Classic automations (welcome series, abandoned cart, date-based…) with their status, audience, trigger, emails sent and open and click rates; with include_emails, each email in the series with its delay and results. Mailchimp's API doesn't list Customer Journeys (the newer journey builder), so those aren't included.

| Argument         | Type    | Required | What it is                                                                        |
| ---------------- | ------- | -------- | --------------------------------------------------------------------------------- |
| `include_emails` | boolean | No       | Also list each automation's emails with their delay and results. Default `false`. |
| `account`        | string  | No       | Mailchimp connection id from list_accounts (optional when there's only one)       |

Example request:

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

## mailchimp_list_segments

**List Mailchimp tags and segments** · Read

An audience's tags and saved segments with how many contacts each has. Use the audience id from mailchimp_list_audiences.

| Argument      | Type   | Required | What it is                                                                  |
| ------------- | ------ | -------- | --------------------------------------------------------------------------- |
| `audience_id` | string | Yes      | Audience id from mailchimp_list_audiences                                   |
| `account`     | string | No       | Mailchimp connection id from list_accounts (optional when there's only one) |

Example request:

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

## Related articles

- [Calling tools](https://docs.plugsight.app/developers/calling-tools.md)
- [Errors](https://docs.plugsight.app/developers/errors.md)
- [Authentication](https://docs.plugsight.app/developers/authentication.md)

---

Web version: https://docs.plugsight.app/developers/mailchimp-tools
