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 <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a>}

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

See also

More MCP servers and developer tools on my portfolio.

Author

---

_{README built with README Builder}

License

MIT © 2026 Ofer Shapira