Mailerlite MCP connector

OAuth 2.1/DCR MarketingAutomationCommunication

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

Mailerlite MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

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>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'mailerlitemcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Mailerlite MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'mailerlitemcp_get_auth_status',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "mailerlitemcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Mailerlite MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="mailerlitemcp_get_auth_status",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

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

Tool list

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.

Name Type Required Description

email string required The email address of the subscriber

fields object optional Custom fields for the subscriber

groups array optional Group IDs to add the subscriber to

name string optional The name of the subscriber

resubscribe boolean optional Whether to resubscribe a previously unsubscribed subscriber

status string optional Subscriber 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.

Name Type Required Description

group_id string required The ID of the group

subscriber_id string required The 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.

Name Type Required Description

requests array required Array 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.

Name Type Required Description

steps array required Planned automation steps in order

trigger_type string required The trigger type for the automation

resource_name string optional Optional resource name to search for (partial match)

resource_type string optional Resource 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.

Name Type Required Description

campaign_id string required The 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).

Name Type Required Description

name string required Name for the automation

steps array required Steps in order (email or delay)

trigger_config object required Trigger configuration (group_ids for subscriber_joins_group, segment_id for subscriber_joins_segment, form_id for form_completed, shop_id for abandoned_cart)

trigger_type string required Trigger 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.

Name Type Required Description

from string required The sender email address (must be verified on the MailerLite account)

from_name string required The sender name

name string required The name of the campaign

subject string required The email subject line

type string required The type of campaign

content string optional The HTML content of the email (optional - can be designed in dashboard)

groups array optional Group IDs to send to

reply_to string optional Reply-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.

Name Type Required Description

name string required The name of the field

type string required The 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.

Name Type Required Description

groups array required Group IDs to assign new subscribers to (required, at least one)

name string required The name of the form

type string required The 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.

Name Type Required Description

name string required The 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.

Name Type Required Description

name string required The name of the segment

filter object optional Filter 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.

Name Type Required Description

events array required Webhook events to subscribe to

url string required The URL to send webhook payloads to

batchable boolean optional Required as true for campaign.open, campaign.click, and subscriber.deleted events

enabled boolean optional Whether the webhook is enabled

name string optional A 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.

Name Type Required Description

automation_id string required The 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.

Name Type Required Description

campaign_id string required The 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.

Name Type Required Description

field_id string required The 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.

Name Type Required Description

form_id string required The 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.

Name Type Required Description

group_id string required The 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.

Name Type Required Description

segment_id string required The 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.

Name Type Required Description

subscriber_id string required The 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.

Name Type Required Description

webhook_id string required The 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.

Name Type Required Description

type string required Template type to retrieve

user_intent string optional The 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.

Name Type Required Description

automation_id string required ID of automation to test

test_email string required Email address for virtual test subscriber

mailerlitemcp_fetch # Fetch a MailerLite resource by its ID. 1 param

Fetch a MailerLite resource by its ID.

Name Type Required Description

id string required Identifier 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.

Name Type Required Description

plain_text string required The plain text email body to validate

subject string required The 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.

Name Type Required Description

automation_id string required The ID of the automation

status string required Filter by activity status

date_from string optional Filter from date (Y-m-d). For completed/canceled/failed statuses

date_to string optional Filter to date (Y-m-d). For completed/canceled/failed statuses

limit integer optional Number of results per page (default 10)

page integer optional Page number

scheduled_from string optional Filter scheduled from date (Y-m-d). For active status

scheduled_to string optional Filter scheduled to date (Y-m-d). For active status

search string optional Search 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.

Name Type Required Description

campaign_id string required The ID of the campaign

mailerlitemcp_get_campaign_link_recipients # List subscribers who clicked a specific link in a campaign. 7 params

List subscribers who clicked a specific link in a campaign.

Name Type Required Description

campaign_id string required The ID of the campaign

link_id string required The ID of the link

limit string optional Number of results per page (10, 25, 50, or 100)

order string optional Sort direction

order_by string optional Sort field

page integer optional Page number for pagination

search string optional Search by subscriber email

mailerlitemcp_get_campaign_links # List all tracked links for a campaign. 1 param

List all tracked links for a campaign.

Name Type Required Description

campaign_id string required The 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.).

Name Type Required Description

campaign_id string required The ID of the campaign

limit integer optional Number of results (allowed values: 10, 25, 50, 100)

page integer optional Page number for pagination

search string optional Search by subscriber email

sort string optional Sort field

type string optional Filter by activity type

mailerlitemcp_get_dashboard_link # Get a direct link to a MailerLite dashboard resource (automation or other context). 2 params

Get a direct link to a MailerLite dashboard resource (automation or other context).

Name Type Required Description

automation_id string required Automation ID

context string optional What the user needs to edit (e.g., "design email", "edit automation")

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.

Name Type Required Description

form_id string required The 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.

Name Type Required Description

form_id string required The ID of the form

filter string optional Filter subscribers

limit integer optional Number of subscribers to return (1-100)

page integer optional Page 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.

