MCP documentation menu

datapulse_live_rdap

OtherScope: datapulse:dnsRead-only

Live RDAP registration lookup of one domain or IP address (v4 or v6), synchronous.

Description

Live RDAP registration lookup of one domain or IP address (v4 or v6), synchronous.

A domain is reduced to its registrable name under the full Public Suffix List (www.Example.COM. becomes example.com, and submitted_domain echoes your input); this is the only tool family that removes hostname labels. CIDR ranges, single labels and reserved addresses are refused with the reason.

Returns the API’s envelope {query, source, datetime, results} plus sent and type (domain or ip). source is cache, datapulse (a crawl dated by researchdate, which can be weeks old) or live; force=true looks a domain up live. Domain results: name, ianaid (absent when the registry assigns no IANA registrar IDs, Nominet .uk among others), registrationdate, expiration_date, last_changed, status, dns, abuse_email, abuse_phone. A result with an error field is the registry’s own report of a failed lookup (an unregistered name, a TLD without RDAP such as .de or .edu). No registrant contact data: the abuse contacts are the registrar’s, and there is no reverse WHOIS.

Give query or domain_hash: the hash reads the row a datapulse_live_rdap_bulk submission stored (submitted[].domain_hash), and a hash with no row answers found: false. For many queries: datapulse_live_rdap_bulk (up to 150).

Reference: datapulse_help(topic="rdap")

Parameters

ParameterTypeDescription
domain_hashstring
A stored RDAP row, read instead of a new lookup: the domain_hash from a datapulse_live_rdap_bulk receipt (submitted[].domain_hash). Give this or query; force does not apply.
Min length: 64Max length: 64Pattern: ^[a-fA-F0-9]{64}$
forceboolean
A live lookup that skips the caches (with query only). Default false.
querystring
Domain name or IP address (v4/v6) to look up (e.g., ’example.com’, ‘8.8.8.8’, ‘2606:4700:4700::1111’). A CIDR range is not accepted; a lookup of one address inside it returns the whole allocation. Give this or domain_hash.
Min length: 1Max length: 253
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "domain_hash": {
      "description": "A stored RDAP row, read instead of a new lookup: the domain_hash from a datapulse_live_rdap_bulk receipt (submitted[].domain_hash). Give this or query; force does not apply.",
      "maxLength": 64,
      "minLength": 64,
      "pattern": "^[a-fA-F0-9]{64}$",
      "type": "string"
    },
    "force": {
      "description": "A live lookup that skips the caches (with query only). Default false.",
      "type": "boolean"
    },
    "query": {
      "description": "Domain name or IP address (v4/v6) to look up (e.g., 'example.com', '8.8.8.8', '2606:4700:4700::1111'). A CIDR range is not accepted; a lookup of one address inside it returns the whole allocation. Give this or domain_hash.",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.