`mailchimp_list_campaigns`

List Mailchimp Campaigns

Mailchimp

Description

List campaigns in the Mailchimp account with status filtering, server-side title search, sorting, date range filtering, and pagination. Results include web_id, audience name, and send_time for easy identification. Use since_send_time/before_send_time to filter by send date window. Search: passing search routes every page to Mailchimp's /search-campaigns endpoint for accurate server-side matching — ideal for disambiguating campaigns by title. Search results come back most recently sent first, with unsent drafts last; sort_field and sort_dir apply to the unsearched listing, while status, type and the send-date window are applied to search results here. That endpoint returns one batch and accepts no pagination, so a broad search can be capped: when it is, the response carries search_total_matches — Mailchimp's own count of everything that matched, before any filter of yours — and narrowing the search is the only way to reach the rest. Do not subtract count from it: count is what is left after your filters, so the difference is not the number of unreachable campaigns. Paging: repeat the exact same call with cursor set to the previous response's nextCursor — a cursor only continues the call that issued it, and changing any filter (including adding or removing search) invalidates it.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mailchimp_list_campaigns",
    "arguments": {
      "reason": "List all campaigns"
    }
  }
}

hopkin mailchimp -campaigns

Flag	Type	Required	Description
`--limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`--refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`--account`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`--status`	`array`	Optional	Filter campaigns by status. E.g. ["sent", "sending"].
`--type`	`array`	Optional	Filter campaigns by type. E.g. ["absplit", "variate"] to find A/B and multivariate campaigns.
`--search`	`string`	Optional	Full-text search across campaigns via Mailchimp /search-campaigns, so a match need not contain this string literally. Returns one capped batch, most recently sent first — see the tool description for how paging and capping work.
`--sort-field`	`string`	Optional	Sort campaigns by this field. Defaults to create_time (Mailchimp default). Use send_time to get most recently sent campaigns first.
`--sort-dir`	`string`	Optional	Sort direction. ASC for oldest first, DESC for newest first. Defaults to DESC.
`--since-send-time`	`string`	Optional	Only return campaigns sent after this time. ISO 8601 format: 2025-01-01T00:00:00Z
`--before-send-time`	`string`	Optional	Only return campaigns sent before this time. ISO 8601 format: 2025-12-31T23:59:59Z
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "mailchimp": {
      "url": "https://mailchimp.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (12)

Name	Type	Required	Description
`limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.min: 1, max: 100
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`account_id`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`status`	`array`	Optional	Filter campaigns by status. E.g. ["sent", "sending"].
`type`	`array`	Optional	Filter campaigns by type. E.g. ["absplit", "variate"] to find A/B and multivariate campaigns.
`search`	`string`	Optional	Full-text search across campaigns via Mailchimp /search-campaigns, so a match need not contain this string literally. Returns one capped batch, most recently sent first — see the tool description for how paging and capping work.
`sort_field`	`string`	Optional	Sort campaigns by this field. Defaults to create_time (Mailchimp default). Use send_time to get most recently sent campaigns first. `send_time` `create_time`
`sort_dir`	`string`	Optional	Sort direction. ASC for oldest first, DESC for newest first. Defaults to DESC. `ASC` `DESC`
`since_send_time`	`string`	Optional	Only return campaigns sent after this time. ISO 8601 format: 2025-01-01T00:00:00Z
`before_send_time`	`string`	Optional	Only return campaigns sent before this time. ISO 8601 format: 2025-12-31T23:59:59Z
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Examples

List all

{
  "reason": "List all campaigns"
}

hopkin mailchimp -campaigns

Filter by status

{
  "status": [
    "sent",
    "sending"
  ],
  "reason": "List sent campaigns"
}

hopkin mailchimp -campaigns --status sent,sending

Search

{
  "search": "Welcome",
  "reason": "Find welcome campaigns"
}

hopkin mailchimp -campaigns --search Welcome

Latest sent

{
  "status": [
    "sent"
  ],
  "sort_field": "send_time",
  "sort_dir": "DESC",
  "limit": 10,
  "reason": "Get 10 most recently sent campaigns"
}

hopkin mailchimp -campaigns --status sent --sort-field send_time --sort-dir DESC --limit 10

Recent window

{
  "status": [
    "sent"
  ],
  "sort_field": "send_time",
  "sort_dir": "DESC",
  "since_send_time": "2025-04-01T00:00:00Z",
  "reason": "Campaigns sent since April 2025"
}

hopkin mailchimp -campaigns --status sent --sort-field send_time --sort-dir DESC --since-send-time 2025-04-01T00:00:00Z