> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to MxToolbox

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.

**Authentication:** API Key
**Categories:** Developer Tools, Monitoring
**Tools:** 11: 11 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MXTOOLBOX)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "mxtoolbox"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="mxtoolbox_monitors_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their MxToolbox credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'mxtoolbox_lookup',
  toolInput: {
    argument: '<argument>',
    command: 'a',
  },
  connector: 'mxtoolbox',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="mxtoolbox_lookup",
    tool_input={
        "argument": "<argument>",
        "command": "a",
    },
    connection_name="mxtoolbox",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `mxtoolbox_lookup`

Run Lookup · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): 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.
- `command` (`string`, required): 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: `a`, `aaaa`, `arin`, `asn`, `bimi`, `blacklist`, `dkim`, `dmarc`, `dns`, `http`, `https`, `mta-sts`, `mx`, `ping`, `ptr`, `smtp`, `soa`, `spf`, `tcp`, `tlsrpt`, `trace`, `txt`.
- `port` (`string`, optional): Port for the lookup, required by tcp (for example 443) and optional for http, https and smtp. Example: 443.

Example input: `{"argument":"<argument>","command":"a"}`

### `mxtoolbox_lookup_blacklist`

Check Blacklists · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain name or IPv4 address to check. Example: 192.0.2.1.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_lookup_dkim`

Check DKIM Record · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain and DKIM selector joined by a colon, as domain:selector. Both parts are required. Example: example.com:google.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_lookup_dmarc`

Check DMARC Record · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain name to check. Example: example.com.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_lookup_dns`

Check DNS Health · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain name to check. Example: example.com.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_lookup_mx`

Lookup MX Records · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain name to check. Example: example.com.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_lookup_spf`

Check SPF Record · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `argument` (`string`, required): Domain name to check. Example: example.com.

Example input: `{"argument":"<argument>"}`

### `mxtoolbox_monitor_get`

Get Monitor · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `monitor_uid` (`string`, required): Monitor UID, from the MonitorUID field of mxtoolbox_monitors_list. Example: 1234567890.

Example input: `{"monitor_uid":"<monitor_uid>"}`

### `mxtoolbox_monitor_tags_list`

List Monitor Tags · Read-only

List the tags assigned to one monitor.
Returns tags with Name, UID, IsHidden, IsNegative and MonitorCount.
Use this to see how a monitor is grouped. Needs a paid API key.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `monitor_uid` (`string`, required): Monitor UID, from the MonitorUID field of mxtoolbox_monitors_list. Example: 1234567890.

Example input: `{"monitor_uid":"<monitor_uid>"}`

### `mxtoolbox_monitors_list`

List Monitors · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `command` (`string`, optional): Only monitors of this lookup type. Example: blacklist. One of: `a`, `aaaa`, `arin`, `asn`, `bimi`, `blacklist`, `dkim`, `dmarc`, `dns`, `http`, `https`, `mta-sts`, `mx`, `ping`, `ptr`, `smtp`, `soa`, `spf`, `tcp`, `tlsrpt`, `trace`, `txt`.
- `name` (`string`, optional): Only monitors for this domain name or IP address. Example: example.com.
- `tag` (`string`, optional): Only monitors with this tag, as defined in the MxToolbox dashboard. Example: production.

Example input: `{}`

### `mxtoolbox_usage_get`

Get API Usage · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
