io.github.cyanheads/whois-mcp-server

Official

by cyanheads · TypeScript

Domain registration, availability, DNS records, and IP/ASN resolution via RDAP and DNS-over-HTTPS.

Domain registration, DNS records, and IP/ASN resolution via RDAP and DNS-over-HTTPS.

Topics

ai-agentsai-toolscyanheadsdnsdomainmcpmcp-servermodel-context-protocolrdaptypescriptwhois

Install

Configuration

Environment variables

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

RDAP_TIMEOUT_MSdefault 5000

HTTP timeout for RDAP requests in milliseconds.

DOH_TIMEOUT_MSdefault 3000

HTTP timeout for DNS-over-HTTPS requests in milliseconds.

RDAP_MAX_RETRIESdefault 2

Max retry attempts on transient RDAP failures.

DOH_MAX_RETRIESdefault 2

Max retry attempts on transient DNS-over-HTTPS failures.

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_PUBLIC_URL

Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

claude_desktop_config.json

{
  "mcpServers": {
    "whois-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/whois-mcp-server@0.1.3",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "info",
        "RDAP_TIMEOUT_MS": "5000",
        "DOH_TIMEOUT_MS": "3000",
        "RDAP_MAX_RETRIES": "2",
        "DOH_MAX_RETRIES": "2"
      }
    }
  }
}