Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Mailercloud MCP connector

OAuth 2.1/DCRMarketingAutomation

Connect to Mailer Cloud MCP. Manage email campaigns, subscriber lists, and automation workflows for your email marketing operations.

Mailercloud MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. 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>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    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 = 'mailercloudmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Mailercloud 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: 'mailercloudmcp_get_account_overview',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Contact upsert — Create a contact if it doesn’t exist, or update it if it does
  • Update webhook, template, list — Update an existing webhook’s configuration
  • Webhook toggle — Enable or disable a webhook
  • Send transactional email, test email — Send a transactional email via MailerCloud Email API
  • Campaign schedule, analyze — Schedule a campaign for sending
  • List webhooks, webforms, template categories — List all webhooks configured in MailerCloud

Tool list

Section titled “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.

mailercloudmcp_analyze_campaign#Deep-dive analysis of a single campaign's performance. Returns a letter grade, weighted performance scores vs industry benchmarks, deliverability health assessment, contextual insights, and prioritized actionable recommendations to improve future sends.3 params

Deep-dive analysis of a single campaign's performance. Returns a letter grade, weighted performance scores vs industry benchmarks, deliverability health assessment, contextual insights, and prioritized actionable recommendations to improve future sends.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
cost_per_emailnumberoptionalOptional cost per email sent, used to calculate ROI in reports.
mailercloudmcp_analyze_latest_campaigns#Analyze recent completed campaigns as a batch (default 5, up to 20 via count param). Provides individual grades, overall performance vs industry benchmarks, trends over time, what's working vs needs attention, performance by list, optional cost/ROI context, and a strategic action plan.3 params

Analyze recent completed campaigns as a batch (default 5, up to 20 via count param). Provides individual grades, overall performance vs industry benchmarks, trends over time, what's working vs needs attention, performance by list, optional cost/ROI context, and a strategic action plan.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
cost_per_emailnumberoptionalOptional cost per email sent, used to calculate ROI in reports.
countintegeroptionalNumber of recent campaigns to analyze (default: 5).
mailercloudmcp_audit_campaign_draft#Pre-send quality audit for a campaign draft. Checks subject line length and spam triggers, sender configuration, list selection, content presence, preheader text, and provides a pass/fail checklist with specific fix-it recommendations before you hit send. Use this before scheduling any campaign.2 params

Pre-send quality audit for a campaign draft. Checks subject line length and spam triggers, sender configuration, list selection, content presence, preheader text, and provides a pass/fail checklist with specific fix-it recommendations before you hit send. Use this before scheduling any campaign.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_batch_create_contacts#Create multiple contacts at once in bulk.3 params

Create multiple contacts at once in bulk.

NameTypeRequiredDescription
contactsstringrequiredArray of contact objects,required
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_campaign_health_dashboard#Quick portfolio-level health check across recent campaigns. Returns an at-a-glance dashboard with overall grade, metric status vs benchmarks, what's working vs needs attention, performance trends, and top priority action. Use this for a fast 10-second overview; use analyze_latest_campaigns for deep analysis.2 params

Quick portfolio-level health check across recent campaigns. Returns an at-a-glance dashboard with overall grade, metric status vs benchmarks, what's working vs needs attention, performance trends, and top priority action. Use this for a fast 10-second overview; use analyze_latest_campaigns for deep analysis.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
cost_per_emailnumberoptionalOptional cost per email sent, used to calculate ROI in reports.
mailercloudmcp_compare_campaigns#Side-by-side comparison of two or more campaigns. Shows performance metrics, scores, grades, identifies the winner for each metric, and provides recommendations based on what worked best.3 params

Side-by-side comparison of two or more campaigns. Shows performance metrics, scores, grades, identifies the winner for each metric, and provides recommendations based on what worked best.

NameTypeRequiredDescription
campaign_idsstringrequiredArray of campaign IDs to compare.
api_keystringoptionalYour MailerCloud API key for authentication.
cost_per_emailnumberoptionalOptional cost per email sent, used to calculate ROI in reports.
mailercloudmcp_create_campaign#Create a new email campaign in MailerCloud. Requires name, subject, and at least one list ID. If sender is not provided, it will be auto-resolved from your verified senders (if only one exists) or you will be prompted to choose. Reply-to defaults to sender email (best practice) — only provide reply_email or reply_id if you need a different reply-to address.20 params

