# Useful Work DNS Lookup (DNS-over-HTTPS)

> Useful Work DNS Lookup (DNS-over-HTTPS) is a paid API for AI agents from tools.usefulwork.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-20).

Resolves DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA) for a given domain via DNS-over-HTTPS

## Facts

- Endpoint: GET https://tools.usefulwork.app/tools/dns?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/useful-work-dns-lookup-dns-over-https-9d9cf90b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PiNLj-9AlbqVrSl_Dwnlt

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 useful-work-dns-lookup-dns-over-https-9d9cf90b
```

Example prompt: What are the MX records for gmail.com? I want to see which mail servers handle their email.

## When to prefer this

Use this endpoint when you need a quick, programmatic DNS record lookup for any standard record type without setting up your own DNS resolver. Ideal for agents verifying email configurations, checking domain propagation, auditing infrastructure, or validating domain ownership via TXT records. Prefer over raw DNS libraries when operating in an environment without direct UDP/TCP DNS access.

## Known failure modes

- Domain does not exist (NXDOMAIN) — returns empty or error response
- Invalid domain name format — likely returns an error
- Unsupported record type requested — schema restricts to A, AAAA, CNAME, MX, NS, TXT, CAA
- DNS resolution timeout — upstream resolver may fail to respond
- Payment failure or insufficient USDC balance — x402 payment rejected

## How this service works

Look up DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA) over DNS-over-HTTPS

## Output

Returns the DNS records of the requested type for the given domain, including record values and relevant metadata such as TTL, as returned by a DNS-over-HTTPS resolver.

## 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"
      },
      "type": {
       "enum": [
        "A",
        "AAAA",
        "CNAME",
        "MX",
        "NS",
        "TXT",
        "CAA"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "example.com",
  "type": "A",
  "status": 0,
  "answers": [
   {
    "ttl": 300,
    "data": "93.184.215.14",
    "name": "example.com"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/useful-work-dns-lookup-dns-over-https-9d9cf90b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.usefulwork.app](https://www.zero.xyz/host/tools.usefulwork.app/llms.txt)
