Mcp Server Dns

by ofershap

291 downloads
Not rated
GitHub

About

# 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)…

Details

Author
ofershap
Downloads
291
Categories
Other

- DNS lookups for A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, PTR records.
- Reverse DNS (PTR) lookup on IP addresses.
- Resolve all record types with a single call using resolve_all.
- WHOIS queries with IANA referral following.
- Nameserver (NS) record checks for domains.
- Zero configuration – no API keys or accounts needed.

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Server Dns
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run npx mcp-server-dns or configure as an MCP server in Claude Desktop, Cursor, VS Code, or any MCP client using the provided JSON configuration. The server exposes five tools: dns_lookup, reverse_dns, resolve_all, check_nameservers, and whois.

dns_lookup

Look up DNS records for a domain. Returns A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, or PTR records.

reverse_dns

Perform a reverse DNS (PTR) lookup on an IP address.

resolve_all

Resolve all common DNS record types (A, AAAA, MX, TXT, NS, CNAME) for a domain in one call.

check_nameservers

Get the nameserver (NS) records for a domain.

whois

Query WHOIS data for a domain. Uses IANA and follows referrals to registrar WHOIS servers.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

mcp-server-dns

npm version
npm downloads
CI
TypeScript
License: 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.

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

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

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

Made by ofershap

LinkedIn
GitHub

---

<sub>README built with README Builder</sub>

License

MIT © 2026 Ofer Shapira

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.