DNS and WHOIS query MCP server
About
Perform DNS lookups, WHOIS queries, connectivity testing, TLS certificate analysis, HTTP endpoint monitoring, and hostname resolution, all from your trusty AI.
Details
- License
- MIT
Explore
- Local DNS Queries: Perform DNS lookups using the OS-configured DNS servers
- Remote DNS-over-HTTPS: Perform secure DNS queries via Cloudflare and Google DNS-over-HTTPS services
- WHOIS Lookups: Perform WHOIS queries to get domain registration information
- Hostname Resolution: Convert hostnames to their corresponding IP addresses (IPv4, IPv6, or both)
- Ping Operations: Test connectivity and measure response times to hosts using ICMP
- HTTP Ping Operations: Test HTTP endpoints and measure detailed response times including DNS, connection, TLS, and TTFB timing
- TLS Certificate Analysis: Check TLS certificate chains for validity, expiration, and detailed certificate information
- Multiple Record Types: Support for A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, and TXT record types
- Fallback Mechanism: Automatically tries multiple DNS servers for reliable results
- SSE Support: Run as an HTTP server with Server-Sent Events (SSE) for web-based integrations
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
DNS and WHOIS query MCP serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
There are two ways to get this MCP server: you can use the Docker mode (which, if you have Docker installed, will automatically download and run the MCP server) or the binary options, both by getting one from the releases page or by installing it with Homebrew for macOS and Linux.
Add the following configuration to your editor's settings to use mcp-netutils via the binary option:
{
"mcpServers": {
"netutils": {
"command": "mcp-netutils",
"args": [
// Uncomment and modify as needed:
// "--remote-server-address=https://your-custom-doh-server.com/dns-query",
// "--custom-whois-server=whois.yourdomain.com",
// "--timeout=5s",
// "--ping-timeout=5s",
// "--ping-count=4",
// "--http-ping-timeout=10s",
// "--http-ping-count=1",
// "--tls-timeout=10s"
],
"env": {}
}
}
}
You can use mcp-netutils directly from your $PATH as shown above, or provide the full path to the binary (e.g., /path/to/mcp-netutils).
Alternatively, you can run mcp-netutils directly with Docker without installing the binary:
{
"mcpServers": {
"netutils": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/patrickdappollonio/mcp-netutils:latest",
// Add custom options if needed:
// "--remote-server-address=https://your-custom-doh-server.com/dns-query",
// "--custom-whois-server=whois.yourdomain.com",
// "--timeout=5s",
// "--ping-timeout=5s",
// "--ping-count=4",
// "--http-ping-timeout=10s",
// "--http-ping-count=1",
// "--tls-timeout=10s"
],
"env": {}
}
}
}
See "Available MCP Tools" for information on the tools exposed by mcp-netutils.
The following command-line flags are available to configure the MCP server:
There are 7 tools available:
- local_dns_query: Perform DNS queries against the local DNS resolver as configured by the OS
- remote_dns_query: Perform DNS queries against a remote DNS-over-HTTPS server (Cloudflare/Google)
- whois_query: Perform WHOIS lookups to get domain registration information
- resolve_hostname: Convert a hostname to its corresponding IP addresses (IPv4, IPv6, or both)
- ping: Perform ICMP ping operations to test connectivity and measure response times to hosts
- http_ping: Perform HTTP ping operations to test HTTP endpoints and measure detailed response times
- tls_certificate_check: Check TLS certificate chain for a domain to analyze certificate validity, expiration, and chain structure
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"dns and whois query mcp server": {
"dns": {
"command": "mcp-domaintools",
"args": [],
"env": []
}
}
}
}McpServers
{
"dns": {
"command": "mcp-domaintools",
"args": [],
"env": []
}
}WHOIS Query
Performs WHOIS lookups to get domain registration information.
Arguments:
- domain (required): The domain name to query (e.g., example.com)
Example:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
