Mailchimp MCP by usefulapi is an MCP server published by io.usefulapi, hosted at mailchimp.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 32 tools, including mailchimp_get_account, mailchimp_list_audiences, mailchimp_get_audience, mailchimp_list_members, mailchimp_get_member.
Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
4,178 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the API Root — the authenticated Mailchimp account: account name, total subscribers, contact info, plan and industry stats. REST: GET /.
No parameters.
{
"name": "mailchimp_get_account",
"title": "Get account",
"description": "Get the API Root — the authenticated Mailchimp account: account name, total subscribers, contact info, plan and industry stats. REST: GET /.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List the account's audiences — Mailchimp's `/lists` resource (an audience is a list of subscribers). Paginated, with optional sort. REST: GET /lists.
| Parameter | Type | Description |
|---|---|---|
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| sortDir | string | Sort direction ASC/DESC (Mailchimp `sort_dir`). |
| sortField | string | Field to sort by (Mailchimp `sort_field`): date_created. |
{
"name": "mailchimp_list_audiences",
"title": "List audiences (lists)",
"description": "List the account's audiences — Mailchimp's `/lists` resource (an audience is a list of subscribers). Paginated, with optional sort. REST: GET /lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"sortDir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction ASC/DESC (Mailchimp `sort_dir`)."
},
"sortField": {
"enum": [
"date_created"
],
"type": "string",
"description": "Field to sort by (Mailchimp `sort_field`): date_created."
}
}
},
"annotations": {
"title": "List audiences (lists)",
"readOnlyHint": true
}
}Get a single audience (list) by id, including subscriber stats, default from-name/email and settings. REST: GET /lists/{list_id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | The audience (list) id. |
{
"name": "mailchimp_get_audience",
"title": "Get audience (list)",
"description": "Get a single audience (list) by id, including subscriber stats, default from-name/email and settings. REST: GET /lists/{list_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "string",
"description": "The audience (list) id."
}
}
},
"annotations": {
"title": "Get audience (list)",
"readOnlyHint": true
}
}List members of an audience (list). Paginated, with an optional status filter and sort. REST: GET /lists/{list_id}/members.
| Parameter | Type | Description |
|---|---|---|
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| status | string | Filter by member status (Mailchimp `status`). |
| list_id * | string | The audience (list) id to list members from. |
| sortDir | string | Sort direction ASC/DESC (Mailchimp `sort_dir`). |
| sortField | string | Field to sort by (Mailchimp `sort_field`): timestamp_opt | timestamp_signup | last_changed. |
{
"name": "mailchimp_list_members",
"title": "List members",
"description": "List members of an audience (list). Paginated, with an optional status filter and sort. REST: GET /lists/{list_id}/members.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional",
"archived"
],
"type": "string",
"description": "Filter by member status (Mailchimp `status`)."
},
"list_id": {
"type": "string",
"description": "The audience (list) id to list members from."
},
"sortDir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction ASC/DESC (Mailchimp `sort_dir`)."
},
"sortField": {
"enum": [
"timestamp_opt",
"timestamp_signup",
"last_changed"
],
"type": "string",
"description": "Field to sort by (Mailchimp `sort_field`): timestamp_opt | timestamp_signup | last_changed."
}
}
},
"annotations": {
"title": "List members",
"readOnlyHint": true
}
}Get a single audience member (subscriber) by email or subscriber_hash, including status, merge fields, tags and stats. REST: GET /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash).
| Parameter | Type | Description |
|---|---|---|
| string | Member email address — MD5-hashed (lowercased) into the subscriber_hash for you. | |
| list_id * | string | The audience (list) id. |
| subscriberHash | string | The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`. |
{
"name": "mailchimp_get_member",
"title": "Get member",
"description": "Get a single audience member (subscriber) by email or subscriber_hash, including status, merge fields, tags and stats. REST: GET /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"email": {
"type": "string",
"description": "Member email address — MD5-hashed (lowercased) into the subscriber_hash for you."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
},
"subscriberHash": {
"type": "string",
"description": "The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`."
}
}
},
"annotations": {
"title": "Get member",
"readOnlyHint": true
}
}Search for members across the account (or one audience) by email, name or other fields. Returns exact + full-text matches. REST: GET /search-members.
| Parameter | Type | Description |
|---|---|---|
| query * | string | The search query (email, name, etc.). |
| list_id | string | Restrict the search to this audience (list) id. |
{
"name": "mailchimp_search_members",
"title": "Search members",
"description": "Search for members across the account (or one audience) by email, name or other fields. Returns exact + full-text matches. REST: GET /search-members.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The search query (email, name, etc.)."
},
"list_id": {
"type": "string",
"description": "Restrict the search to this audience (list) id."
}
}
},
"annotations": {
"title": "Search members",
"readOnlyHint": true
}
}List the account's campaigns (email sends). Paginated, with optional type/status/audience filters and sort. REST: GET /campaigns.
| Parameter | Type | Description |
|---|---|---|
| type | string | Filter by campaign type (Mailchimp `type`). |
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| status | string | Filter by campaign status (Mailchimp `status`). |
| list_id | string | Restrict to campaigns sent to this audience (list) id. |
| sortDir | string | Sort direction ASC/DESC (Mailchimp `sort_dir`). |
| sortField | string | Field to sort by (Mailchimp `sort_field`): create_time | send_time. |
{
"name": "mailchimp_list_campaigns",
"title": "List campaigns",
"description": "List the account's campaigns (email sends). Paginated, with optional type/status/audience filters and sort. REST: GET /campaigns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"regular",
"plaintext",
"absplit",
"rss",
"variate"
],
"type": "string",
"description": "Filter by campaign type (Mailchimp `type`)."
},
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"status": {
"enum": [
"save",
"paused",
"schedule",
"sending",
"sent"
],
"type": "string",
"description": "Filter by campaign status (Mailchimp `status`)."
},
"list_id": {
"type": "string",
"description": "Restrict to campaigns sent to this audience (list) id."
},
"sortDir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction ASC/DESC (Mailchimp `sort_dir`)."
},
"sortField": {
"enum": [
"create_time",
"send_time"
],
"type": "string",
"description": "Field to sort by (Mailchimp `sort_field`): create_time | send_time."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true
}
}Get a single campaign by id, including its settings, recipients and send status. REST: GET /campaigns/{campaign_id}.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id. |
{
"name": "mailchimp_get_campaign",
"title": "Get campaign",
"description": "Get a single campaign by id, including its settings, recipients and send status. REST: GET /campaigns/{campaign_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "The campaign id."
}
}
},
"annotations": {
"title": "Get campaign",
"readOnlyHint": true
}
}List campaign reports (aggregate performance for sent campaigns). Paginated, with an optional type filter. REST: GET /reports.
| Parameter | Type | Description |
|---|---|---|
| type | string | Filter reports by campaign type (Mailchimp `type`). |
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
{
"name": "mailchimp_list_reports",
"title": "List reports",
"description": "List campaign reports (aggregate performance for sent campaigns). Paginated, with an optional type filter. REST: GET /reports.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"regular",
"plaintext",
"absplit",
"rss",
"variate"
],
"type": "string",
"description": "Filter reports by campaign type (Mailchimp `type`)."
},
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
}
}
},
"annotations": {
"title": "List reports",
"readOnlyHint": true
}
}Get the report for one campaign — opens, clicks, bounces, unsubscribes and other engagement summary stats. REST: GET /reports/{campaign_id}.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id to fetch the report for. |
{
"name": "mailchimp_get_campaign_report",
"title": "Get campaign report",
"description": "Get the report for one campaign — opens, clicks, bounces, unsubscribes and other engagement summary stats. REST: GET /reports/{campaign_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "The campaign id to fetch the report for."
}
}
},
"annotations": {
"title": "Get campaign report",
"readOnlyHint": true
}
}List the account's classic automations (automated email workflows). Paginated. REST: GET /automations.
| Parameter | Type | Description |
|---|---|---|
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
{
"name": "mailchimp_list_automations",
"title": "List automations",
"description": "List the account's classic automations (automated email workflows). Paginated. REST: GET /automations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
}
}
},
"annotations": {
"title": "List automations",
"readOnlyHint": true
}
}List the account's email templates (saved and pre-built layouts). Paginated, with optional type filter and sort. REST: GET /templates.
| Parameter | Type | Description |
|---|---|---|
| type | string | Filter by template type (Mailchimp `type`: user / base / gallery). |
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| sortDir | string | Sort direction ASC/DESC (Mailchimp `sort_dir`). |
| sortField | string | Field to sort by (Mailchimp `sort_field`): date_created | date_edited | name. |
{
"name": "mailchimp_list_templates",
"title": "List templates",
"description": "List the account's email templates (saved and pre-built layouts). Paginated, with optional type filter and sort. REST: GET /templates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"user",
"base",
"gallery"
],
"type": "string",
"description": "Filter by template type (Mailchimp `type`: user / base / gallery)."
},
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"sortDir": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction ASC/DESC (Mailchimp `sort_dir`)."
},
"sortField": {
"enum": [
"date_created",
"date_edited",
"name"
],
"type": "string",
"description": "Field to sort by (Mailchimp `sort_field`): date_created | date_edited | name."
}
}
},
"annotations": {
"title": "List templates",
"readOnlyHint": true
}
}List an audience's segments and tags (saved segments include static tags). Paginated. REST: GET /lists/{list_id}/segments.
| Parameter | Type | Description |
|---|---|---|
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| list_id * | string | The audience (list) id. |
{
"name": "mailchimp_list_segments",
"title": "List segments",
"description": "List an audience's segments and tags (saved segments include static tags). Paginated. REST: GET /lists/{list_id}/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
}
}
},
"annotations": {
"title": "List segments",
"readOnlyHint": true
}
}List the tags applied to a single audience member (by email or subscriber_hash). Paginated. REST: GET /lists/{list_id}/members/{subscriber_hash}/tags (email → MD5 hash).
| Parameter | Type | Description |
|---|---|---|
| count | integer | Records to return (Mailchimp `count`; default 10, max 1000). |
| string | Member email address — MD5-hashed (lowercased) into the subscriber_hash for you. | |
| offset | integer | Number of records to skip (Mailchimp `offset`, for pagination). |
| list_id * | string | The audience (list) id. |
| subscriberHash | string | The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`. |
{
"name": "mailchimp_list_member_tags",
"title": "List member tags",
"description": "List the tags applied to a single audience member (by email or subscriber_hash). Paginated. REST: GET /lists/{list_id}/members/{subscriber_hash}/tags (email → MD5 hash).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"count": {
"type": "integer",
"maximum": 1000,
"description": "Records to return (Mailchimp `count`; default 10, max 1000).",
"exclusiveMinimum": 0
},
"email": {
"type": "string",
"description": "Member email address — MD5-hashed (lowercased) into the subscriber_hash for you."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of records to skip (Mailchimp `offset`, for pagination)."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
},
"subscriberHash": {
"type": "string",
"description": "The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`."
}
}
},
"annotations": {
"title": "List member tags",
"readOnlyHint": true
}
}Get the HTML and plain-text content of one campaign (draft or sent). REST: GET /campaigns/{campaign_id}/content.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
{
"name": "mailchimp_get_campaign_content",
"title": "Get campaign content",
"description": "Get the HTML and plain-text content of one campaign (draft or sent). REST: GET /campaigns/{campaign_id}/content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
}
}
},
"annotations": {
"title": "Get campaign content",
"readOnlyHint": true
}
}Mailchimp's pre-send review of one campaign: is_ready plus items (type success / warning / error) for the audience, subject, from address, content and plan limits. Use it before mailchimp_schedule_campaign. REST: GET /campaigns/{campaign_id}/send-checklist.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
{
"name": "mailchimp_get_send_checklist",
"title": "Get campaign send checklist",
"description": "Mailchimp's pre-send review of one campaign: is_ready plus items (type success / warning / error) for the audience, subject, from address, content and plan limits. Use it before mailchimp_schedule_campaign. REST: GET /campaigns/{campaign_id}/send-checklist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
}
}
},
"annotations": {
"title": "Get campaign send checklist",
"readOnlyHint": true
}
}Get one classic automation: status, audience, trigger settings, tracking and report summary. Automation flows built in the Customer Journey builder are not in Mailchimp's API. REST: GET /automations/{workflow_id}.
| Parameter | Type | Description |
|---|---|---|
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
{
"name": "mailchimp_get_automation",
"title": "Get automation",
"description": "Get one classic automation: status, audience, trigger settings, tracking and report summary. Automation flows built in the Customer Journey builder are not in Mailchimp's API. REST: GET /automations/{workflow_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id"
],
"properties": {
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
}
}
},
"annotations": {
"title": "Get automation",
"readOnlyHint": true
}
}List the emails of one classic automation in order: subject, delay after the trigger, status, emails sent and report summary. REST: GET /automations/{workflow_id}/emails.
| Parameter | Type | Description |
|---|---|---|
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
{
"name": "mailchimp_list_automation_emails",
"title": "List automation emails",
"description": "List the emails of one classic automation in order: subject, delay after the trigger, status, emails sent and report summary. REST: GET /automations/{workflow_id}/emails.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id"
],
"properties": {
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
}
}
},
"annotations": {
"title": "List automation emails",
"readOnlyHint": true
}
}Get one email of a classic automation: status, subject, preview text, from name, reply-to, delay, recipients and report summary. REST: GET /automations/{workflow_id}/emails/{workflow_email_id}.
| Parameter | Type | Description |
|---|---|---|
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
| workflow_email_id * | string | The automation email id (from mailchimp_list_automation_emails). |
{
"name": "mailchimp_get_automation_email",
"title": "Get automation email",
"description": "Get one email of a classic automation: status, subject, preview text, from name, reply-to, delay, recipients and report summary. REST: GET /automations/{workflow_id}/emails/{workflow_email_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id",
"workflow_email_id"
],
"properties": {
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
},
"workflow_email_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The automation email id (from mailchimp_list_automation_emails)."
}
}
},
"annotations": {
"title": "Get automation email",
"readOnlyHint": true
}
}Add a new member (subscriber) to an audience (list). Note: status "pending" triggers a double-opt-in confirmation email. REST: POST /lists/{list_id}/members.
| Parameter | Type | Description |
|---|---|---|
| tags | array | Array of tag-name strings to apply to the new member. |
| status | string | Subscription status (default "subscribed"; "pending" sends a double-opt-in email). |
| list_id * | string | The audience (list) id to add the member to. |
| merge_fields | object | Merge-field values, e.g. { FNAME: "Ada", LNAME: "Lovelace" }. |
| email_address * | string | The member's email address (required). |
{
"name": "mailchimp_add_member",
"title": "Add member",
"description": "Add a new member (subscriber) to an audience (list). Note: status \"pending\" triggers a double-opt-in confirmation email. REST: POST /lists/{list_id}/members.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"email_address"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of tag-name strings to apply to the new member."
},
"status": {
"enum": [
"subscribed",
"pending",
"unsubscribed",
"cleaned"
],
"type": "string",
"description": "Subscription status (default \"subscribed\"; \"pending\" sends a double-opt-in email)."
},
"list_id": {
"type": "string",
"description": "The audience (list) id to add the member to."
},
"merge_fields": {
"type": "object",
"description": "Merge-field values, e.g. { FNAME: \"Ada\", LNAME: \"Lovelace\" }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"email_address": {
"type": "string",
"description": "The member's email address (required)."
}
}
},
"annotations": {
"title": "Add member",
"destructiveHint": true
}
}Update an existing audience member (by email or subscriber_hash). Only the fields you supply change. REST: PATCH /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash).
| Parameter | Type | Description |
|---|---|---|
| string | Member email address — MD5-hashed (lowercased) into the subscriber_hash for you. | |
| status | string | New subscription status. |
| list_id * | string | The audience (list) id. |
| merge_fields | object | Merge-field values to set, e.g. { FNAME: "Ada" }. |
| subscriberHash | string | The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`. |
{
"name": "mailchimp_update_member",
"title": "Update member",
"description": "Update an existing audience member (by email or subscriber_hash). Only the fields you supply change. REST: PATCH /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"email": {
"type": "string",
"description": "Member email address — MD5-hashed (lowercased) into the subscriber_hash for you."
},
"status": {
"enum": [
"subscribed",
"pending",
"unsubscribed",
"cleaned"
],
"type": "string",
"description": "New subscription status."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
},
"merge_fields": {
"type": "object",
"description": "Merge-field values to set, e.g. { FNAME: \"Ada\" }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"subscriberHash": {
"type": "string",
"description": "The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`."
}
}
},
"annotations": {
"title": "Update member",
"destructiveHint": true
}
}Add and/or remove tags on an audience member (by email or subscriber_hash). `tags` are added (status active); `removeTags` are removed (status inactive). Mailchimp returns HTTP 204 (no body). REST: POST /lists/{list_id}/members/{subscriber_hash}/tags (email → MD5 hash).
| Parameter | Type | Description |
|---|---|---|
| tags | array | Tag names to ADD to the member (mapped to status "active"). |
| string | Member email address — MD5-hashed (lowercased) into the subscriber_hash for you. | |
| list_id * | string | The audience (list) id. |
| removeTags | array | Tag names to REMOVE from the member (mapped to status "inactive"). |
| subscriberHash | string | The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`. |
{
"name": "mailchimp_add_member_tags",
"title": "Add/remove member tags",
"description": "Add and/or remove tags on an audience member (by email or subscriber_hash). `tags` are added (status active); `removeTags` are removed (status inactive). Mailchimp returns HTTP 204 (no body). REST: POST /lists/{list_id}/members/{subscriber_hash}/tags (email → MD5 hash).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tag names to ADD to the member (mapped to status \"active\")."
},
"email": {
"type": "string",
"description": "Member email address — MD5-hashed (lowercased) into the subscriber_hash for you."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
},
"removeTags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tag names to REMOVE from the member (mapped to status \"inactive\")."
},
"subscriberHash": {
"type": "string",
"description": "The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`."
}
}
},
"annotations": {
"title": "Add/remove member tags",
"destructiveHint": true
}
}Archive (soft-remove) an audience member — reversible; this is NOT the permanent-delete action. REST: DELETE /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash). Returns HTTP 204 (no body).
| Parameter | Type | Description |
|---|---|---|
| string | Member email address — MD5-hashed (lowercased) into the subscriber_hash for you. | |
| list_id * | string | The audience (list) id. |
| subscriberHash | string | The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`. |
{
"name": "mailchimp_archive_member",
"title": "Archive member",
"description": "Archive (soft-remove) an audience member — reversible; this is NOT the permanent-delete action. REST: DELETE /lists/{list_id}/members/{subscriber_hash} (email → MD5 hash). Returns HTTP 204 (no body).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"email": {
"type": "string",
"description": "Member email address — MD5-hashed (lowercased) into the subscriber_hash for you."
},
"list_id": {
"type": "string",
"description": "The audience (list) id."
},
"subscriberHash": {
"type": "string",
"description": "The subscriber_hash (MD5 of lowercased email) or contact id, if you have it instead of `email`."
}
}
},
"annotations": {
"title": "Archive member",
"destructiveHint": true
}
}Create a new email campaign as a DRAFT (nothing is sent). Set the audience, an optional saved segment or tag, and the subject, from name and reply-to. Then add content with mailchimp_set_campaign_content and schedule with mailchimp_schedule_campaign. REST: POST /campaigns.
| Parameter | Type | Description |
|---|---|---|
| type | string | regular = HTML email (default); plaintext = text only. |
| title | string | Internal campaign name (recipients do not see it). |
| list_id | string | Audience (list) id to send to (mailchimp_list_audiences). A campaign needs one before it can be scheduled. |
| to_name | string | Custom 'To' name, usually a merge tag such as *|FNAME|*. |
| reply_to | string | Reply-to email address. Mailchimp needs it before a send, on a verified sending domain. |
| from_name | string | The 'from' name (a name, not an email address). |
| template_id | integer | Id of a saved template (mailchimp_list_templates) to take the content from. |
| preview_text | string | Preview text shown after the subject in the inbox. |
| subject_line | string | Subject line of the email. |
| saved_segment_id | integer | Send only to this saved segment or tag of the audience (id from mailchimp_list_segments). Without it the whole audience is the target. |
{
"name": "mailchimp_create_campaign",
"title": "Create campaign draft",
"description": "Create a new email campaign as a DRAFT (nothing is sent). Set the audience, an optional saved segment or tag, and the subject, from name and reply-to. Then add content with mailchimp_set_campaign_content and schedule with mailchimp_schedule_campaign. REST: POST /campaigns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"regular",
"plaintext"
],
"type": "string",
"default": "regular",
"description": "regular = HTML email (default); plaintext = text only."
},
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Internal campaign name (recipients do not see it)."
},
"list_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Audience (list) id to send to (mailchimp_list_audiences). A campaign needs one before it can be scheduled."
},
"to_name": {
"type": "string",
"maxLength": 200,
"description": "Custom 'To' name, usually a merge tag such as *|FNAME|*."
},
"reply_to": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Reply-to email address. Mailchimp needs it before a send, on a verified sending domain."
},
"from_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The 'from' name (a name, not an email address)."
},
"template_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Id of a saved template (mailchimp_list_templates) to take the content from.",
"exclusiveMinimum": 0
},
"preview_text": {
"type": "string",
"maxLength": 500,
"description": "Preview text shown after the subject in the inbox."
},
"subject_line": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Subject line of the email."
},
"saved_segment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Send only to this saved segment or tag of the audience (id from mailchimp_list_segments). Without it the whole audience is the target.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create campaign draft",
"destructiveHint": true
}
}Change the settings or the target of an unsent campaign: subject, preview text, title, from name, reply-to, template, audience or saved segment. Only the fields you pass change. A scheduled campaign must be unscheduled first. REST: PATCH /campaigns/{campaign_id}.
| Parameter | Type | Description |
|---|---|---|
| title | string | Internal campaign name (recipients do not see it). |
| list_id | string | Audience (list) id to send to (mailchimp_list_audiences). A campaign needs one before it can be scheduled. |
| to_name | string | Custom 'To' name, usually a merge tag such as *|FNAME|*. |
| reply_to | string | Reply-to email address. Mailchimp needs it before a send, on a verified sending domain. |
| from_name | string | The 'from' name (a name, not an email address). |
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
| template_id | integer | Id of a saved template (mailchimp_list_templates) to take the content from. |
| preview_text | string | Preview text shown after the subject in the inbox. |
| subject_line | string | Subject line of the email. |
| saved_segment_id | integer | Send only to this saved segment or tag of the audience (id from mailchimp_list_segments). Without it the whole audience is the target. |
{
"name": "mailchimp_update_campaign",
"title": "Update campaign draft",
"description": "Change the settings or the target of an unsent campaign: subject, preview text, title, from name, reply-to, template, audience or saved segment. Only the fields you pass change. A scheduled campaign must be unscheduled first. REST: PATCH /campaigns/{campaign_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Internal campaign name (recipients do not see it)."
},
"list_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Audience (list) id to send to (mailchimp_list_audiences). A campaign needs one before it can be scheduled."
},
"to_name": {
"type": "string",
"maxLength": 200,
"description": "Custom 'To' name, usually a merge tag such as *|FNAME|*."
},
"reply_to": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Reply-to email address. Mailchimp needs it before a send, on a verified sending domain."
},
"from_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The 'from' name (a name, not an email address)."
},
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
},
"template_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Id of a saved template (mailchimp_list_templates) to take the content from.",
"exclusiveMinimum": 0
},
"preview_text": {
"type": "string",
"maxLength": 500,
"description": "Preview text shown after the subject in the inbox."
},
"subject_line": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Subject line of the email."
},
"saved_segment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Send only to this saved segment or tag of the audience (id from mailchimp_list_segments). Without it the whole audience is the target.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update campaign draft",
"destructiveHint": true
}
}REPLACE the content of an unsent campaign with your HTML and/or plain text. Pass html alone and Mailchimp writes the plain-text version. The reply gives the stored sizes; read the content back with mailchimp_get_campaign_content. REST: PUT /campaigns/{campaign_id}/content.
| Parameter | Type | Description |
|---|---|---|
| html | string | Full HTML of the email (max 1 MB). Mailchimp merge tags such as *|FNAME|* and *|UNSUB|* work. |
| plain_text | string | Plain-text version (max 256 KB). For a plaintext campaign this is the content. |
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
{
"name": "mailchimp_set_campaign_content",
"title": "Set campaign content",
"description": "REPLACE the content of an unsent campaign with your HTML and/or plain text. Pass html alone and Mailchimp writes the plain-text version. The reply gives the stored sizes; read the content back with mailchimp_get_campaign_content. REST: PUT /campaigns/{campaign_id}/content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"html": {
"type": "string",
"maxLength": 1048576,
"minLength": 1,
"description": "Full HTML of the email (max 1 MB). Mailchimp merge tags such as *|FNAME|* and *|UNSUB|* work."
},
"plain_text": {
"type": "string",
"maxLength": 262144,
"minLength": 1,
"description": "Plain-text version (max 256 KB). For a plaintext campaign this is the content."
},
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
}
}
},
"annotations": {
"title": "Set campaign content",
"destructiveHint": true
}
}Send a TEST copy of a campaign to up to 10 addresses you name (not to the audience). This sends real emails at once. Mailchimp limits test sends per campaign and per day by plan. REST: POST /campaigns/{campaign_id}/actions/test.
| Parameter | Type | Description |
|---|---|---|
| send_type | string | Which version to send (default html). |
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
| test_emails * | array | Addresses that get the test copy (1-10). |
{
"name": "mailchimp_send_test_email",
"title": "Send campaign test email",
"description": "Send a TEST copy of a campaign to up to 10 addresses you name (not to the audience). This sends real emails at once. Mailchimp limits test sends per campaign and per day by plan. REST: POST /campaigns/{campaign_id}/actions/test.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"test_emails"
],
"properties": {
"send_type": {
"enum": [
"html",
"plaintext"
],
"type": "string",
"default": "html",
"description": "Which version to send (default html)."
},
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
},
"test_emails": {
"type": "array",
"items": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"maxItems": 10,
"minItems": 1,
"description": "Addresses that get the test copy (1-10)."
}
}
},
"annotations": {
"title": "Send campaign test email",
"destructiveHint": true
}
}Schedule a draft campaign to SEND to its audience at a future time. First call previews: the audience, recipient count, subject, time and Mailchimp's send checklist, with no change, and returns a preview_hash. Call again with confirm=true and that preview_hash only after the user approved the preview; without the hash of the current preview nothing is scheduled. A campaign that fails the checklist is refused. Undo with mailchimp_unschedule_campaign before the send time. Scheduling is part of Mailchimp's paid plans. REST: POST /campaigns/{campaign_id}/actions/schedule.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | False previews and changes nothing. True schedules this exact campaign and time after user approval; it needs preview_hash. |
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
| preview_hash | string | The preview_hash of the preview that the user approved. Needed with confirm=true; a changed time, audience, subject or checklist needs a new preview. |
| schedule_time * | string | Send time as ISO 8601 with Z or a UTC offset, e.g. 2026-12-01T15:30:00Z. In the future and on a quarter-hour (:00, :15, :30, :45). |
{
"name": "mailchimp_schedule_campaign",
"title": "Schedule campaign",
"description": "Schedule a draft campaign to SEND to its audience at a future time. First call previews: the audience, recipient count, subject, time and Mailchimp's send checklist, with no change, and returns a preview_hash. Call again with confirm=true and that preview_hash only after the user approved the preview; without the hash of the current preview nothing is scheduled. A campaign that fails the checklist is refused. Undo with mailchimp_unschedule_campaign before the send time. Scheduling is part of Mailchimp's paid plans. REST: POST /campaigns/{campaign_id}/actions/schedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id",
"schedule_time"
],
"properties": {
"confirm": {
"type": "boolean",
"default": false,
"description": "False previews and changes nothing. True schedules this exact campaign and time after user approval; it needs preview_hash."
},
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The preview_hash of the preview that the user approved. Needed with confirm=true; a changed time, audience, subject or checklist needs a new preview."
},
"schedule_time": {
"type": "string",
"maxLength": 40,
"description": "Send time as ISO 8601 with Z or a UTC offset, e.g. 2026-12-01T15:30:00Z. In the future and on a quarter-hour (:00, :15, :30, :45)."
}
}
},
"annotations": {
"title": "Schedule campaign",
"idempotentHint": false,
"destructiveHint": true
}
}Cancel the schedule of a campaign that has not started to send. The campaign becomes a draft again and nothing is deleted. REST: POST /campaigns/{campaign_id}/actions/unschedule.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign). |
{
"name": "mailchimp_unschedule_campaign",
"title": "Unschedule campaign",
"description": "Cancel the schedule of a campaign that has not started to send. The campaign becomes a draft again and nothing is deleted. REST: POST /campaigns/{campaign_id}/actions/unschedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The campaign id (from mailchimp_list_campaigns or mailchimp_create_campaign)."
}
}
},
"annotations": {
"title": "Unschedule campaign",
"destructiveHint": true
}
}Change the subject, preview text, title, from name, reply-to or delay of one email in a classic automation. Only the fields you pass change. Mailchimp allows this only for abandonedBrowse, abandonedCart, emailFollowup and singleWelcome automations, and can refuse while the email is sending: pause it first with mailchimp_pause_automation_emails. The email content is not editable through the Marketing API. REST: PATCH /automations/{workflow_id}/emails/{workflow_email_id}.
| Parameter | Type | Description |
|---|---|---|
| title | string | Internal name of the email (recipients do not see it). |
| reply_to | string | Reply-to email address. Mailchimp needs it before a send, on a verified sending domain. |
| from_name | string | The 'from' name (a name, not an email address). |
| delay_type | string | Delay unit: now (no delay), hour, day or week. |
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
| delay_action | string | What the delay counts from: signup, ecomm_abandoned_browse or ecomm_abandoned_cart. Default: the email's current action. |
| delay_amount | integer | Delay amount, in delay_type units. Pass it with delay_type. |
| preview_text | string | Preview text shown after the subject in the inbox. |
| subject_line | string | Subject line of the email. |
| workflow_email_id * | string | The automation email id (from mailchimp_list_automation_emails). |
{
"name": "mailchimp_update_automation_email",
"title": "Update automation email",
"description": "Change the subject, preview text, title, from name, reply-to or delay of one email in a classic automation. Only the fields you pass change. Mailchimp allows this only for abandonedBrowse, abandonedCart, emailFollowup and singleWelcome automations, and can refuse while the email is sending: pause it first with mailchimp_pause_automation_emails. The email content is not editable through the Marketing API. REST: PATCH /automations/{workflow_id}/emails/{workflow_email_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id",
"workflow_email_id"
],
"properties": {
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Internal name of the email (recipients do not see it)."
},
"reply_to": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Reply-to email address. Mailchimp needs it before a send, on a verified sending domain."
},
"from_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The 'from' name (a name, not an email address)."
},
"delay_type": {
"enum": [
"now",
"hour",
"day",
"week"
],
"type": "string",
"description": "Delay unit: now (no delay), hour, day or week."
},
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
},
"delay_action": {
"enum": [
"signup",
"ecomm_abandoned_browse",
"ecomm_abandoned_cart"
],
"type": "string",
"description": "What the delay counts from: signup, ecomm_abandoned_browse or ecomm_abandoned_cart. Default: the email's current action."
},
"delay_amount": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Delay amount, in delay_type units. Pass it with delay_type."
},
"preview_text": {
"type": "string",
"maxLength": 500,
"description": "Preview text shown after the subject in the inbox."
},
"subject_line": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Subject line of the email."
},
"workflow_email_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The automation email id (from mailchimp_list_automation_emails)."
}
}
},
"annotations": {
"title": "Update automation email",
"destructiveHint": true
}
}Pause one email of a classic automation (pass workflow_email_id) or all its emails (omit it). Paused emails send nothing until started again; queued subscribers wait. REST: POST /automations/{workflow_id}/actions/pause-all-emails or /automations/{workflow_id}/emails/{workflow_email_id}/actions/pause.
| Parameter | Type | Description |
|---|---|---|
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
| workflow_email_id | string | One email to pause; omit to pause every email of the automation. |
{
"name": "mailchimp_pause_automation_emails",
"title": "Pause automation emails",
"description": "Pause one email of a classic automation (pass workflow_email_id) or all its emails (omit it). Paused emails send nothing until started again; queued subscribers wait. REST: POST /automations/{workflow_id}/actions/pause-all-emails or /automations/{workflow_id}/emails/{workflow_email_id}/actions/pause.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id"
],
"properties": {
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
},
"workflow_email_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "One email to pause; omit to pause every email of the automation."
}
}
},
"annotations": {
"title": "Pause automation emails",
"idempotentHint": true,
"destructiveHint": true
}
}Start one email of a classic automation (pass workflow_email_id) or all its emails (omit it). Started emails SEND to every subscriber who meets the trigger, including those already queued. Call with confirm=false first: it previews the automation, audience and emails and returns a preview_hash. After the user approves, repeat with confirm=true and that preview_hash. REST: POST /automations/{workflow_id}/actions/start-all-emails or /automations/{workflow_id}/emails/{workflow_email_id}/actions/start.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | False previews and changes nothing. True starts the emails after user approval; it needs preview_hash. |
| workflow_id * | string | The classic automation id (from mailchimp_list_automations). |
| preview_hash | string | The preview_hash of the preview that the user approved. Needed with confirm=true. |
| workflow_email_id | string | One email to start; omit to start every email of the automation. |
{
"name": "mailchimp_start_automation_emails",
"title": "Start automation emails",
"description": "Start one email of a classic automation (pass workflow_email_id) or all its emails (omit it). Started emails SEND to every subscriber who meets the trigger, including those already queued. Call with confirm=false first: it previews the automation, audience and emails and returns a preview_hash. After the user approves, repeat with confirm=true and that preview_hash. REST: POST /automations/{workflow_id}/actions/start-all-emails or /automations/{workflow_id}/emails/{workflow_email_id}/actions/start.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workflow_id"
],
"properties": {
"confirm": {
"type": "boolean",
"default": false,
"description": "False previews and changes nothing. True starts the emails after user approval; it needs preview_hash."
},
"workflow_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The classic automation id (from mailchimp_list_automations)."
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "The preview_hash of the preview that the user approved. Needed with confirm=true."
},
"workflow_email_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "One email to start; omit to start every email of the automation."
}
}
},
"annotations": {
"title": "Start automation emails",
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tools for Mailchimp, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many subscribers are in each of my audiences?"; "What were the open and click rates of my last campaign?"; "Show my 25 most recently sent campaigns with their send dates.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Mailchimp data. Free plan: 50 tool calls per month. Run mailchimp_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run mailchimp_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run mailchimp_upgrade without a plan: it returns both plans, each with a payment link for the user to open. mailchimp_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.