Create a new email campaign in MailerCloud. Requires name, subject, and at least one list ID. If sender is not provided, it will be auto-resolved from your verified senders (if only one exists) or you will be prompted to choose. Reply-to defaults to sender email (best practice) — only provide reply_email or reply_id if you need a different reply-to address.

NameTypeRequiredDescription
list_idsstringrequiredList IDs to send to,required
namestringrequiredDisplay name for the campaign.
subjectstringrequiredSubject line for the email.
api_keystringoptionalYour MailerCloud API key for authentication.
email_preheaderstringoptionalShort preview text shown after the subject line in email clients (max 150 characters).
exclude_list_idsstringoptionalList IDs to exclude from send
exclude_segmentsstringoptionalSegment IDs to exclude from send
exclude_tag_idsstringoptionalTag IDs to exclude from send
frequency_capstringoptionalLimit how often a contact receives campaigns (e.g. daily, weekly).
htmlstringoptionalHTML content for the email body.
is_publishstringoptionalSet to 'true' to publish immediately; 'false' saves as a draft.
plain_textstringoptionalPlain text fallback content for email clients that do not support HTML.
reply_emailstringoptionalReply-to email address. Defaults to sender email if omitted.
reply_idstringoptionalID of a pre-configured reply-to email address (alternative to reply_email).
scheduled_atstringoptionalDatetime to send the campaign, in YYYY-MM-DD HH:MM:SS format.
segmentsstringoptionalSegment IDs
sender_emailstringoptionalEmail address of the sender. Auto-resolved if your account has only one verified sender.
sender_idstringoptionalArray of pre-configured sender IDs. Alternative to sender_name/sender_email.
sender_namestringoptionalDisplay name for the sender. Auto-resolved if your account has only one verified sender.
tag_idsstringoptionalTag IDs to apply to campaign
mailercloudmcp_create_contact#Create a new contact in a MailerCloud list. Email and list_id are required.14 params

Create a new contact in a MailerCloud list. Email and list_id are required.

NameTypeRequiredDescription
emailstringrequiredContact's email address.
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
citystringoptionalContact's city.
company_namestringoptionalContact's company or organization name.
countrystringoptionalContact's country code (e.g. US, GB).
custom_fieldsobjectoptionalCustom field values
departmentstringoptionalContact's department within their organization.
first_namestringoptionalContact's first name.
job_titlestringoptionalContact's job title.
last_namestringoptionalContact's last name.
phonestringoptionalContact's phone number in E.164 format.
statestringoptionalContact's state or region.
tagsstringoptionalTags to assign
mailercloudmcp_create_list#Create a new contact list in MailerCloud.3 params

Create a new contact list in MailerCloud.

NameTypeRequiredDescription
list_typeintegerrequiredType of list: 1 for regular, 2 for single opt-in, 3 for double opt-in.
namestringrequiredDisplay name for the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_create_tag#Create a new tag for organizing contacts.2 params

Create a new tag for organizing contacts.

NameTypeRequiredDescription
namestringrequiredDisplay name for the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_create_template#Create a new HTML email template.5 params

Create a new HTML email template.

NameTypeRequiredDescription
htmlstringrequiredHTML content for the email body.
namestringrequiredDisplay name for the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
category_idstringoptionalID of the template category to assign this template to.
plain_textstringoptionalPlain text fallback content for email clients that do not support HTML.
mailercloudmcp_create_webhook#Create a new webhook to receive event notifications.4 params

Create a new webhook to receive event notifications.

NameTypeRequiredDescription
eventsstringrequiredEvents to subscribe to,required
namestringrequiredDisplay name for the campaign.
urlstringrequiredHTTPS URL to receive webhook event payloads.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_delete_contact#Delete a contact by ID.2 params

Delete a contact by ID.

NameTypeRequiredDescription
contact_idstringrequiredThe unique ID of the contact.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_delete_list#Delete a contact list by ID.2 params

Delete a contact list by ID.

NameTypeRequiredDescription
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_delete_webhook#Delete a webhook.2 params

Delete a webhook.

NameTypeRequiredDescription
webhook_idstringrequiredThe unique ID of the webhook.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_engagement_funnel#Visualize the engagement funnel for a sent campaign: total sent → delivered → opened → clicked. Shows conversion rates at each stage, identifies the biggest drop-off point, and provides targeted recommendations to fix the weakest stage of the funnel.2 params

