Mailercloud MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

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

   Node.js

   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)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "mailercloudmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Mailercloud MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="mailercloudmcp_get_account_overview",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

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

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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your MailerCloud API key for authentication.

cost_per_email number optional Optional 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.

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

cost_per_email number optional Optional cost per email sent, used to calculate ROI in reports.

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

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your 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.

Name Type Required Description

contacts string required Array of contact objects,required

list_id string required The unique ID of the contact list.

api_key string optional Your 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.

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

cost_per_email number optional Optional 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.

Name Type Required Description

campaign_ids string required Array of campaign IDs to compare.

api_key string optional Your MailerCloud API key for authentication.

cost_per_email number optional Optional 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.

Name Type Required Description

list_ids string required List IDs to send to,required

name string required Display name for the campaign.

subject string required Subject line for the email.

api_key string optional Your MailerCloud API key for authentication.

email_preheader string optional Short preview text shown after the subject line in email clients (max 150 characters).

exclude_list_ids string optional List IDs to exclude from send

exclude_segments string optional Segment IDs to exclude from send

exclude_tag_ids string optional Tag IDs to exclude from send

frequency_cap string optional Limit how often a contact receives campaigns (e.g. daily, weekly).

html string optional HTML content for the email body.

is_publish string optional Set to 'true' to publish immediately; 'false' saves as a draft.

plain_text string optional Plain text fallback content for email clients that do not support HTML.

reply_email string optional Reply-to email address. Defaults to sender email if omitted.

reply_id string optional ID of a pre-configured reply-to email address (alternative to reply_email).

scheduled_at string optional Datetime to send the campaign, in YYYY-MM-DD HH:MM:SS format.

segments string optional Segment IDs

sender_email string optional Email address of the sender. Auto-resolved if your account has only one verified sender.

sender_id string optional Array of pre-configured sender IDs. Alternative to sender_name/sender_email.

sender_name string optional Display name for the sender. Auto-resolved if your account has only one verified sender.

tag_ids string optional Tag 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.

Name Type Required Description

email string required Contact's email address.

list_id string required The unique ID of the contact list.

api_key string optional Your MailerCloud API key for authentication.

city string optional Contact's city.

company_name string optional Contact's company or organization name.

country string optional Contact's country code (e.g. US, GB).

custom_fields object optional Custom field values

department string optional Contact's department within their organization.

first_name string optional Contact's first name.

job_title string optional Contact's job title.

last_name string optional Contact's last name.

phone string optional Contact's phone number in E.164 format.

state string optional Contact's state or region.

tags string optional Tags to assign

mailercloudmcp_create_list # Create a new contact list in MailerCloud. 3 params ▾

Create a new contact list in MailerCloud.

Name Type Required Description

list_type integer required Type of list: 1 for regular, 2 for single opt-in, 3 for double opt-in.

name string required Display name for the campaign.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_create_tag # Create a new tag for organizing contacts. 2 params ▾

Create a new tag for organizing contacts.

Name Type Required Description

name string required Display name for the campaign.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_create_template # Create a new HTML email template. 5 params ▾

Create a new HTML email template.

Name Type Required Description

html string required HTML content for the email body.

name string required Display name for the campaign.

api_key string optional Your MailerCloud API key for authentication.

category_id string optional ID of the template category to assign this template to.

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

Name Type Required Description

events string required Events to subscribe to,required

name string required Display name for the campaign.

url string required HTTPS URL to receive webhook event payloads.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_delete_contact # Delete a contact by ID. 2 params ▾

Delete a contact by ID.

Name Type Required Description

contact_id string required The unique ID of the contact.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_delete_list # Delete a contact list by ID. 2 params ▾

Delete a contact list by ID.

Name Type Required Description

list_id string required The unique ID of the contact list.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_delete_webhook # Delete a webhook. 2 params ▾

Delete a webhook.

Name Type Required Description

webhook_id string required The unique ID of the webhook.

api_key string optional Your 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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your 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.

Name Type Required Description

api_key string optional Your 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.

Name Type Required Description

automation_id string required The unique ID of the automation workflow.

api_key string optional Your MailerCloud API key for authentication.

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

Name Type Required Description

api_key string optional Your 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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your 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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

contact_id string required The unique ID of the contact.

api_key string optional Your 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.

Name Type Required Description

date_from string required Start date for inbox tracking data in YYYY-MM-DD format.

date_to string required End date for inbox tracking data in YYYY-MM-DD format.

api_key string optional Your MailerCloud API key for authentication.

campaign_id string optional The unique ID of the campaign.

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

Name Type Required Description

list_id string required The unique ID of the contact list.

api_key string optional Your 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.

Name Type Required Description

template_id string required The unique ID of the template.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_get_webhook # Get details of a specific webhook. 2 params ▾

Get details of a specific webhook.

Name Type Required Description

webhook_id string required The unique ID of the webhook.

api_key string optional Your 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.

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

list_id string required The unique ID of the contact list.

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

page integer optional Page number for paginated results (starts at 1).

search string optional Search query to filter segments by name or keyword.

sort_field string optional Field to sort results by (e.g. created_at, name).

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_list_webforms # List all webforms in your MailerCloud account. 3 params ▾

List all webforms in your MailerCloud account.

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

page integer optional Page number for paginated results (starts at 1).

mailercloudmcp_list_webhooks # List all webhooks configured in MailerCloud. 3 params ▾

List all webhooks configured in MailerCloud.

Name Type Required Description

api_key string optional Your MailerCloud API key for authentication.

limit integer optional Maximum number of results to return per page.

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

Name Type Required Description

campaign_id string required The unique ID of the campaign.

api_key string optional Your MailerCloud API key for authentication.

scheduled_at string optional Datetime 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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

recipients string required Test email recipients,required

api_key string optional Your 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.

Name Type Required Description

from string required Sender email address for the transactional email.

subject string required Subject line for the email.

to string required To recipients (array of name and email),required

amp_html string optional AMP HTML content. Use API version 2.0 when sending AMP content.

api_key string optional Your MailerCloud API key for authentication.

attachments string optional Attachments (array of name and url)

bcc string optional BCC recipients

cc string optional CC recipients

from_name string optional Sender display name for the transactional email.

html string optional HTML content for the email body.

reply_to string optional Reply-to addresses

text string optional Plain text fallback for the transactional email.

version string optional API 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.

Name Type Required Description

active boolean required Set to true to enable the webhook, false to disable it.

webhook_id string required The unique ID of the webhook.

api_key string optional Your 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.

Name Type Required Description

campaign_id string required The unique ID of the campaign.

fields object required Fields to update,required

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_update_contact # Update fields on an existing contact. 3 params ▾

Update fields on an existing contact.

Name Type Required Description

contact_id string required The unique ID of the contact.

fields object required Fields to update,required

api_key string optional Your 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.

Name Type Required Description

list_id string required The unique ID of the contact list.

name string required Display name for the campaign.

api_key string optional Your MailerCloud API key for authentication.

mailercloudmcp_update_template # Update an existing email template. 5 params ▾

Update an existing email template.

Name Type Required Description

template_id string required The unique ID of the template.

api_key string optional Your MailerCloud API key for authentication.

html string optional HTML content for the email body.

name string optional Display name for the campaign.

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

Name Type Required Description

fields object required Fields to update,required

webhook_id string required The unique ID of the webhook.

api_key string optional Your 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.

Name Type Required Description

email string required Contact's email address.

list_id string required The unique ID of the contact list.

api_key string optional Your MailerCloud API key for authentication.

first_name string optional Contact's first name.

last_name string optional Contact's last name.