# mcp-server-dns

[![npm version](https://img.shields.io/npm/v/mcp-server-dns.svg)](https://www.npmjs.com/package/mcp-server-dns)
[![npm downloads](https://img.shields.io/npm/dm/mcp-server-dns.svg)](https://www.npmjs.com/package/mcp-server-dns)
[![CI](https://github.com/ofershap/mcp-server-dns/actions/workflows/ci.yml/badge.svg)](https://github.com/ofershap/mcp-server-dns/actions/workflows/ci.yml)
[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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

```bash
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](assets/demo.gif)

<sub>Demo built with <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a></sub>

## 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`:

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

### Claude Desktop

Add to `claude_desktop_config.json`:

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

### VS Code

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

```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

```bash
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](https://gitshow.dev/ofershap).

## Author

[![Made by ofershap](https://gitshow.dev/api/card/ofershap)](https://gitshow.dev/ofershap)

[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0A66C2?style=flat&logo=linkedin&logoColor=white)](https://linkedin.com/in/ofershap)
[![GitHub](https://img.shields.io/badge/GitHub-Follow-181717?style=flat&logo=github&logoColor=white)](https://github.com/ofershap)

---

<sub>README built with [README Builder](https://ofershap.github.io/readme-builder/)</sub>

## License

MIT © 2026 Ofer Shapira