KosmoKrator

productivity

Mailchimp MCP, CLI, and Lua Integration for AI Agents

Mailchimp integration docs for AI agents: MCP gateway setup, Mailchimp CLI commands, Lua API reference, credentials, and function schemas.

Mailchimp for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Mailchimp CLIHeadless setup, JSON output, direct function calls. Mailchimp MCPExpose selected tools to local MCP clients. Mailchimp LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
mailchimp
route_slug
mailchimp
package
mailchimp
auth_strategy
api_key
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
mailchimp.mailchimp_list_audiences Read read 2 List all audiences (lists) in the connected Mailchimp account. Returns each audience's ID, name, subscriber count, and other metadata. Supports offset-based pagination via the count and offset parameters.
mailchimp.mailchimp_get_audience Read read 1 Get full details for a single Mailchimp audience (list) by its ID. Returns the audience name, contact information, subscription stats, and default settings.
mailchimp.mailchimp_create_audience Write write 5 Create a new audience (list) in Mailchimp. Requires a name, contact information, permission reminder, and campaign defaults. Returns the newly created audience with its ID.
mailchimp.mailchimp_add_subscriber Write write 5 Add a new subscriber or update an existing one in a Mailchimp audience. Uses a PUT upsert based on the subscriber's email address (MD5 hash). Optionally set merge fields and initial tags. Returns the subscriber record with their ID and status.
mailchimp.mailchimp_get_subscriber Read read 2 Retrieve a subscriber's details from a Mailchimp audience by their email address. Returns the subscriber's status, merge fields, tags, and activity timestamps.
mailchimp.mailchimp_update_subscriber Write write 4 Update an existing subscriber's merge fields and/or status in a Mailchimp audience. Provide the subscriber's email address to identify the record. Returns the updated subscriber details.
mailchimp.mailchimp_search_subscribers Read read 3 Search for subscribers by email address or name across all audiences or within a specific list. Returns matching subscriber records with their list membership and status.
mailchimp.mailchimp_remove_subscriber Write write 2 Remove (archive) a subscriber from a Mailchimp audience by their email address. This archives the member; it does not permanently delete it.
mailchimp.mailchimp_create_campaign Write write 6 Create a new campaign in Mailchimp. Requires a campaign type and the target list_id. Optional settings include subject line, title, from name, and reply-to address. Returns the newly created campaign with its ID and web_id.
mailchimp.mailchimp_get_campaign Read read 1 Get details for a single Mailchimp campaign by its ID. Returns the campaign type, status, settings, recipient list, and send times.
mailchimp.mailchimp_update_campaign Write write 2 Update a Mailchimp campaign's settings such as subject line, title, from name, or reply-to. Provide the campaign ID and a settings object with the fields to update. Returns the updated campaign details.
mailchimp.mailchimp_send_campaign Write write 1 Send a Mailchimp campaign immediately. The campaign must already have content configured and be in a "save" or "paused" state. This action is irreversible — once sent, the campaign cannot be recalled.
mailchimp.mailchimp_list_campaigns Read read 4 List campaigns in the Mailchimp account with offset-based pagination and optional filters. Filter by status (save, paused, schedule, sending, sent) or type (regular, plaintext, absplit, rss, variate). Returns each campaign's ID, title, status, and send time.
mailchimp.mailchimp_tag_subscriber Write write 3 Add or remove tags on a Mailchimp subscriber. Provide an array of tags, each with a name and status ("active" to add, "inactive" to remove).
mailchimp.mailchimp_list_segments Read read 2 List all segments (static and dynamic) for a Mailchimp audience. Returns each segment's ID, name, type, and member count.
mailchimp.mailchimp_add_to_segment Write write 3 Add a subscriber to a Mailchimp static segment by email address. The segment must be a static (not dynamic) segment. Returns the segment membership details.
mailchimp.mailchimp_get_campaign_report Read read 1 Get a detailed report for a sent Mailchimp campaign. Returns send stats (emails sent, bounces), open rates, click rates, and industry benchmarks.
mailchimp.mailchimp_get_current_user Read read 0 Get the authenticated Mailchimp user's account information. Returns account name, email, total subscribers, industry stats, and plan details. Useful for verifying the connection and understanding the account scope.