Network Diagnostics

Mx toolbox

Learn how to use Mx toolbox with Composio

Overview

SLUG: MX_TOOLBOX

Description

MxToolbox provides a suite of network diagnostic and monitoring tools, including DNS lookups, blacklist checks, and email health analysis.

Authentication Details

generic_api_key
stringRequired

Connecting to Mx toolbox

Create an auth config

Use the dashboard to create an auth config for the Mx toolbox toolkit. This allows you to connect multiple Mx toolbox accounts to Composio for agents to use.

1

Select App

Navigate to [Mx toolbox](https://platform.composio.dev/marketplace/Mx toolbox).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Mx toolbox Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4mx_toolbox_auth_config_id = "ac_YOUR_MX_TOOLBOX_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Mx toolbox for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, mx_toolbox_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Mx toolbox toolkit’s playground](https://app.composio.dev/app/Mx toolbox)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["MX_TOOLBOX"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Lookup BIMI Record

Description

Tool to retrieve bimi (brand indicators for message identification) record for a domain. use when checking domain brand identity via bimi lookup.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup Blacklist

Description

Tool to perform a blacklist check on a domain or ip. use when you need to verify whether a domain or ip is listed in common blacklists.

Action Parameters

domain_or_ip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup DKIM Record

Description

Tool to retrieve dkim records for a domain. use when verifying dkim configuration before sending email.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup DMARC Record

Description

Tool to retrieve dmarc records for a domain. use after confirming the domain is correctly formatted.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup DNS Records

Description

Tool to retrieve dns records for a given domain. use when you need dns lookup details.

Action Parameters

domain
stringRequired

Action Response

data
arrayRequired
error
string
information
arrayRequired
messages
arrayRequired
success
booleanRequired
successful
booleanRequired

Tool Name: HTTP Lookup

Description

Tool to perform an http test on a domain. use when you need to assess http connectivity and status for a given domain.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup MTA-STS Record

Description

Tool to lookup mta-sts record for a domain. use when validating mail transport security policy.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup MX Records

Description

Tool to retrieve mx records for a given domain. use when you need to discover mail exchange servers after obtaining a domain.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Ping Lookup

Description

Tool to perform a ping test on a specified domain or ip address. use when you need hop-by-hop network latency diagnostics.

Action Parameters

domain_or_ip
Required

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: SMTP Lookup

Description

Tool to perform an smtp test on the specified domain. use when verifying smtp connectivity for a domain.

Action Parameters

domain
Required

Action Response

Data
arrayRequired
Information
string
Message
stringRequired
Requirements
array
error
string
successful
booleanRequired

Tool Name: Lookup SPF Record

Description

Tool to retrieve spf records for a specified domain. use when confirming email sender authorization policies.

Action Parameters

domain
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Monitor Status

Description

Tool to retrieve all monitor statuses. use when you need to get current health details of all account monitors.

Action Parameters

Action Response

Data
arrayRequired
ErrorMessage
string
Success
booleanRequired
error
string
successful
booleanRequired

Tool Name: Check Usage

Description

Tool to retrieve api usage statistics. use when you need to monitor remaining api calls and quota reset timing.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired