Name: dns-lookup
Price: 0.02 USDC
Availability: InStock

$ man dns-lookup

agentutility / web-probe / dns-lookup

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

utilities

STATUS

● live

NAME

dns-lookup — full dns lookup over cloudflare 1.1.1.1 dns-over-https

SYNOPSIS

POST https://x402.agentutility.ai/dns-lookup
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Full DNS lookup over Cloudflare 1.1.1.1 DNS-over-HTTPS. Queries any subset of A, AAAA, MX, TXT, NS, CNAME, SOA, PTR, SRV, CAA, DNSKEY, DS, TLSA, HTTPS, and SVCB records and returns results grouped per type with TTLs plus a flat list. Works as a dig/nslookup replacement, MX checker, SPF + DMARC TXT inspector, CAA/DNSSEC inspector, nameserver finder, or CDN-routing detector.

INPUT — request schema

property	type	description	req?
domain	string	Domain or hostname to resolve (e.g. 'example.com', 'mail.example.com'). Sent as-is, not stripped to apex.	required
types	array	Optional record types to query. Default: ['A', 'AAAA', 'MX', 'TXT', 'NS']. Any of A, AAAA, MX, TXT, NS, CNAME, SOA, PTR, SRV, CAA, DNSKEY, DS, TLSA, HTTPS, SVCB.	optional

OUTPUT — response shape

field	type	description
domain	string	Domain name that was queried (echoed from the request input).
types_queried	array	List of DNS record types resolved in this call (e.g. A, AAAA, MX, TXT, NS, CNAME).
records	object	Map keyed by record type, each value an array of resolved DNS records returned by Cloudflare DoH.
flat	object	Convenience flat fields: a[], aaaa[], mx[], ns[], txt[], cname[], caa[].
total_records	number	Total count of DNS records returned across all queried types.
source	string	Upstream resolver identifier, typically cloudflare-dns.com (DNS-over-HTTPS).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/dns-lookup \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the dns-lookup tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: dnsdohresolvermxtxtspf
methods: POST
cluster: webprobe
price: $0.02 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
archive-snapshot	Finds the closest archived snapshot of a public URL, like a Wayback Machine API.	$0.02
archive-snapshot-api	Finds archived snapshots of public web pages, returning the closest Wayback Machine captures with timestamps, status codes, and replay URLs.	$0.02
archive-url	Looks up the archived copy of a public URL closest to a given timestamp and can fetch cleaned archived page text.	$0.02
brand-domain-check	Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who…	$0.02
brand-watch-domain-risk	Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses.	$0.02
creator-domain-check	Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags.	$0.02
dmarc-check	Audits a domain's email authentication posture: DMARC, SPF, and DKIM in one check.	$0.02
domain-age-check	Checks a domain's age and registration date, with registrar metadata, for fraud, phishing, brand-protection, and lead-enrichment workflows.	$0.02