# x402-tools DNS Lookup

> x402-tools DNS Lookup is a paid API for AI agents from x402.nichospt.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Performs DNS record lookups for a given domain, returning records of a specified type (A, AAAA, MX, TXT, NS, CNAME, SOA), paid per-call in USDC via x402.

## Facts

- Endpoint: POST https://x402.nichospt.net/dns-lookup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-tools-dns-lookup-a25f93fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_989wbhgAXOZ8_7EfkPZW9

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 x402-tools-dns-lookup-a25f93fb -d '<json body>'
```

Example prompt: What are the MX records for github.com?

## When to prefer this

Use this endpoint when an AI agent needs to programmatically resolve DNS records for a domain as part of an automated workflow — especially when standard system DNS tools are unavailable or when the agent needs structured JSON output with support for multiple record types (A, AAAA, MX, TXT, NS, CNAME, SOA). The pay-per-call x402 model makes it suitable for low-volume, on-demand lookups without subscription overhead.

## Known failure modes

- Domain does not exist — found: false with empty records array
- Invalid record type enum value — validation error
- Malformed domain string — error response
- DNS timeout or upstream resolver failure — server error
- Payment failure via x402 — 402 response before DNS query is executed

## How this service works

Pay-per-call utility APIs for AI agents, settled in USDC via the x402 protocol.

## Output

A JSON object containing the queried domain, the record type requested, a boolean indicating whether records were found, and an array of the matching DNS record values (e.g. IP addresses, hostnames, or text strings depending on type).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "A",
    "AAAA",
    "MX",
    "TXT",
    "NS",
    "CNAME",
    "SOA"
   ],
   "type": "string",
   "default": "A"
  },
  "domain": {
   "type": "string",
   "description": "Domain name to query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "A",
  "found": true,
  "domain": "example.com",
  "records": [
   "93.184.215.14"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-tools-dns-lookup-a25f93fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.nichospt.net](https://www.zero.xyz/host/x402.nichospt.net/llms.txt)
