mcp-server-dns

DNS lookups, reverse DNS, WHOIS, and domain checks from your AI assistant. No API keys, no config. Powered by Node.js built-in DNS.

npx mcp-server-dns

Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Uses Node.js native dns module, so there's nothing to sign up for.

Demo built with remotion-readme-kit

Why

DNS and WHOIS lookups come up more often than you'd think during development. Debugging email delivery? You need MX records. Setting up a new domain? Check the nameservers. Investigating a suspicious URL? WHOIS tells you who owns it. The existing MCP options for this require paid API keys (like WhoisXML API). This server uses Node.js built-in DNS resolution and public WHOIS servers, so it works out of the box with zero accounts or credentials.

Tools

| Tool | What it does | | ------------------- | ------------------------------------------------------ | | dns_lookup | Look up A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, or PTR | | reverse_dns | Perform reverse DNS (PTR) lookup on an IP address | | resolve_all | Resolve A, AAAA, MX, TXT, NS, CNAME in one call | | check_nameservers | Get nameserver (NS) records for a domain | | whois | Query WHOIS data (follows IANA referrals to registrar) |

Quick Start

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "dns": {
      "command": "npx",
      "args": ["-y", "mcp-server-dns"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "dns": {
      "command": "npx",
      "args": ["-y", "mcp-server-dns"]
    }
  }
}

VS Code

Add to user settings or .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "dns": {
        "command": "npx",
        "args": ["-y", "mcp-server-dns"]
      }
    }
  }
}

Examples

• "What are the DNS records for example.com?"
• "Do a reverse DNS lookup on 8.8.8.8"
• "Show me the WHOIS info for github.com"
• "What nameservers does cloudflare.com use?"
• "Resolve all record types for google.com"
• "Check the MX records for my-company.com"

Development

git clone https://github.com/ofershap/mcp-server-dns.git
cd mcp-server-dns
npm install
npm test
npm run build

Author

Ofer Shapira

License

MIT © 2026 Ofer Shapira