Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Mailerlite MCP connector

OAuth 2.1/DCRMarketingAutomationCommunication

Connect to MailerLite MCP. Manage email campaigns, subscribers, groups, automations, and forms from your AI workflows.

Mailerlite MCP connector

  1. Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENV_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'mailerlitemcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Mailerlite MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'mailerlitemcp_get_auth_status',
    toolInput: {},
    })
    console.log(result)

Connect this agent connector to let your agent:

  • Update webhook, subscriber, segment — Update the configuration of an existing webhook
  • Group unassign subscriber from, import subscribers to, assign subscriber to — Remove a subscriber from a group by subscriber ID and group ID
  • Lines suggest subject — Generate and return improved subject line suggestions based on provided input
  • Conversation start automation — Start a guided conversation to help build an automation from a natural language request
  • Send test automation — Send a test run of an automation to a specified email address
  • Resource select — Select a specific MailerLite resource by ID and type for use in an automation workflow

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

mailerlitemcp_add_subscriber#Add a new subscriber to your MailerLite account, optionally assigning them to groups and setting custom fields.6 params

Add a new subscriber to your MailerLite account, optionally assigning them to groups and setting custom fields.

NameTypeRequiredDescription
emailstringrequiredThe email address of the subscriber
fieldsobjectoptionalCustom fields for the subscriber
groupsarrayoptionalGroup IDs to add the subscriber to
namestringoptionalThe name of the subscriber
resubscribebooleanoptionalWhether to resubscribe a previously unsubscribed subscriber
statusstringoptionalSubscriber status (default: active)
mailerlitemcp_assign_subscriber_to_group#Add an existing subscriber to a MailerLite group by subscriber ID and group ID.2 params

Add an existing subscriber to a MailerLite group by subscriber ID and group ID.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group
subscriber_idstringrequiredThe ID or email of the subscriber
mailerlitemcp_batch_requests#Execute up to 50 MailerLite API requests in a single batch call. Webhooks are not supported.1 param

Execute up to 50 MailerLite API requests in a single batch call. Webhooks are not supported.

NameTypeRequiredDescription
requestsarrayrequiredArray of API requests to execute (max 50)
mailerlitemcp_build_custom_automation#Validate an automation plan before creating it. Checks trigger type, steps, and optionally discovers matching resources.4 params

Validate an automation plan before creating it. Checks trigger type, steps, and optionally discovers matching resources.

NameTypeRequiredDescription
stepsarrayrequiredPlanned automation steps in order
trigger_typestringrequiredThe trigger type for the automation
resource_namestringoptionalOptional resource name to search for (partial match)
resource_typestringoptionalResource type to look up. Defaults based on trigger: group for subscriber_joins_group, form for form_completed, shop for abandoned_cart, segment for subscriber_joins_segment
mailerlitemcp_cancel_campaign#Cancel a scheduled or delivering campaign by its campaign ID.1 param

Cancel a scheduled or delivering campaign by its campaign ID.

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign to cancel
mailerlitemcp_create_automation#Create a new automation workflow with a trigger type, trigger config, and ordered steps (email or delay).4 params

Create a new automation workflow with a trigger type, trigger config, and ordered steps (email or delay).

NameTypeRequiredDescription
namestringrequiredName for the automation
stepsarrayrequiredSteps in order (email or delay)
trigger_configobjectrequiredTrigger configuration (group_ids for subscriber_joins_group, segment_id for subscriber_joins_segment, form_id for form_completed, shop_id for abandoned_cart)
trigger_typestringrequiredTrigger type
mailerlitemcp_create_campaign#Create a new email campaign. The sender email must be a verified sender on your MailerLite account.8 params

Create a new email campaign. The sender email must be a verified sender on your MailerLite account.

NameTypeRequiredDescription
fromstringrequiredThe sender email address (must be verified on the MailerLite account)
from_namestringrequiredThe sender name
namestringrequiredThe name of the campaign
subjectstringrequiredThe email subject line
typestringrequiredThe type of campaign
contentstringoptionalThe HTML content of the email (optional - can be designed in dashboard)
groupsarrayoptionalGroup IDs to send to
reply_tostringoptionalReply-to email address
mailerlitemcp_create_field#Create a new custom subscriber field for storing additional subscriber data.2 params

