cyanheads avatar

Whois Mcp Server

cyanheads/whois-mcp-server

A lightweight RDAP and DNS-over-HTTPS client that lets Claude look up domain registrations, check name availability, fetch DNS records, and resolve IPs and ASNs without any API keys. Built on IANA bootstrap for automatic registry selection across all TLDs and RIRs. The six tools cover individual lookups (domain WHOIS, DNS records, IP netblocks, ASN details) plus a unified dossier call that runs registration and DNS queries in parallel. Useful for security triage, domain research, or network reconnaissance workflows where you need factual signals like registrar, nameservers, age, and privacy redaction status. Runs on stdio or streamable HTTP, surfaces partial failures as data rather than errors, and handles RDAP-less TLDs explicitly instead of breaking silently.

GitHub stars
2
tools
6
transport
STDIO, HTTP
env vars
11
last updated
Nov 11, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

whois_lookup_domainFull domain registration record — registrar, created/expiry dates, nameservers, EPP status, DNSSEC, registrant org

Full domain registration record — registrar, created/expiry dates, nameservers, EPP status, DNSSEC, registrant org

No parameter schema in public metadata yet.

whois_check_availabilityCheck registry record presence; missing records do not establish registration eligibility

Check registry record presence; missing records do not establish registration eligibility

No parameter schema in public metadata yet.

whois_get_dnsDNS owner records via DNS-over-HTTPS (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, PTR)

DNS owner records via DNS-over-HTTPS (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, PTR)

No parameter schema in public metadata yet.

whois_lookup_ipIP or CIDR netblock, org, country, abuse contact, and reverse DNS via RIR RDAP

IP or CIDR netblock, org, country, abuse contact, and reverse DNS via RIR RDAP

No parameter schema in public metadata yet.

whois_lookup_asnResolve an ASN to its org name, country, and RIR source

Resolve an ASN to its org name, country, and RIR source

No parameter schema in public metadata yet.

whois_get_dossierOne-call domain triage — registration + DNS in parallel, normalized into a single record with factual signals

One-call domain triage — registration + DNS in parallel, normalized into a single record with factual signals

No parameter schema in public metadata yet.

Sponsors

Configuration

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

Selects the HTTP transport.

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'.

Readme

@cyanheads/whois-mcp-server

Look up domain registration, check registry record status, fetch DNS records, and resolve IPs and ASNs over RDAP and DNS-over-HTTPS via MCP. STDIO or Streamable HTTP.

6 Tools

Details

Repository
github.com/cyanheads/whois-mcp-server
Package
@cyanheads/whois-mcp-server
Transport
STDIO, HTTP
Registry
MCP registry, active

More from cyanheads