network_dns
Resolve DNS records (A, AAAA, MX, NS, TXT, CNAME, PTR, SOA) for any domain or IP. Queries a public resolver to retrieve and display record details.
Instructions
DNS Lookup (NSLookup / Dig). Run a live DNS record lookup for a domain or IP, resolving A, AAAA, MX, NS, TXT, CNAME, PTR, or SOA records by sending an outbound query to a public resolver (default 8.8.8.8). Use this for forward and record-type lookups on a hostname; use network_reverse_dns to turn an IP into a hostname via PTR, or network_dns_propagation to compare a record across many global resolvers. NOT read-only and NOT idempotent: it reaches the public DNS system and results vary by resolver, caching, and TTL. Rate-limited (20 requests/minute for anonymous callers). Returns an array of records with name, type, ttl, value, and per-type details (MX priority, SOA serial/refresh/retry/expire).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | Domain name or IP address to resolve (for example example.com or 8.8.8.8). Validated as a hostname or IP; must not be blank. | |
| recordType | No | DNS record type to query. Defaults to A (IPv4). PTR reverses an IPv4 host into in-addr.arpa form automatically. | A |
| dnsServer | No | Resolver IP used for the lookup. Defaults to Google Public DNS (8.8.8.8). Honored when a remote worker performs the query. | 8.8.8.8 |
| worker_id | No | Optional registered healthy worker peer ID. Omit to use the default master-server behavior. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether the lookup completed. | |
| host | No | The queried domain or IP, echoed back. | |
| recordType | No | The record type that was queried. | |
| dnsServer | No | The resolver IP used for the query. | |
| records | No | Matched DNS records (empty when none exist or the query failed). | |
| authority | No | Authority-section records, or null when not provided. | |
| additional | No | Additional-section records, or null when not provided. | |
| timestamp | No | ISO 8601 time the response was generated. |