datapulse_live_dns
datapulse:dnsRead-onlyLive 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
| Parameter | Type | Description |
|---|---|---|
dns_query_hash | string | 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}$ |
domain | string | The domain name to look up (e.g., ’example.com’). Give this or dns_query_hash. Min length: 1Max length: 253 |
force | boolean | Fresh lookup (with domain only). Default false; DNS has no application cache, so this is rarely needed. |
full | boolean | Return the raw resolver output (flags, RRSIGs, authorities, additionals) instead of the summary. Default false. Default: false |
record_type | string | One record type for the exact name; without it the default set plus _dmarc TXT is queried. Max length: 6AAAAACNAMEMXNSTXTSOAPTRSRVCAADNSKEYDSRRSIGNSECTLSANAPTRSSHFP |
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.