Create a new custom subscriber field for storing additional subscriber data.

NameTypeRequiredDescription
namestringrequiredThe name of the field
typestringrequiredThe type of the field
mailerlitemcp_create_form#Create a new signup form (popup, embedded, or promotion) linked to one or more groups.3 params

Create a new signup form (popup, embedded, or promotion) linked to one or more groups.

NameTypeRequiredDescription
groupsarrayrequiredGroup IDs to assign new subscribers to (required, at least one)
namestringrequiredThe name of the form
typestringrequiredThe type of form to create
mailerlitemcp_create_group#Create a new subscriber group to organize your mailing list.1 param

Create a new subscriber group to organize your mailing list.

NameTypeRequiredDescription
namestringrequiredThe name of the group
mailerlitemcp_create_segment#Create a new dynamic segment based on subscriber filter conditions.2 params

Create a new dynamic segment based on subscriber filter conditions.

NameTypeRequiredDescription
namestringrequiredThe name of the segment
filterobjectoptionalFilter rules object. Format: {"rules": [[{"operator": "text_field_contains", "args": ["field_id", "value"]}]]}. Inner arrays are AND groups, outer array is OR between groups. Omit to create a segment without filters (can be configured in dashboard).
mailerlitemcp_create_webhook#Create a webhook to receive real-time event notifications from MailerLite.5 params

Create a webhook to receive real-time event notifications from MailerLite.

NameTypeRequiredDescription
eventsarrayrequiredWebhook events to subscribe to
urlstringrequiredThe URL to send webhook payloads to
batchablebooleanoptionalRequired as true for campaign.open, campaign.click, and subscriber.deleted events
enabledbooleanoptionalWhether the webhook is enabled
namestringoptionalA name for the webhook
mailerlitemcp_delete_automation#Permanently delete an automation workflow by its automation ID.1 param

Permanently delete an automation workflow by its automation ID.

NameTypeRequiredDescription
automation_idstringrequiredThe ID of the automation to delete
mailerlitemcp_delete_campaign#Permanently delete a campaign by its campaign ID.1 param

Permanently delete a campaign by its campaign ID.

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign to delete
mailerlitemcp_delete_field#Delete a custom subscriber field by its field ID.1 param

Delete a custom subscriber field by its field ID.

NameTypeRequiredDescription
field_idstringrequiredThe ID of the field to delete
mailerlitemcp_delete_form#Delete a signup form by its form ID.1 param

Delete a signup form by its form ID.

NameTypeRequiredDescription
form_idstringrequiredThe ID of the form to delete
mailerlitemcp_delete_group#Delete a subscriber group by its group ID.1 param

Delete a subscriber group by its group ID.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group to delete
mailerlitemcp_delete_segment#Delete a dynamic segment by its segment ID.1 param

Delete a dynamic segment by its segment ID.

NameTypeRequiredDescription
segment_idstringrequiredThe ID of the segment to delete
mailerlitemcp_delete_subscriber#Permanently delete a subscriber by their subscriber ID.1 param

Permanently delete a subscriber by their subscriber ID.

NameTypeRequiredDescription
subscriber_idstringrequiredThe ID or email of the subscriber to delete
mailerlitemcp_delete_webhook#Delete a webhook by its webhook ID.1 param

Delete a webhook by its webhook ID.

NameTypeRequiredDescription
webhook_idstringrequiredThe ID of the webhook to delete
mailerlitemcp_discover_automation_templates#Search and discover available automation templates by type and user intent.2 params

Search and discover available automation templates by type and user intent.

NameTypeRequiredDescription
typestringrequiredTemplate type to retrieve
user_intentstringoptionalThe user's specific automation goal (e.g., welcome series, abandoned cart)
mailerlitemcp_dry_run_automation#Preview an automation flow by sending a test run to a specified email address.2 params

Preview an automation flow by sending a test run to a specified email address.

NameTypeRequiredDescription
automation_idstringrequiredID of automation to test
test_emailstringrequiredEmail address for virtual test subscriber
mailerlitemcp_fetch#Fetch a MailerLite resource by its ID.1 param

Fetch a MailerLite resource by its ID.

NameTypeRequiredDescription
idstringrequiredIdentifier returned from the search tool (e.g., "campaign:123", "group:456")
mailerlitemcp_generate_email_content#Generate email body content from a subject line and optional plain text.2 params

