# MXToolbox — how to use (mcp.ai)

Connect your MXToolbox account and use 13 tools for server monitoring straight from your AI agent. Connect with your own API key. MxToolbox provides a suite of network diagnostic and monitoring tools, including DNS lookups, blacklist checks, and email health analysis.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mx_toolbox?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mx_toolbox_lookup_bimi_record`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mx_toolbox`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mx_toolbox/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/bimi/record` — Retrieves BIMI (Brand Indicators for Message Identification) record and diagnostic information for a domain. BIMI allows organizations to display verified logos in email clients. This tool checks: - W
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/blacklist` — 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.
  - body: { domain_or_ip: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/dkim` — Tool to retrieve DKIM (DomainKeys Identified Mail) records for a domain. DKIM is an email authentication method that helps prevent email spoofing by allowing the receiver to verify that an email was a
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/dmarc` — Retrieves DMARC (Domain-based Message Authentication, Reporting & Conformance) records for a domain and performs validation checks. Returns detailed information about the DMARC record including policy
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/dns` — Performs comprehensive DNS health check and retrieves name server records for a domain. Returns detailed diagnostics including: - Name server (NS) records with IP addresses, TTL, and status - DNS conf
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/http` — Tool to perform an HTTP test on a domain. Use when you need to assess HTTP connectivity and status for a given domain.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/mta/sts/record` — Tool to lookup MTA-STS record for a domain. Use when validating mail transport security policy.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/mx` — Retrieves MX (Mail Exchange) records for a domain. Returns the mail servers responsible for receiving email for the domain, including their priority, hostname, IP address, and TTL. Use this to discove
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/ping` — Performs a ping test to check network connectivity and measure round-trip time to a domain or IP address. Returns detailed ping statistics including response time, TTL (Time-To-Live), packet size, and
  - body: { domain_or_ip: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/smtp` — Tool to perform an SMTP connectivity test on a domain. Returns diagnostic results including connection status, DNS checks, TLS support, and other email deliverability indicators. Use when verifying SM
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/lookup/spf` — Tool to retrieve SPF records for a specified domain. Use when confirming email sender authorization policies.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/mx_toolbox/monitor/status` — Retrieves the current status of all monitors configured in the MX Toolbox account. This action returns a list of all monitors with their health status, last check time, reputation scores, and any fail
- `POST https://api.mcp.ai/api/mx_toolbox/usage/check` — Retrieve API usage statistics for DNS and network lookups. Returns current request counts, maximum allowed requests, and any overage errors for both DNS lookups and network operations (HTTP, SMTP, Pin

## Example prompts
- "What can I do in MXToolbox?"
- "Show me a summary of my MXToolbox account"

## More
- Page: https://mcp.ai/mx_toolbox
- Agent spec (llms.txt): https://mcp.ai/mx_toolbox/llms.txt
- Postman collection: https://mcp.ai/mx_toolbox/postman.json