Visualize the engagement funnel for a sent campaign: total sent → delivered → opened → clicked. Shows conversion rates at each stage, identifies the biggest drop-off point, and provides targeted recommendations to fix the weakest stage of the funnel.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_account_overview#Get account plan details including limits, usage, and subscription information.1 param

Get account plan details including limits, usage, and subscription information.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_automation#Get details of a specific automation workflow, optionally filtered by node type.3 params

Get details of a specific automation workflow, optionally filtered by node type.

NameTypeRequiredDescription
automation_idstringrequiredThe unique ID of the automation workflow.
api_keystringoptionalYour MailerCloud API key for authentication.
node_typestringoptionalFilter automation steps by node type (e.g. email, sms).
mailercloudmcp_get_best_practices#Generate a comprehensive email marketing best practices report based on your actual campaign performance data. Shows your performance vs industry benchmarks, identifies top-performing patterns (subject lines, send times, audience size), highlights improvement areas with specific numbers, and provides prioritized actionable recommendations tailored to your data.1 param

Generate a comprehensive email marketing best practices report based on your actual campaign performance data. Shows your performance vs industry benchmarks, identifies top-performing patterns (subject lines, send times, audience size), highlights improvement areas with specific numbers, and provides prioritized actionable recommendations tailored to your data.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_campaign#Get full details of a specific MailerCloud campaign by ID, including performance metrics.2 params

Get full details of a specific MailerCloud campaign by ID, including performance metrics.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_campaign_domain_report#Get domain-level performance statistics for a sent campaign.4 params

Get domain-level performance statistics for a sent campaign.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_get_contact#Get detailed information about a specific contact by ID.2 params

Get detailed information about a specific contact by ID.

NameTypeRequiredDescription
contact_idstringrequiredThe unique ID of the contact.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_inbox_tracking#Get inbox placement tracking data for a date range, optionally filtered by campaign or domain. Helps monitor deliverability across email providers.5 params

Get inbox placement tracking data for a date range, optionally filtered by campaign or domain. Helps monitor deliverability across email providers.

NameTypeRequiredDescription
date_fromstringrequiredStart date for inbox tracking data in YYYY-MM-DD format.
date_tostringrequiredEnd date for inbox tracking data in YYYY-MM-DD format.
api_keystringoptionalYour MailerCloud API key for authentication.
campaign_idstringoptionalThe unique ID of the campaign.
domainstringoptionalFilter inbox tracking data by specific email domain (e.g. gmail.com).
mailercloudmcp_get_list_details#Get details of a specific contact list including subscriber counts.2 params

Get details of a specific contact list including subscriber counts.

NameTypeRequiredDescription
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_template#Get a template's details and HTML content by ID.2 params

Get a template's details and HTML content by ID.

NameTypeRequiredDescription
template_idstringrequiredThe unique ID of the template.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_get_webhook#Get details of a specific webhook.2 params

Get details of a specific webhook.

NameTypeRequiredDescription
webhook_idstringrequiredThe unique ID of the webhook.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_list_campaigns#List MailerCloud campaigns with pagination. Returns campaign names, IDs, subjects, statuses, and performance metrics.3 params

List MailerCloud campaigns with pagination. Returns campaign names, IDs, subjects, statuses, and performance metrics.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_contact_lists#List all MailerCloud contact lists with pagination.3 params

List all MailerCloud contact lists with pagination.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_contacts#List contacts in a specific MailerCloud contact list with pagination.4 params

List contacts in a specific MailerCloud contact list with pagination.

NameTypeRequiredDescription
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_custom_fields#List all custom contact properties/fields defined in your account.3 params

List all custom contact properties/fields defined in your account.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_reply_emails#List all reply-to email addresses configured in your MailerCloud account. Use the returned IDs when creating campaigns with the reply_id parameter.3 params

List all reply-to email addresses configured in your MailerCloud account. Use the returned IDs when creating campaigns with the reply_id parameter.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_segments#List all audience segments with optional search and sorting.6 params

List all audience segments with optional search and sorting.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
searchstringoptionalSearch query to filter segments by name or keyword.
sort_fieldstringoptionalField to sort results by (e.g. created_at, name).
sort_orderstringoptionalSort direction: asc for ascending, desc for descending.
mailercloudmcp_list_senders#List all verified senders in your MailerCloud account. Use the returned sender IDs when creating campaigns with the sender_id parameter.3 params

List all verified senders in your MailerCloud account. Use the returned sender IDs when creating campaigns with the sender_id parameter.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_tags#List all tags in your MailerCloud account.3 params

