DNS

v1.0.1โ€ขDeveloper Toolsโ€ขstable

๐Ÿ“‡ ๐Ÿ  - DNS lookups, reverse DNS, WHOIS, and domain availability checks. Zero auth, zero config.

dnsmcpai-integration
Share:
10
Stars
0
Downloads
0
Weekly
0/5

What is DNS?

DNS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“‡ ๐Ÿ  - dns lookups, reverse dns, whois, and domain availability checks. zero auth, zero config.

๐Ÿ“‡ ๐Ÿ  - DNS lookups, reverse DNS, WHOIS, and domain availability checks. Zero auth, zero config.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Perform DNS lookups and reverse DNS queries without configuration.
Check domain availability and retrieve WHOIS information.
Automate network diagnostics through AI.
r0bin2u

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.1
UpdatedApr 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y mcp-server-dns

Manual Installation

npx -y mcp-server-dns

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use DNS

The DNS MCP server provides four zero-configuration tools for DNS lookups, reverse DNS resolution, WHOIS/RDAP queries, and IP geolocation โ€” all using public free-tier endpoints with no API keys required. It is written in TypeScript and available as the mcp-server-dns npm package, installable in seconds via npx or pipx.

Prerequisites

  • Node.js 18+ (for npx usage) or Python 3.8+ with pipx/uv (for Python install)
  • Claude Desktop, Claude Code, or another MCP-compatible client
  • Internet access to reach public DNS resolvers and ip-api.com for geolocation
  • No API keys or authentication required
1

Install the package

Install dns-mcp using pipx or uv for a standalone tool installation, or use it directly via npx without a local install. For Claude Code, use the claude mcp add shortcut.

# Recommended: install as a standalone tool
pipx install dns-mcp

# Or with uv:
uv tool install dns-mcp

# For Claude Code:
claude mcp add dns dns-mcp

# No install needed โ€” run directly:
npx -y mcp-server-dns
2

Configure Claude Desktop

Edit claude_desktop_config.json to add the DNS server. If you installed with pipx or uv, use the dns-mcp command. If using npx, use npx with the -y flag.

{
  "mcpServers": {
    "dns": {
      "command": "dns-mcp"
    }
  }
}
3

Restart Claude Desktop

Restart Claude Desktop to activate the new MCP server. No API keys or environment variables are needed โ€” the server is ready to use immediately.

4

Verify the tools are available

Ask Claude to resolve a well-known domain to confirm all four DNS tools are accessible: resolve_dns, reverse_dns, whois_domain, and geo_ip.

DNS Examples

Client configuration

Minimal claude_desktop_config.json entry for the DNS MCP server using the dns-mcp command installed via pipx. Alternatively replace 'dns-mcp' with 'npx' and add args ["-y", "mcp-server-dns"].

{
  "mcpServers": {
    "dns": {
      "command": "dns-mcp"
    }
  }
}

Prompts to try

Sample prompts for using the DNS MCP server's four tools โ€” resolve_dns, reverse_dns, whois_domain, and geo_ip โ€” through Claude Desktop.

- "What are the A and MX records for github.com?"
- "Do a reverse DNS lookup on 140.82.121.4"
- "Who registered cloudflare.com and when does the domain expire?"
- "Geolocate the IP 8.8.8.8 โ€” which country, city, and ISP?"
- "Resolve foo.example.com and then geolocate its IP address"

Troubleshooting DNS

geo_ip returns an error or empty result

The geolocation tool uses the free tier of ip-api.com which requires HTTP (not HTTPS). Ensure your network does not block HTTP requests to ip-api.com. Private or RFC1918 IP addresses are not supported by the geolocation endpoint.

dns-mcp command not found after pipx install

Run pipx ensurepath to add the pipx bin directory to your PATH, then open a new terminal. Alternatively use the npx configuration: set command to 'npx' and args to ["-y", "mcp-server-dns"].

WHOIS query returns no data for a domain

The whois_domain tool uses RDAP rather than traditional WHOIS. Some ccTLDs (.uk, .de, etc.) have limited RDAP support. Try a gTLD domain (.com, .net, .org) to verify the tool is working correctly.

Frequently Asked Questions about DNS

What is DNS?

DNS is a Model Context Protocol (MCP) server that ๐Ÿ“‡ ๐Ÿ  - dns lookups, reverse dns, whois, and domain availability checks. zero auth, zero config. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install DNS?

Install via npm with the command: npx -y mcp-server-dns. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with DNS?

DNS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is DNS free to use?

Yes, DNS is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use DNS?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides