MCP documentation menu

datapulse_live_rdap_bulk

OtherScope: datapulse:dnsRead-only

Submit up to 150 RDAP lookups per request, domains and IP addresses mixed. Asynchronous: the answer is a receipt, not registration data.

Description

Submit up to 150 RDAP lookups per request, domains and IP addresses mixed. Asynchronous: the answer is a receipt, not registration data.

Each item is {query, force?}, validated and reduced as datapulse_live_rdap does. Each result is read back with datapulse_live_rdap(domain_hash=<submitted[].domain_hash>). Bulk consults only the Scrape API’s 90-day cache, not the DataPulse database, so cached is usually nonzero. A TLD without RDAP (.de, .edu) passes validation and its job then fails with “No RDAP servers found”.

Receipt: accepted, cached, rejected (the API’s counts over the items sent); submitted (every item sent: index, query, domain_hash, which for an address is the hash of its text, plus job_id and cached when the API reports them); rejected_items (refused by the API); rejected_local (refused before the request, malformed items included; NOT counted in rejected); duplicates (index, first_index; sent once); errors (the API’s codes only). accepted + cached + rejected + len(rejected_local) + len(duplicates) equals the number of items. When no item can be sent, nothing is sent and the call is an error whose text is this receipt: every item in rejected_local, the counts 0, the other lists [], and a note.

Reference: datapulse_help(topic="rdap")

Parameters

ParameterTypeDescription
domains
required
object[]
Array of queries to look up. Each item can be a domain name or IP address (v4/v6). Maximum 150 per request.
Min items: 1Max items: 150
domains[].query
required
string
Domain name or IP address (v4/v6) to look up (e.g., ’example.com’, ‘8.8.8.8’, ‘2606:4700:4700::1111’).
Min length: 1Max length: 253
domains[].forceboolean
Bypass 90-day cache.
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "domains": {
      "description": "Array of queries to look up. Each item can be a domain name or IP address (v4/v6). Maximum 150 per request.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "force": {
            "description": "Bypass 90-day cache.",
            "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').",
            "maxLength": 253,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "maxItems": 150,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "domains"
  ],
  "type": "object"
}

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