WHOIS MCP Server

Native WHOIS protocol (TCP port 43) with 877+ TLD support and comprehensive parsing for 169 country-code TLDs.

Install from npm View on GitHub

Key Features

Native WHOIS Protocol

Direct TCP port 43 connections to authoritative WHOIS servers

877+ TLDs Supported

Comprehensive dictionary of WHOIS servers for all major TLDs

169 ccTLD Parsers

Format-specific parsing for country-code TLDs (.gg, .pl, .jp, .kr, .ru, .de, .it, etc.)

Auto-Update

Refresh WHOIS server dictionary from IANA with built-in tool

Comprehensive Parsing

Extracts registrar, dates, nameservers, status, DNSSEC, contacts

Lightweight

Single-file executable with minimal dependencies

Installation

Install via npm

Install the package globally or locally:

npm install whois-mcp

Use with npx (No Installation)

Run directly without installing:

npx -y whois-mcp

Claude Desktop Configuration

1. Locate Your Config File

MacOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

2. Add WHOIS MCP Configuration

Add this configuration to your claude_desktop_config.json file:

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

3. Restart Claude Desktop

After saving the config file, restart Claude Desktop. You'll see the WHOIS tools available in the 🔌 menu.

Claude Code Configuration

1. Locate Your Config File

MacOS/Linux

~/.config/claude-code/settings.json

Windows

%APPDATA%\claude-code\settings.json

2. Add WHOIS MCP Configuration

Add this configuration to the "mcpServers" section of your settings.json:

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

3. Restart Claude Code

After saving the config file, restart Claude Code. The WHOIS MCP server will be available for domain lookups.

Available Tools

whois_lookup

Look up domain registration information using the proper WHOIS protocol (port 43).

Parameters

domainrequired

Domain name to look up (e.g., google.com, theo.gg, mineo.pl)

include_rawoptional

Include raw WHOIS response data (default: false)

Example Response

{
  "domain": "theo.gg",
  "found": true,
  "method": "whois",
  "server": "whois.gg",
  "timestamp": "2025-10-30T11:11:32.936Z",
  "registrar": "NameCheap, Inc",
  "registrant": "Redacted for privacy",
  "creationDate": "2021-01-14T00:00:00Z",
  "expirationDate": "2026-01-14T00:00:00Z",
  "nameservers": [
    "dns1.registrar-servers.com",
    "dns2.registrar-servers.com"
  ],
  "status": ["Active", "Transfer Prohibited by Registrar"]
}

list_supported_tlds

List all TLDs that have WHOIS servers available for querying.

Parameters

limitoptional

Maximum number of TLDs to return (default: all)

Example Response

{
  "totalCount": 877,
  "returnedCount": 10,
  "tlds": [
    "aaa", "aarp", "abarth", "abb", "abbott",
    "abbvie", "abc", "able", "abogado", "abudhabi"
  ],
  "timestamp": "2025-10-30T11:11:32.936Z"
}

refresh_whois_servers

Refresh the WHOIS server dictionary by fetching the latest TLD list from IANA. Run this periodically to ensure the server list is up-to-date with new TLDs.

Example Response

{
  "success": true,
  "message": "WHOIS server dictionary refreshed successfully",
  "previousCount": 877,
  "currentCount": 880,
  "added": 3,
  "timestamp": "2025-10-30T11:11:32.936Z",
  "output": "Sync complete! Updated whois_dict.json"
}

Supported TLDs

The server includes a comprehensive dictionary with WHOIS servers for 877+ TLDs and format-specific parsers for 169 country-code TLDs.

Generic TLDs

com, net, org, info, biz, app, dev, ai, io, me, ly, and hundreds more new gTLDs

Country Code TLDs (169 with parsers)

gg, pl, jp, kr, ru, de, it, fr, uk, au, nz, ca, and many more with format-specific parsing

Parser Features

.gg/.je style: Natural language dates ("30th April 2003")
.jp style: Square bracket format [Domain Name] GOOGLE.JP
.kr style: Dotted dates 2007. 03. 02.
.ru style: Cyrillic fields with IP addresses

Related MCP Servers

RDAP MCP

Pure RDAP protocol for structured domain data. Lightweight and modern.

Learn more

DomainDetails MCP

Full-featured domain research with RDAP + WHOIS fallback

Learn more

Ready to Get Started?

Install WHOIS MCP and start looking up domain information in Claude Desktop today.

Install from npm View on GitHub