# AgentReader DNS Lookup

> AgentReader DNS Lookup is a paid API for AI agents from agentreader.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Performs DNS lookups via Cloudflare DoH for any domain, returning structured JSON answers with TTLs for record types A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, and PTR.

## Facts

- Endpoint: GET https://agentreader.dev/dns?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentreader-dns-lookup-6aafad53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GZerj_W3fqvTJNpkFid1N

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentreader-dns-lookup-6aafad53
```

Example prompt: Look up the MX records for example.com so I can check where its email is being routed.

## When to prefer this

Choose this endpoint when you need reliable, structured DNS resolution backed by Cloudflare's global DoH infrastructure. It is ideal for agents that need to validate email infrastructure (MX/TXT/SPF), audit domain configuration, verify CNAME chains, or perform reverse PTR lookups — all returning clean JSON with TTLs rather than raw dig-style output. Prefer it over generic DNS libraries when operating in a serverless or sandboxed agent environment that cannot make raw UDP DNS queries.

## Known failure modes

- Domain does not exist (NXDOMAIN) — returns empty answer array or error status
- Invalid record type string — returns error or no results
- Timeout from Cloudflare DoH upstream — returns service error
- Malformed domain name input — returns validation error
- SERVFAIL from authoritative nameserver — propagated as DNS error

## How this service works

DNS lookup over Cloudflare DoH: query A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA or PTR records for any domain and get structured JSON answers with TTLs. Useful for domain research, email validation and infrastructure checks.

## Output

A structured JSON object containing the DNS answer section with one or more records matching the queried type, each including the record name, type, TTL, and data value (e.g. IP address, hostname, priority+exchange for MX, text string for TXT). Also includes the question section echoing the queried name and type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Domain name to resolve"
      },
      "type": {
       "type": "string",
       "description": "Record type (A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, PTR). Default A"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentreader-dns-lookup-6aafad53/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreader.dev](https://www.zero.xyz/host/agentreader.dev/llms.txt)