Name Type Required Description

group_id string required The ID of the group

cursor string optional Cursor for pagination

limit integer optional Number 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.

Name Type Required Description

segment_id string required The 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.

Name Type Required Description

segment_id string required The ID of the segment

cursor string optional Cursor for pagination

limit integer optional Number of subscribers to return (1-100)

status string optional Filter 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.

Name Type Required Description

subscriber_id string required The 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.).

Name Type Required Description

subscriber_id string required The 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.

Name Type Required Description

webhook_id string required The 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.

Name Type Required Description

group_id string required The ID of the group to import to

subscribers array required Array of subscribers to import

autoresponders boolean optional Whether to trigger autoresponders

resubscribe boolean optional Whether 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.

Name Type Required Description

template_id string required ID 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.

Name Type Required Description

enabled_only boolean optional Only show enabled automations

limit number optional Maximum 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.

Name Type Required Description

cursor string optional Cursor for pagination

limit integer optional Number of campaigns to return (allowed values: 1, 10, 25, 50, 100)

status string optional Filter by campaign status

type string optional Filter 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.

Name Type Required Description

limit number optional Maximum number of templates to return (default: 10)

search string optional Search 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.

Name Type Required Description

keyword string optional Filter by keyword

limit integer optional Number of fields to return

page integer optional Page number

sort string optional Sort field

type string optional Filter 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.

Name Type Required Description

type string required Form template type

limit integer optional Number 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.

Name Type Required Description

type string required The type of forms to list

limit integer optional Number of forms to return (1-100)

name string optional Filter by form name

page integer optional Page number for pagination

sort string optional Sort 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.

Name Type Required Description

resource_type string required Type of resource to list (singular: group, form, shop, or segment)

name_filter string optional Optional filter by name (partial match)

mailerlitemcp_list_segments # List all dynamic segments with pagination. 2 params

List all dynamic segments with pagination.

Name Type Required Description

limit integer optional Number of segments to return (1-100)

page integer optional Page 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.

Name Type Required Description

cursor string optional Cursor for pagination

limit integer optional Number of subscribers to return (1-100, default 25)

status string optional Filter 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.

Name Type Required Description

campaign_id string required The ID of the campaign to schedule

delivery string required Delivery type: "instant" sends now, "scheduled" sends at a specific time, "timezone_based" sends per subscriber timezone, "smart_sending" uses AI-optimized send times

schedule object optional Schedule details — required when delivery is "scheduled" or "timezone_based"

mailerlitemcp_search # Search across MailerLite subscribers and groups by query string. 2 params

Search across MailerLite subscribers and groups by query string.

Name Type Required Description

query string required Text to search for across MailerLite resources

limit integer optional Maximum number of results to return (default 10)

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.

Name Type Required Description

resource_id string required The ID of the selected resource

resource_name string required The name of the selected resource

resource_type string required The 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.

Name Type Required Description

automation_id string required ID of automation to test

email string required Your 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.

Name Type Required Description

user_request string required What 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.

Name Type Required Description

subject_lines array required Array 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.

Name Type Required Description

group_id string required The ID of the group

subscriber_id string required The 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.

Name Type Required Description

automation_id string required Automation ID

step_index number required Delay step index (0-based, only counts delay steps)

unit string required Delay duration unit

value number required Delay 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.

Name Type Required Description

automation_id string required Automation ID

step_index number required Email step index (0-based, only counts email steps)

subject string required Email subject line

plain_text string optional Plain 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.

Name Type Required Description

campaign_id string required The ID of the campaign to update

content string optional New HTML content

from string optional New sender email

from_name string optional New sender name

name string optional New campaign name

subject string optional New email subject

mailerlitemcp_update_field # Rename a custom subscriber field. 2 params

Rename a custom subscriber field.

Name Type Required Description

field_id string required The ID of the field to update

name string required The 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.

Name Type Required Description

form_id string required The ID of the form to update

name string optional New name for the form

mailerlitemcp_update_group # Rename an existing subscriber group. 2 params

Rename an existing subscriber group.

Name Type Required Description

group_id string required The ID of the group to update

name string required The new name for the group

mailerlitemcp_update_segment # Update the name of an existing segment. 2 params

Update the name of an existing segment.

Name Type Required Description

name string required New name for the segment

segment_id string required The 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.

Name Type Required Description

subscriber_id string required The ID or email of the subscriber

fields object optional Custom fields to update

name string optional The new name for the subscriber

mailerlitemcp_update_webhook # Update the configuration of an existing webhook. 6 params

Update the configuration of an existing webhook.

Name Type Required Description

webhook_id string required The ID of the webhook to update

batchable boolean optional Required as true for campaign.open, campaign.click, and subscriber.deleted events

enabled boolean optional Whether the webhook is enabled

events array optional Webhook events to subscribe to

name string optional A name for the webhook

url string optional The URL to send webhook payloads to

Mailerlite MCP connector

Mailerlite MCP connector

Install the SDK

Set your credentials

Authorize and make your first call

What you can do

Tool list