mcp-server-dns

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.

!MCP server for DNS lookups, WHOIS queries, and domain checks

_{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