Look up DNS records
lookup_dns_recordsUse this when the user wants a dns lookup, an mx record check, or a txt record lookup for a domain. Reads live public DNS records through DNS-over-HTTPS and returns A, AAAA, MX, NS, TXT, CNAME, CAA, and SOA records with their TTLs, plus a CSV report. Do not use for internal DNS server visibility, reverse DNS of an IP address, or records outside the supported type list.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "lookup_dns_records"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Record types to return, a subset of A, AAAA, MX, NS, TXT, CNAME, CAA, SOA, e.g. ["MX", "TXT"]. Omit for A, AAAA, MX, NS, TXT, CNAME, CAA, and SOA. | |
| domain | Yes | The domain to look up, e.g. example.com or mail.example.com. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | ||
| types | Yes | ||
| counts | Yes | ||
| domain | Yes | ||
| limits | Yes | ||
| source | Yes | ||
| records | Yes | ||
| sources | Yes | ||
| findings | Yes | ||
| downloads | Yes | ||
| checked_at | Yes |