List all tags in your MailerCloud account.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_template_categories#List all email template categories in MailerCloud.1 param

List all email template categories in MailerCloud.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_list_webforms#List all webforms in your MailerCloud account.3 params

List all webforms in your MailerCloud account.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_list_webhooks#List all webhooks configured in MailerCloud.3 params

List all webhooks configured in MailerCloud.

NameTypeRequiredDescription
api_keystringoptionalYour MailerCloud API key for authentication.
limitintegeroptionalMaximum number of results to return per page.
pageintegeroptionalPage number for paginated results (starts at 1).
mailercloudmcp_schedule_campaign#Schedule a campaign for sending. Omit scheduled_at to send immediately.3 params

Schedule a campaign for sending. Omit scheduled_at to send immediately.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
scheduled_atstringoptionalDatetime to send the campaign, in YYYY-MM-DD HH:MM:SS format.
mailercloudmcp_send_test_email#Send a test email for a campaign to specified recipients before the actual send.3 params

Send a test email for a campaign to specified recipients before the actual send.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
recipientsstringrequiredTest email recipients,required
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_send_transactional_email#Send a transactional email via MailerCloud Email API. Supports HTML, AMP HTML, attachments, CC/BCC. Use version 1.0 for HTML only, 2.0 for AMP content.13 params

Send a transactional email via MailerCloud Email API. Supports HTML, AMP HTML, attachments, CC/BCC. Use version 1.0 for HTML only, 2.0 for AMP content.

NameTypeRequiredDescription
fromstringrequiredSender email address for the transactional email.
subjectstringrequiredSubject line for the email.
tostringrequiredTo recipients (array of name and email),required
amp_htmlstringoptionalAMP HTML content. Use API version 2.0 when sending AMP content.
api_keystringoptionalYour MailerCloud API key for authentication.
attachmentsstringoptionalAttachments (array of name and url)
bccstringoptionalBCC recipients
ccstringoptionalCC recipients
from_namestringoptionalSender display name for the transactional email.
htmlstringoptionalHTML content for the email body.
reply_tostringoptionalReply-to addresses
textstringoptionalPlain text fallback for the transactional email.
versionstringoptionalAPI version: 1.0 for HTML-only emails, 2.0 for AMP content.
mailercloudmcp_toggle_webhook#Enable or disable a webhook.3 params

Enable or disable a webhook.

NameTypeRequiredDescription
activebooleanrequiredSet to true to enable the webhook, false to disable it.
webhook_idstringrequiredThe unique ID of the webhook.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_update_campaign#Update a draft campaign. Only draft campaigns can be updated.3 params

Update a draft campaign. Only draft campaigns can be updated.

NameTypeRequiredDescription
campaign_idstringrequiredThe unique ID of the campaign.
fieldsobjectrequiredFields to update,required
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_update_contact#Update fields on an existing contact.3 params

Update fields on an existing contact.

NameTypeRequiredDescription
contact_idstringrequiredThe unique ID of the contact.
fieldsobjectrequiredFields to update,required
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_update_list#Update the name of an existing contact list.3 params

Update the name of an existing contact list.

NameTypeRequiredDescription
list_idstringrequiredThe unique ID of the contact list.
namestringrequiredDisplay name for the campaign.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_update_template#Update an existing email template.5 params

Update an existing email template.

NameTypeRequiredDescription
template_idstringrequiredThe unique ID of the template.
api_keystringoptionalYour MailerCloud API key for authentication.
htmlstringoptionalHTML content for the email body.
namestringoptionalDisplay name for the campaign.
plain_textstringoptionalPlain text fallback content for email clients that do not support HTML.
mailercloudmcp_update_webhook#Update an existing webhook's configuration.3 params

Update an existing webhook's configuration.

NameTypeRequiredDescription
fieldsobjectrequiredFields to update,required
webhook_idstringrequiredThe unique ID of the webhook.
api_keystringoptionalYour MailerCloud API key for authentication.
mailercloudmcp_upsert_contact#Create a contact if it doesn't exist, or update it if it does.5 params

Create a contact if it doesn't exist, or update it if it does.

NameTypeRequiredDescription
emailstringrequiredContact's email address.
list_idstringrequiredThe unique ID of the contact list.
api_keystringoptionalYour MailerCloud API key for authentication.
first_namestringoptionalContact's first name.
last_namestringoptionalContact's last name.