Generate email body content from a subject line and optional plain text.

NameTypeRequiredDescription
plain_textstringrequiredThe plain text email body to validate
subjectstringrequiredThe email subject line to validate
mailerlitemcp_get_auth_status#Check the current authentication status and account details for the connected MailerLite account.0 params

Check the current authentication status and account details for the connected MailerLite account.

mailerlitemcp_get_automation_activity#Retrieve activity logs for an automation, filtered by date, status, or subscriber search.9 params

Retrieve activity logs for an automation, filtered by date, status, or subscriber search.

NameTypeRequiredDescription
automation_idstringrequiredThe ID of the automation
statusstringrequiredFilter by activity status
date_fromstringoptionalFilter from date (Y-m-d). For completed/canceled/failed statuses
date_tostringoptionalFilter to date (Y-m-d). For completed/canceled/failed statuses
limitintegeroptionalNumber of results per page (default 10)
pageintegeroptionalPage number
scheduled_fromstringoptionalFilter scheduled from date (Y-m-d). For active status
scheduled_tostringoptionalFilter scheduled to date (Y-m-d). For active status
searchstringoptionalSearch by subscriber email
mailerlitemcp_get_campaign#Retrieve details for a specific campaign by its campaign ID.1 param

Retrieve details for a specific campaign by its campaign ID.

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign
mailerlitemcp_get_campaign_subscribers#List subscribers for a campaign, filtered by activity type (opened, clicked, bounced, etc.).6 params

List subscribers for a campaign, filtered by activity type (opened, clicked, bounced, etc.).

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign
limitintegeroptionalNumber of results (allowed values: 10, 25, 50, 100)
pageintegeroptionalPage number for pagination
searchstringoptionalSearch by subscriber email
sortstringoptionalSort field
typestringoptionalFilter by activity type
mailerlitemcp_get_form#Retrieve details for a specific signup form by its form ID.1 param

Retrieve details for a specific signup form by its form ID.

NameTypeRequiredDescription
form_idstringrequiredThe ID of the form
mailerlitemcp_get_form_subscribers#List subscribers who signed up through a specific form.4 params

List subscribers who signed up through a specific form.

NameTypeRequiredDescription
form_idstringrequiredThe ID of the form
filterstringoptionalFilter subscribers
limitintegeroptionalNumber of subscribers to return (1-100)
pageintegeroptionalPage number for pagination
mailerlitemcp_get_group_subscribers#List subscribers in a specific group, with optional cursor-based pagination.3 params

List subscribers in a specific group, with optional cursor-based pagination.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group
cursorstringoptionalCursor for pagination
limitintegeroptionalNumber of subscribers to return (1-100)
mailerlitemcp_get_segment#Retrieve details for a specific segment by its segment ID.1 param

Retrieve details for a specific segment by its segment ID.

NameTypeRequiredDescription
segment_idstringrequiredThe ID of the segment
mailerlitemcp_get_segment_subscribers#List subscribers matching a segment, with cursor pagination and status filtering.4 params

List subscribers matching a segment, with cursor pagination and status filtering.

NameTypeRequiredDescription
segment_idstringrequiredThe ID of the segment
cursorstringoptionalCursor for pagination
limitintegeroptionalNumber of subscribers to return (1-100)
statusstringoptionalFilter by subscriber status
mailerlitemcp_get_subscriber#Retrieve a subscriber's full profile by their subscriber ID.1 param

Retrieve a subscriber's full profile by their subscriber ID.

NameTypeRequiredDescription
subscriber_idstringrequiredThe ID or email of the subscriber
mailerlitemcp_get_subscriber_activity#Retrieve recent activity events for a subscriber (opens, clicks, etc.).1 param

Retrieve recent activity events for a subscriber (opens, clicks, etc.).

NameTypeRequiredDescription
subscriber_idstringrequiredThe ID or email of the subscriber
mailerlitemcp_get_subscriber_count#Get the total count of subscribers in your MailerLite account.0 params

Get the total count of subscribers in your MailerLite account.

mailerlitemcp_get_webhook#Retrieve details for a specific webhook by its webhook ID.1 param

Retrieve details for a specific webhook by its webhook ID.

