Mailchimp MCP Server

Instructions

Implementation Reference

• mcp_mailchimp/server.py:460-484 (handler)

  The `list_members` tool implementation, registered with `@mcp.tool()` and using the Mailchimp API client to fetch list members.

  @mcp.tool()
  async def list_members(
      list_id: str,
      status: str = "",
      count: int = 20,
      offset: int = 0,
  ) -> str:
      """List members of an audience. Filter by status: subscribed, unsubscribed, cleaned, pending, transactional."""
      mc = get_client()
      params: dict[str, Any] = {"count": min(count, 100), "offset": offset}
      if status:
          params["status"] = status
      data = await mc.get(f"/lists/{list_id}/members", params=params)
      members = []
      for m in data.get("members", []):
          members.append({
              "email": m.get("email_address", ""),
              "status": m.get("status", ""),
              "full_name": m.get("full_name", ""),
              "tags_count": m.get("tags_count", 0),
              "rating": m.get("member_rating", 0),
              "last_changed": m.get("last_changed", ""),
              "id": m.get("id", ""),
          })
      return _fmt({"total_items": data.get("total_items", 0), "members": members})