MCP documentation menu

datapulse_live_dns

OtherScope: datapulse:dnsRead-only

Live DNS lookup of one name, synchronous, through a DNSSEC-validating resolver that drops answers in private, link-local and unique-local …

Description

Live DNS lookup of one name, synchronous, through a DNSSEC-validating resolver that drops answers in private, link-local and unique-local ranges (loopback is kept).

Without record_type the lookup covers A, AAAA, MX, NS, TXT, SOA, CNAME, CAA, DNSKEY and DS plus a _dmarc TXT lookup; with record_type, that one type for the exact name, plus the CNAME records of an alias. Hostname labels are kept (www.example.com and example.com are different questions); single labels and underscore names are accepted.

Returns a summary: status (ok, nxdomain, servfail, error with the worker’s text), dnssec_signed, records grouped by type (DNSSEC types only when requested), dmarc {status found/none/unknown, record}, query_time_ms, dns_query_hash and domain_hash. full=true returns the raw resolver output with flags, RRSIGs, authorities and additionals.

Give domain or dns_query_hash: the hash reads the row a datapulse_live_dns_bulk submission stored (submitted[].dns_query_hash) without a new lookup, and a hash with no row answers found: false. For many names: datapulse_live_dns_bulk (up to 150). For domain research, datapulse_domain_overview combines DNS, RDAP and a scrape.

Reference: datapulse_help(topic="dns")

Parameters

ParameterTypeDescription
dns_query_hashstring
A stored DNS row, read instead of a new lookup: the dns_query_hash from a datapulse_live_dns_bulk receipt (submitted[].dns_query_hash) or an earlier lookup. Give this or domain. The row keeps the record type it was looked up with, so record_type and force do not apply; full does.
Min length: 64Max length: 64Pattern: ^[a-fA-F0-9]{64}$
domainstring
The domain name to look up (e.g., ’example.com’). Give this or dns_query_hash.
Min length: 1Max length: 253
forceboolean
Fresh lookup (with domain only). Default false; DNS has no application cache, so this is rarely needed.
fullboolean
Return the raw resolver output (flags, RRSIGs, authorities, additionals) instead of the summary. Default false.
Default: false
record_typestring
One record type for the exact name; without it the default set plus _dmarc TXT is queried.
Max length: 6
AAAAACNAMEMXNSTXTSOAPTRSRVCAADNSKEYDSRRSIGNSECTLSANAPTRSSHFP
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "dns_query_hash": {
      "description": "A stored DNS row, read instead of a new lookup: the dns_query_hash from a datapulse_live_dns_bulk receipt (submitted[].dns_query_hash) or an earlier lookup. Give this or domain. The row keeps the record type it was looked up with, so record_type and force do not apply; full does.",
      "maxLength": 64,
      "minLength": 64,
      "pattern": "^[a-fA-F0-9]{64}$",
      "type": "string"
    },
    "domain": {
      "description": "The domain name to look up (e.g., 'example.com'). Give this or dns_query_hash.",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    },
    "force": {
      "description": "Fresh lookup (with domain only). Default false; DNS has no application cache, so this is rarely needed.",
      "type": "boolean"
    },
    "full": {
      "default": false,
      "description": "Return the raw resolver output (flags, RRSIGs, authorities, additionals) instead of the summary. Default false.",
      "type": "boolean"
    },
    "record_type": {
      "description": "One record type for the exact name; without it the default set plus _dmarc TXT is queried.",
      "enum": [
        "A",
        "AAAA",
        "CNAME",
        "MX",
        "NS",
        "TXT",
        "SOA",
        "PTR",
        "SRV",
        "CAA",
        "DNSKEY",
        "DS",
        "RRSIG",
        "NSEC",
        "TLSA",
        "NAPTR",
        "SSHFP"
      ],
      "maxLength": 6,
      "type": "string"
    }
  },
  "type": "object"
}

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