NameTypeRequiredDescription
webhook_idstringrequiredThe ID of the webhook
mailerlitemcp_import_subscribers_to_group#Bulk-import multiple subscribers into a group in one request.4 params

Bulk-import multiple subscribers into a group in one request.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group to import to
subscribersarrayrequiredArray of subscribers to import
autorespondersbooleanoptionalWhether to trigger autoresponders
resubscribebooleanoptionalWhether to resubscribe previously unsubscribed subscribers
mailerlitemcp_install_template#Install a MailerLite email template into your account by template ID.1 param

Install a MailerLite email template into your account by template ID.

NameTypeRequiredDescription
template_idstringrequiredID of template to install
mailerlitemcp_list_automations#List all automations in the account, with optional filtering to enabled automations only.2 params

List all automations in the account, with optional filtering to enabled automations only.

NameTypeRequiredDescription
enabled_onlybooleanoptionalOnly show enabled automations
limitnumberoptionalMaximum number of automations to return
mailerlitemcp_list_campaigns#List campaigns in the account, with filtering by status and type.4 params

List campaigns in the account, with filtering by status and type.

NameTypeRequiredDescription
cursorstringoptionalCursor for pagination
limitintegeroptionalNumber of campaigns to return (allowed values: 1, 10, 25, 50, 100)
statusstringoptionalFilter by campaign status
typestringoptionalFilter by campaign type
mailerlitemcp_list_email_templates#List available email templates with optional search and pagination.2 params

List available email templates with optional search and pagination.

NameTypeRequiredDescription
limitnumberoptionalMaximum number of templates to return (default: 10)
searchstringoptionalSearch filter for template names
mailerlitemcp_list_fields#List all custom subscriber fields with optional filtering and sorting.5 params

List all custom subscriber fields with optional filtering and sorting.

NameTypeRequiredDescription
keywordstringoptionalFilter by keyword
limitintegeroptionalNumber of fields to return
pageintegeroptionalPage number
sortstringoptionalSort field
typestringoptionalFilter by field type
mailerlitemcp_list_form_templates#List available form templates, filtered by form type.2 params

List available form templates, filtered by form type.

NameTypeRequiredDescription
typestringrequiredForm template type
limitintegeroptionalNumber of templates to return (default: 25)
mailerlitemcp_list_forms#List all signup forms with optional filtering by name, type, and sorting.5 params

List all signup forms with optional filtering by name, type, and sorting.

NameTypeRequiredDescription
typestringrequiredThe type of forms to list
limitintegeroptionalNumber of forms to return (1-100)
namestringoptionalFilter by form name
pageintegeroptionalPage number for pagination
sortstringoptionalSort field
mailerlitemcp_list_resources#List MailerLite resources (groups, forms, segments, or shops) with optional name filtering.2 params

List MailerLite resources (groups, forms, segments, or shops) with optional name filtering.

NameTypeRequiredDescription
resource_typestringrequiredType of resource to list (singular: group, form, shop, or segment)
name_filterstringoptionalOptional filter by name (partial match)
mailerlitemcp_list_segments#List all dynamic segments with pagination.2 params

List all dynamic segments with pagination.

NameTypeRequiredDescription
limitintegeroptionalNumber of segments to return (1-100)
pageintegeroptionalPage number for pagination
mailerlitemcp_list_subscribers#List subscribers with cursor-based pagination, status filtering, and limit control.3 params

List subscribers with cursor-based pagination, status filtering, and limit control.

NameTypeRequiredDescription
cursorstringoptionalCursor for pagination
limitintegeroptionalNumber of subscribers to return (1-100, default 25)
statusstringoptionalFilter by subscriber status
mailerlitemcp_list_webhooks#List all configured webhooks in the account.0 params

List all configured webhooks in the account.

mailerlitemcp_schedule_campaign#Schedule a campaign for immediate or future delivery. Use delivery 'instant' to send now.3 params

Schedule a campaign for immediate or future delivery. Use delivery 'instant' to send now.

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign to schedule
deliverystringrequiredDelivery type: "instant" sends now, "scheduled" sends at a specific time, "timezone_based" sends per subscriber timezone, "smart_sending" uses AI-optimized send times
scheduleobjectoptionalSchedule details — required when delivery is "scheduled" or "timezone_based"
mailerlitemcp_select_resource#Select a specific MailerLite resource by ID and type for use in an automation workflow.3 params

