`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. When the search parameter is provided (without a cursor), routes to Mailchimp's /search-campaigns endpoint for accurate server-side matching sorted by most recent send_time — ideal for campaign disambiguation by title. Results include web_id, audience name, and send_time for easy identification. Use sort_field=send_time with sort_dir=DESC to get the most recently sent campaigns first. Use since_send_time/before_send_time to filter by send date window.

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	Filter campaigns by title (case-insensitive substring match).
`--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	Filter campaigns by title (case-insensitive substring match).
`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