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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the MxToolbox connection
In AgentKit > Connections, create a MxToolbox connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'mxtoolbox'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'mxtoolbox_monitors_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "mxtoolbox"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize MxToolbox:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="mxtoolbox_monitors_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolmxtoolbox_lookupRun any MxToolbox SuperTool lookup (DNS records, email authentication, blacklists or network tests) on a domain or IP address.Read-onlyRun 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-onlyCheck 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-onlyCheck 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-onlyCheck 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-onlyCheck 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-onlyLookup 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-onlyCheck 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-onlyGet 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.
mxtoolbox_monitors_listList the monitors on your MxToolbox account with their current status, optionally filtered by lookup type, monitored name or tag.Read-onlyList Monitors
List the monitors on your MxToolbox account with their current status, optionally filtered by lookup type, monitored name or tag. Returns monitors with MonitorUID, Name, ActionString (current status), LastTransition, MxRep, HistoryUrl, Tags, Failing and Warnings. Use this to see which monitored domains or IPs are failing. Monitor queries need a paid API key.
Inputs
commandstring- Only monitors of this lookup type. Example: blacklist.one of
aaaaaarinasnbimiblacklistdkimdmarcdnshttphttpsmta-stsmxpingptrsmtpsoaspftcptlsrpttracetxt namestring- Only monitors for this domain name or IP address. Example: example.com.
tagstring- Only monitors with this tag, as defined in the MxToolbox dashboard. Example: production.
mxtoolbox_usage_getGet your MxToolbox API usage for the current day against your plan limits.Read-onlyGet API Usage
Get your MxToolbox API usage for the current day against your plan limits. Returns DnsRequests and DnsMax, and NetworkRequests and NetworkMax. Use this before running many lookups. Limits reset daily at 00:00 UTC.
Inputs
This tool takes no inputs.
No tools match.