KosmoKrator

productivity

Mailchimp MCP Integration for LangGraph

Connect Mailchimp to LangGraph through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

18 functions 9 read 9 write API key auth
Submit Mailchimp feedback View package source

Connect Mailchimp to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Mailchimp MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "mcpServers": {
    "kosmokrator-mailchimp": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=mailchimp",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=mailchimp --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Mailchimp instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Mailchimp Tools Visible to LangGraph

LangGraph sees stable MCP tool names generated from the Mailchimp integration catalog.

MCP toolSource functionTypeDescription
integration__mailchimp__mailchimp_list_audiences mailchimp.mailchimp_list_audiences Read 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.
integration__mailchimp__mailchimp_get_audience mailchimp.mailchimp_get_audience Read Get full details for a single Mailchimp audience (list) by its ID. Returns the audience name, contact information, subscription stats, and default settings.
integration__mailchimp__mailchimp_create_audience mailchimp.mailchimp_create_audience Write 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.
integration__mailchimp__mailchimp_add_subscriber mailchimp.mailchimp_add_subscriber Write 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.
integration__mailchimp__mailchimp_get_subscriber mailchimp.mailchimp_get_subscriber Read Retrieve a subscriber's details from a Mailchimp audience by their email address. Returns the subscriber's status, merge fields, tags, and activity timestamps.
integration__mailchimp__mailchimp_update_subscriber mailchimp.mailchimp_update_subscriber Write 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.
integration__mailchimp__mailchimp_search_subscribers mailchimp.mailchimp_search_subscribers Read 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.
integration__mailchimp__mailchimp_remove_subscriber mailchimp.mailchimp_remove_subscriber Write Remove (archive) a subscriber from a Mailchimp audience by their email address. This archives the member; it does not permanently delete it.
integration__mailchimp__mailchimp_create_campaign mailchimp.mailchimp_create_campaign Write 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.
integration__mailchimp__mailchimp_get_campaign mailchimp.mailchimp_get_campaign Read Get details for a single Mailchimp campaign by its ID. Returns the campaign type, status, settings, recipient list, and send times.
integration__mailchimp__mailchimp_update_campaign mailchimp.mailchimp_update_campaign Write 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.
integration__mailchimp__mailchimp_send_campaign mailchimp.mailchimp_send_campaign Write 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.
integration__mailchimp__mailchimp_list_campaigns mailchimp.mailchimp_list_campaigns Read 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.
integration__mailchimp__mailchimp_tag_subscriber mailchimp.mailchimp_tag_subscriber Write 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).
integration__mailchimp__mailchimp_list_segments mailchimp.mailchimp_list_segments Read List all segments (static and dynamic) for a Mailchimp audience. Returns each segment's ID, name, type, and member count.
integration__mailchimp__mailchimp_add_to_segment mailchimp.mailchimp_add_to_segment Write 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.
integration__mailchimp__mailchimp_get_campaign_report mailchimp.mailchimp_get_campaign_report Read Get a detailed report for a sent Mailchimp campaign. Returns send stats (emails sent, bounces), open rates, click rates, and industry benchmarks.
integration__mailchimp__mailchimp_get_current_user mailchimp.mailchimp_get_current_user Read 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.

Related Mailchimp Pages

Mailchimp CLIUse direct JSON commands instead of MCP discovery. Mailchimp MCPFull gateway reference and MCP tool names. KosmoKrator for LangGraphClient-level gateway setup.