Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Mailercloud MCP server

Vendor MCP
Open markdown

The Mailercloud MCP connector routes your AI agent's tool calls to Mailercloud's own MCP server through Scalekit. Each user signs in to Mailercloud once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 47 tools.

Tools
47
What they doRead · write · destructive
27 · 17 · 327 read17 write3 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  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. Create the Mailercloud MCP connection

    In AgentKit > Connections, create a Mailercloud MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Mailercloud MCP server, so you don't need to register an OAuth app.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_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)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'mailercloudmcp_analyze_latest_campaigns',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • mailercloudmcp_analyze_campaignDeep-dive analysis of a single campaign's performance.Read-only

    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.

    Inputs

    campaign_idstringrequired
    The unique ID of the campaign.
    api_keystring
    Your MailerCloud API key for authentication.
    cost_per_emailnumber
    Optional cost per email sent, used to calculate ROI in reports.
  • mailercloudmcp_analyze_latest_campaignsAnalyze recent completed campaigns as a batch (default 5, up to 20 via count param).Read-only

    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.

    Inputs

    api_keystring
    Your MailerCloud API key for authentication.
    cost_per_emailnumber
    Optional cost per email sent, used to calculate ROI in reports.
    countinteger
    Number of recent campaigns to analyze (default: 5).
  • mailercloudmcp_audit_campaign_draftPre-send quality audit for a campaign draft.Read-only

    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.

    Inputs

    campaign_idstringrequired
    The unique ID of the campaign.
    api_keystring
    Your MailerCloud API key for authentication.
  • mailercloudmcp_campaign_health_dashboardQuick portfolio-level health check across recent campaigns.Read-only

    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.

    Inputs

    api_keystring
    Your MailerCloud API key for authentication.
    cost_per_emailnumber
    Optional cost per email sent, used to calculate ROI in reports.
  • mailercloudmcp_compare_campaignsSide-by-side comparison of two or more campaigns.Read-only

    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.

    Inputs

    campaign_idsstringrequired
    Array of campaign IDs to compare.
    api_keystring
    Your MailerCloud API key for authentication.
    cost_per_emailnumber
    Optional cost per email sent, used to calculate ROI in reports.
  • mailercloudmcp_engagement_funnelVisualize the engagement funnel for a sent campaign: total sent → delivered → opened → clicked.Read-only

    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.

    Inputs

    campaign_idstringrequired
    The unique ID of the campaign.
    api_keystring
    Your MailerCloud API key for authentication.
  • mailercloudmcp_get_account_overviewGet account plan details including limits, usage, and subscription information.Read-only

    Get Account Overview

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

    Inputs

    api_keystring
    Your MailerCloud API key for authentication.
  • mailercloudmcp_get_automationGet details of a specific automation workflow, optionally filtered by node type.Read-only

    Get Automation

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

    Inputs

    automation_idstringrequired
    The unique ID of the automation workflow.
    api_keystring
    Your MailerCloud API key for authentication.
    node_typestring
    Filter automation steps by node type (e.g. email, sms).
All 59 in Marketing