MCP documentation menu

datapulse_live_dns_bulk

OtherScope: datapulse:dnsRead-only

Submit up to 150 DNS lookups per request. Asynchronous: the answer is a receipt, not records.

Description

Submit up to 150 DNS lookups per request. Asynchronous: the answer is a receipt, not records.

Each item is {domain, record_type?, force?}. Each result is read back with datapulse_live_dns(dns_query_hash=<submitted[].dns_query_hash>), which reads the stored row; datapulse_live_dns(domain=…) does its own lookup and never reads it.

Receipt: accepted, cached, rejected (the API’s counts over the items sent; cached is always 0, since DNS has no application cache); submitted (every item sent: index, query, record_type, dns_query_hash, domain_hash, 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, and one bad item never fails the batch. 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="dns")

Parameters

ParameterTypeDescription
domains
required
object[]
Array of domains to look up. Maximum 150 per request.
Min items: 1Max items: 150
domains[].domain
required
string
The domain name to look up (e.g., ’example.com’).
Min length: 1Max length: 253
domains[].forceboolean
Fresh lookup; DNS has no application cache, so it is rarely needed.
domains[].record_typestring
DNS record type to query. If omitted, queries default types.
Max length: 6
AAAAACNAMEMXNSTXTSOAPTRSRVCAADNSKEYDSRRSIGNSECTLSANAPTRSSHFP
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "domains": {
      "description": "Array of domains to look up. Maximum 150 per request.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "domain": {
            "description": "The domain name to look up (e.g., 'example.com').",
            "maxLength": 253,
            "minLength": 1,
            "type": "string"
          },
          "force": {
            "description": "Fresh lookup; DNS has no application cache, so it is rarely needed.",
            "type": "boolean"
          },
          "record_type": {
            "description": "DNS record type to query. If omitted, queries default types.",
            "enum": [
              "A",
              "AAAA",
              "CNAME",
              "MX",
              "NS",
              "TXT",
              "SOA",
              "PTR",
              "SRV",
              "CAA",
              "DNSKEY",
              "DS",
              "RRSIG",
              "NSEC",
              "TLSA",
              "NAPTR",
              "SSHFP"
            ],
            "maxLength": 6,
            "type": "string"
          }
        },
        "required": [
          "domain"
        ],
        "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.