MCP documentation menu

datapulse_dns_rdap_history

OtherScope: datapulse:dnsRead-only

The RDAP observations DataPulse has taken of a domain over time: registrar (ianaid), abuse contacts, EPP status, nameservers and …

Description

The RDAP observations DataPulse has taken of a domain over time: registrar (ianaid), abuse contacts, EPP status, nameservers and registration dates per crawl. Useful for dating registrar transfers, holds and abuse-contact changes; datapulse_live_rdap gives the current state.

The input is reduced to its registrable domain under the full Public Suffix List, private suffixes included (www.example.com -> example.com; microsoft.jp.net is kept). RDAP tools are the only ones that remove hostname labels; the DNS tools ask for the exact name.

Returns the API’s envelope {query, submitted_domain?, datetime, server_id, results: [{name, researchdate, ianaid, registrationdate, expiration_date, last_changed, status, dns, abuse_email, abuse_phone, registrant_cc?, error?}]} plus paging. results run newest first; the newest is a scheduled crawl and can be weeks old. An entry with error is a failed collection, not a fact about the domain. An empty results array is the API’s “known name, no data” answer. No registrant contact data is published.

Observations are paged: default 50, max 90 (larger values are capped), about 650 bytes each. truncated: true means more follow: the page is a SUBSET, and next_offset is the offset to pass for the next one, as note says.

A domain with no observations is an answer, not an error: {domain, found:false, detail?, note}.

Reference: datapulse_help(topic="history")

Parameters

ParameterTypeDescription
domain
required
string
The domain name to query RDAP history for. A hostname is reduced to its registrable domain (www.example.com -> example.com).
Min length: 1Max length: 253
limitinteger
Observations per page. Default 50, max 90 (larger values are capped). An observation is about 650 bytes.
offsetinteger
Observations to skip, in the API’s order, from a previous response’s next_offset. Default 0.
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "domain": {
      "description": "The domain name to query RDAP history for. A hostname is reduced to its registrable domain (www.example.com -\u003e example.com).",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    },
    "limit": {
      "description": "Observations per page. Default 50, max 90 (larger values are capped). An observation is about 650 bytes.",
      "type": "integer"
    },
    "offset": {
      "description": "Observations to skip, in the API's order, from a previous response's next_offset. Default 0.",
      "type": "integer"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}

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