Rdap MCP server

@pipeworx/rdap

RDAP MCP — Registration Data Access Protocol queries for domains, IPs, ASNs and nameservers. The structured-JSON successor to WHOIS, answered by the registry's own service. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1679+ live data sources.

Tools

• domain(name | domain, base?) — domain registration record: registrar, registration/expiry dates, nameservers, status. A registry 404 is an answer, not an error — it comes back as {registered: false}, which is what makes availability sweeps work.
• ip(address | ip) — IP / netblock allocation record
• asn(number) — ASN allocation record
• entity(handle, base?) — registry entity by handle (e.g. registrant id)
• nameserver(host, base?) — nameserver (glue) record, where the registry supports it

Auth

None. Every endpoint queried is a public registry RDAP service.

TLD coverage — and the gap in IANA's bootstrap

Server discovery normally goes through IANA's RDAP bootstrap (https://data.iana.org/rdap/dns.json, cached 24h). That file is incomplete. As of publication 2026-07-23 it lists 1,200 of the 1,438 delegated TLDs; the 238 it omits are almost entirely ccTLDs that never registered their RDAP endpoint with IANA. Measured against the Majestic Million on 2026-08-30, those 238 TLDs carry 23.4% of the world's most-linked domains — including .io, .de, .us, .me and .ru.

So the pack carries FALLBACK_BASES (see src/index.ts): registry RDAP endpoints for TLDs IANA omits. IANA is still consulted first, so the map goes quiet on its own the day a registry is added upstream. Currently covered beyond IANA:

Adding a TLD to that map — read this first. Verify by fetching /domain/ and requiring HTTP 200 with a real record. rdap.identitydigital.services returns a well-formed RDAP 404 for TLDs it does not serve, so a 404 there is indistinguishable from "this domain is unregistered". A wrong base URL therefore does not error — it reports every registered domain in that TLD as available. That is the failure this pack is built to avoid.

Many ccTLDs run no public RDAP service at all. Probed 2026-08-30, the conventional rdap. hostnames for .ru, .it, .eu, .se and .co do not resolve (NXDOMAIN), so there is nothing to add to the map for them. For those, domain returns {found: false, reason: "tldnotinianabootstrap"} with a message saying the gap is IANA's rather than ours, plus a hint: pass the registry's own endpoint as base if you know it, otherwise use that registry's WHOIS page. It deliberately does not** throw — an upstream registry gap is not a Pipeworx defect and should not book as one.

Data sources

• IANA RDAP bootstrap: (+ ipv4, ipv6, asn)
• IANA delegated-TLD list:
• Individual RIR / registry RDAP servers reached via the above

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "rdap": {
      "url": "https://gateway.pipeworx.io/rdap/mcp"
    }
  }
}

What this endpoint actually serves

Shortened. The full README is on GitHub.