# Mat Web & Data Toolkit – DNS Lookup

> Mat Web & Data Toolkit – DNS Lookup is a paid API for AI agents from automatom.matt-d59.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Performs a DNS lookup for a given hostname and returns A, AAAA, MX, NS, TXT, and CNAME records as structured JSON.

## Facts

- Endpoint: GET https://automatom.matt-d59.workers.dev/dns?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mat-web-data-toolkit-dns-lookup-c59d074f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XalS6oNNJVZ2ZGegc9eV5

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 mat-web-data-toolkit-dns-lookup-c59d074f
```

Example prompt: Can you look up the DNS records for example.com — I want to see the A, MX, NS, and TXT records?

## When to prefer this

Choose this endpoint when you need structured, multi-record-type DNS data for a single hostname in one call, especially when you require A, AAAA, MX, NS, TXT, and CNAME records together. It is well-suited for lightweight automation tasks (email validation, infrastructure audits, domain verification) where a full DNS library is overkill and a simple pay-per-call JSON API is preferable.

## Known failure modes

- Invalid or non-existent hostname returns empty arrays or an error object
- Missing required 'host' query parameter results in a 400-level error
- Private/internal hostnames that don't resolve publicly return empty record sets
- Rate limiting or payment failure (x402) returns a 402 Payment Required response
- Transient DNS resolution timeouts may return incomplete or empty results

## How this service works

Fetches a public web page and returns its title, meta description, outbound links and readable plain text as JSON.

## Output

Returns a JSON object keyed by record type (A, AAAA, MX, NS, TXT, CNAME) plus the queried host. A records are arrays of IPv4 strings, AAAA arrays of IPv6 strings, MX arrays of objects with exchange and priority fields, NS arrays of nameserver strings, TXT arrays of string arrays, and CNAME an array of canonical names.

## 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": [
      "host"
     ],
     "properties": {
      "host": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "A": [
   "104.20.23.154",
   "172.66.147.243"
  ],
  "MX": [
   {
    "exchange": "",
    "priority": 0
   }
  ],
  "NS": [
   "hera.ns.cloudflare.com",
   "elliott.ns.cloudflare.com"
  ],
  "TXT": [
   [
    "v=spf1 -all"
   ],
   [
    "_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"
   ]
  ],
  "AAAA": [
   "2606:4700:10::ac42:93f3",
   "2606:4700:10::6814:179a"
  ],
  "host": "example.com",
  "CNAME": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mat-web-data-toolkit-dns-lookup-c59d074f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from automatom.matt-d59.workers.dev](https://www.zero.xyz/host/automatom.matt-d59.workers.dev/llms.txt)