# AgentReader DNS Lookup

> AgentReader DNS Lookup is a paid API for AI agents from agent-reader.agent-reader.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Resolves DNS records (A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, PTR) for any domain via Cloudflare DoH, returning structured JSON with TTLs

## Facts

- Endpoint: GET https://agent-reader.agent-reader.workers.dev/dns
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentreader-dns-lookup-d2defa8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xZSrRmxwUgRqe7fwrZMFz

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-d2defa8b
```

Example prompt: Can you look up the MX records for gmail.com so I can see which mail servers handle their email?

## When to prefer this

Choose this endpoint when you need fast, structured DNS resolution with TTL data for any standard record type, especially for email validation (MX/TXT/SPF), infrastructure audits (NS/SOA), security checks (CAA), or reverse lookups (PTR). It is ideal for agents needing machine-readable JSON DNS answers without managing a DNS library or resolver directly.

## Known failure modes

- Domain does not exist (NXDOMAIN) — returns empty answers array or NXDOMAIN status
- Invalid or unsupported record type requested — may return empty results or error
- Network timeout reaching Cloudflare DoH upstream — connection error
- Malformed domain name input — query may fail or return no results
- SERVFAIL from upstream resolver if the domain's DNS is broken

## 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 an array of DNS answer records, each with the record type, TTL, name, and data (e.g. IP address for A records, hostname for MX/CNAME, string for TXT), plus status codes indicating whether the query succeeded.

## 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-d2defa8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-reader.agent-reader.workers.dev](https://www.zero.xyz/host/agent-reader.agent-reader.workers.dev/llms.txt)