Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Mandrill (Mailchimp Transactional)

Scalekit connector
Open markdown

The Mandrill (Mailchimp Transactional) connector lets your AI agent act in each user's Mandrill (Mailchimp Transactional) account. Each user connects their own Mandrill (Mailchimp Transactional) API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 61 tools.

Tools
61
What they doRead · write · destructive
33 · 18 · 1033 read18 write10 destructive
Users sign in with

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 Mandrill (Mailchimp Transactional) connection

    In AgentKit > Connections, create a Mandrill (Mailchimp Transactional) connection. The name you give it is the connection_name your code passes. See Configure connections.

  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 = 'mandrill'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Mandrill (Mailchimp Transactional):', 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: 'mandrill_user_info_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Mandrill (Mailchimp Transactional) credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • mandrill_allowlist_listList addresses on the allowlist, which are never added to the denylist automatically.Read-only

    List Allowlist

    List addresses on the allowlist, which are never added to the denylist automatically. Returns an array with email, detail and created_at.

    Inputs

    emailstring
    An optional email address or prefix to search by. Example: jane@example.com
  • mandrill_inbound_domain_checkCheck an inbound domain's MX records now.Read-only

    Check Inbound Domain

    Check an inbound domain's MX records now. Returns domain, created_at and valid_mx.

    Inputs

    domainstringrequired
    An existing inbound domain. Example: mail.example.com
  • mandrill_inbound_domains_listList the domains configured to receive inbound email.Read-only

    List Inbound Domains

    List the domains configured to receive inbound email. Returns an array with domain, created_at and valid_mx.

    Inputs

    This tool takes no inputs.

  • mandrill_inbound_routes_listList the mailbox routes for an inbound domain.Read-only

    List Inbound Routes

    List the mailbox routes for an inbound domain. Returns an array with id, pattern and url.

    Inputs

    domainstring
    The domain to check (required if phone is not provided) Example: mail.example.com
    phonestring
    The SMS program phone number (required if domain is not provided) Example: +15551234567
  • mandrill_message_content_getRetrieve the full content (subject, from, to, headers, HTML, text and attachments) of a recently sent message.Read-only

    Get Message Content

    Retrieve the full content (subject, from, to, headers, HTML, text and attachments) of a recently sent message. Returns ts, _id, from_email, from_name, subject, to, tags, headers, text, html and attachments. Content is kept only for a few days.

    Inputs

    idstringrequired
    Message ID (_id) of a recently sent message. Example: abc123abc123abc123abc123abc123
  • mandrill_message_info_getRetrieve the delivery details of one sent message.Read-only

    Get Message Info

    Retrieve the delivery details of one sent message. Returns ts, _id, sender, template, subject, email, tags, opens, opens_detail, clicks, clicks_detail, state, metadata and smtp_events.

    Inputs

    idstringrequired
    Message ID (_id) returned when the message was sent or by mandrill_messages_search. Example: abc123abc123abc123abc123abc123
  • mandrill_message_parseParse a raw MIME message into its parts without sending it.Read-only

    Parse MIME Message

    Parse a raw MIME message into its parts without sending it. Returns subject, from_email, from_name, to, headers, text, html, attachments and images.

    Inputs

    raw_messagestringrequired
    The full MIME document of an email message. Example: From: orders@example.com To: jane@example.com Subject: Hi Hello