Select a specific MailerLite resource by ID and type for use in an automation workflow.

NameTypeRequiredDescription
resource_idstringrequiredThe ID of the selected resource
resource_namestringrequiredThe name of the selected resource
resource_typestringrequiredThe type of the selected resource
mailerlitemcp_send_test_automation#Send a test run of an automation to a specified email address.2 params

Send a test run of an automation to a specified email address.

NameTypeRequiredDescription
automation_idstringrequiredID of automation to test
emailstringrequiredYour email address to receive the test emails
mailerlitemcp_start_automation_conversation#Start a guided conversation to help build an automation from a natural language request.1 param

Start a guided conversation to help build an automation from a natural language request.

NameTypeRequiredDescription
user_requeststringrequiredWhat the user asked for
mailerlitemcp_suggest_subject_lines#Generate and return improved subject line suggestions based on provided input.1 param

Generate and return improved subject line suggestions based on provided input.

NameTypeRequiredDescription
subject_linesarrayrequiredArray of subject line candidates to validate
mailerlitemcp_unassign_subscriber_from_group#Remove a subscriber from a group by subscriber ID and group ID.2 params

Remove a subscriber from a group by subscriber ID and group ID.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group
subscriber_idstringrequiredThe ID or email of the subscriber
mailerlitemcp_update_automation_delay#Update the delay duration and unit for a specific step in an automation.4 params

Update the delay duration and unit for a specific step in an automation.

NameTypeRequiredDescription
automation_idstringrequiredAutomation ID
step_indexnumberrequiredDelay step index (0-based, only counts delay steps)
unitstringrequiredDelay duration unit
valuenumberrequiredDelay duration value (must be positive)
mailerlitemcp_update_automation_email#Update the subject and plain text content for an email step in an automation.4 params

Update the subject and plain text content for an email step in an automation.

NameTypeRequiredDescription
automation_idstringrequiredAutomation ID
step_indexnumberrequiredEmail step index (0-based, only counts email steps)
subjectstringrequiredEmail subject line
plain_textstringoptionalPlain text email content
mailerlitemcp_update_campaign#Update the name, subject, sender, or content of an existing campaign.6 params

Update the name, subject, sender, or content of an existing campaign.

NameTypeRequiredDescription
campaign_idstringrequiredThe ID of the campaign to update
contentstringoptionalNew HTML content
fromstringoptionalNew sender email
from_namestringoptionalNew sender name
namestringoptionalNew campaign name
subjectstringoptionalNew email subject
mailerlitemcp_update_field#Rename a custom subscriber field.2 params

Rename a custom subscriber field.

NameTypeRequiredDescription
field_idstringrequiredThe ID of the field to update
namestringrequiredThe new name for the field
mailerlitemcp_update_form#Update the name of an existing signup form.2 params

Update the name of an existing signup form.

NameTypeRequiredDescription
form_idstringrequiredThe ID of the form to update
namestringoptionalNew name for the form
mailerlitemcp_update_group#Rename an existing subscriber group.2 params

Rename an existing subscriber group.

NameTypeRequiredDescription
group_idstringrequiredThe ID of the group to update
namestringrequiredThe new name for the group
mailerlitemcp_update_segment#Update the name of an existing segment.2 params

Update the name of an existing segment.

NameTypeRequiredDescription
namestringrequiredNew name for the segment
segment_idstringrequiredThe ID of the segment to update
mailerlitemcp_update_subscriber#Update an existing subscriber's name, status, or custom fields.3 params

Update an existing subscriber's name, status, or custom fields.

NameTypeRequiredDescription
subscriber_idstringrequiredThe ID or email of the subscriber
fieldsobjectoptionalCustom fields to update
namestringoptionalThe new name for the subscriber
mailerlitemcp_update_webhook#Update the configuration of an existing webhook.6 params

Update the configuration of an existing webhook.

NameTypeRequiredDescription
webhook_idstringrequiredThe ID of the webhook to update
batchablebooleanoptionalRequired as true for campaign.open, campaign.click, and subscriber.deleted events
enabledbooleanoptionalWhether the webhook is enabled
eventsarrayoptionalWebhook events to subscribe to
namestringoptionalA name for the webhook
urlstringoptionalThe URL to send webhook payloads to