datapulse_live_dns_bulk
datapulse:dnsRead-onlySubmit 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
| Parameter | Type | Description |
|---|---|---|
domainsrequired | object[] | Array of domains to look up. Maximum 150 per request. Min items: 1Max items: 150 |
domains[].domainrequired | string | The domain name to look up (e.g., ’example.com’). Min length: 1Max length: 253 |
domains[].force | boolean | Fresh lookup; DNS has no application cache, so it is rarely needed. |
domains[].record_type | string | DNS record type to query. If omitted, queries default types. Max length: 6AAAAACNAMEMXNSTXTSOAPTRSRVCAADNSKEYDSRRSIGNSECTLSANAPTRSSHFP |
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.