Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to MxToolbox

Scalekit connector
Open markdown

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

Tools
11
What they doRead · write · destructive
11 · 0 · 011 read0 write0 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 MxToolbox connection

    In AgentKit > Connections, create a MxToolbox 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 = 'mxtoolbox'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize MxToolbox:', 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: 'mxtoolbox_monitors_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their MxToolbox 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
  • mxtoolbox_lookupRun any MxToolbox SuperTool lookup (DNS records, email authentication, blacklists or network tests) on a domain or IP address.Read-only

    Run Lookup

    Run any MxToolbox SuperTool lookup (DNS records, email authentication, blacklists or network tests) on a domain or IP address. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this for commands without a dedicated tool (a, aaaa, ptr, soa, txt, bimi, mta-sts, tlsrpt, asn, arin, http, https, ping, smtp, tcp, trace). DNS commands use the DNS quota; blacklist, http, https, ping, smtp, tcp and trace use the network quota, which is 0 on free plans.

    Inputs

    argumentstringrequired
    Domain name or IP address to look up. For dkim use domain:selector, for example example.com:default; for ptr use an IP address. Example: example.com.
    commandstringrequired
    Lookup type to run. DNS: a, aaaa, asn, bimi, dkim, dmarc, dns, mta-sts, mx, ptr, soa, spf, tlsrpt, txt. Network (paid quota): blacklist, http, https, ping, smtp, tcp, trace. arin looks up IP ownership. Example: txt.one of aaaaaarinasnbimiblacklistdkimdmarcdnshttphttpsmta-stsmxpingptrsmtpsoaspftcptlsrpttracetxt
    portstring
    Port for the lookup, required by tcp (for example 443) and optional for http, https and smtp. Example: 443.
  • mxtoolbox_lookup_blacklistCheck whether a domain or IP address is listed on major email blacklists (DNSBLs).Read-only

    Check Blacklists

    Check whether a domain or IP address is listed on major email blacklists (DNSBLs). Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this to investigate deliverability or reputation problems. Network quota is 0 on free plans. Counts against the network request quota.

    Inputs

    argumentstringrequired
    Domain name or IPv4 address to check. Example: 192.0.2.1.
  • mxtoolbox_lookup_dkimLook up and check a DKIM public key record for a domain and selector.Read-only

    Check DKIM Record

    Look up and check a DKIM public key record for a domain and selector. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this when you know the DKIM selector the sender uses. Counts against the DNS request quota.

    Inputs

    argumentstringrequired
    Domain and DKIM selector joined by a colon, as domain:selector. Both parts are required. Example: example.com:google.
  • mxtoolbox_lookup_dmarcCheck a domain's DMARC policy record.Read-only

    Check DMARC Record

    Check a domain's DMARC policy record. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this with mxtoolbox_lookup_spf and mxtoolbox_lookup_dkim to audit email authentication. Counts against the DNS request quota.

    Inputs

    argumentstringrequired
    Domain name to check. Example: example.com.
  • mxtoolbox_lookup_dnsRun a general DNS health check on a domain: name server configuration, SOA and propagation.Read-only

    Check DNS Health

    Run a general DNS health check on a domain: name server configuration, SOA and propagation. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this to diagnose DNS setup problems. Use mxtoolbox_lookup for a single record type. Counts against the DNS request quota.

    Inputs

    argumentstringrequired
    Domain name to check. Example: example.com.
  • mxtoolbox_lookup_mxLook up a domain's mail exchange (MX) servers and check them.Read-only

    Lookup MX Records

    Look up a domain's mail exchange (MX) servers and check them. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this to see where a domain's email is delivered. Counts against the DNS request quota.

    Inputs

    argumentstringrequired
    Domain name to check. Example: example.com.
  • mxtoolbox_lookup_spfCheck a domain's SPF record and validate its Sender Policy Framework configuration.Read-only

    Check SPF Record

    Check a domain's SPF record and validate its Sender Policy Framework configuration. Returns the lookup result: Command, CommandArgument, TimeRecorded, ReportingNameServer, TimeToComplete and the Failed, Warnings, Passed and Timeouts check lists (each item has ID, Name, Info and Url). Use this to debug email authentication and deliverability. Counts against the DNS request quota.

    Inputs

    argumentstringrequired
    Domain name to check. Example: example.com.
  • mxtoolbox_monitor_getGet one monitor by its UID with its current status and failing checks.Read-only

    Get Monitor

    Get one monitor by its UID with its current status and failing checks. Returns the monitor's MonitorUID, Name, ActionString, LastTransition, MxRep, HistoryUrl, Tags, Failing and Warnings. Use mxtoolbox_monitors_list to find the UID. Needs a paid API key.

    Inputs

    monitor_uidstringrequired
    Monitor UID, from the MonitorUID field of mxtoolbox_monitors_list. Example: 1234567890.