Domain DNS records
The full DNS record set of a domain in one call — A, AAAA, MX, NS, TXT, CNAME — with a read on what the records give away: which provider handles the mail, whether SPF and DMARC are set, and which services the domain has verified. Useful for checking whether a company is real and who hosts it.
POST https://api.bottrunk.com/s/domain-dns
Call it
# once, on the machine your agent runs on npx bottrunk-mcp wallet # prints the address; send it 0.3 ALGO, then USDC claude mcp add bottrunk -- npx -y bottrunk-mcp # then ask your agent for it — the tool is `bottrunk_domain_dns`
# Ask. You get a 402 with the payment requirements.
curl https://api.bottrunk.com/s/domain-dns \
-H "Content-Type: application/json" \
-d '{"domain":"stripe.com"}'
# Pay and retry. Any x402 client does this for you.
curl https://api.bottrunk.com/s/domain-dns \
-H "PAYMENT-SIGNATURE: <signed USDC transfer>" \
-H "Content-Type: application/json" \
-d '{"domain":"stripe.com"}'
from x402.clients import requests as x402_requests
session = x402_requests.x402_http_adapter(account) # your agent's Algorand account
r = session.post("https://api.bottrunk.com/s/domain-dns", json={"domain":"stripe.com"})
print(r.json())
print(r.headers["PAYMENT-RESPONSE"]) # settlement receipt
import { wrapFetchWithPayment } from "@x402-avm/fetch";
const r = await fetchWithPay("https://api.bottrunk.com/s/domain-dns", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({"domain":"stripe.com"}),
});
console.log(await r.json());
How it behaves
The decisions this service makes on your behalf, and the ones that end in a refusal. A 4xx is never settled, so a refusal costs you nothing.
| Size and time | Pages over 2 MB are refused with page too large. Connect times out at 5 s, the whole fetch at 20 s, and at most 3 redirects are followed. |
| Who we look like | Requests go out as BotTrunk/0.1 (+https://bottrunk.com/docs). Sites that block unknown agents will block this one. |
| Private addresses | Hostnames that resolve to private, loopback or link-local space are refused with 422 before any request is made. Do not point this at localhost or an intranet. |
| Method | POST only. A GET on the same path returns this page. |
Input
| domain | string | Hostname, with or without scheme. |
Output
| a | array | IPv4 addresses. |
| mx | array | Mail exchangers with preference, lowest first. |
| ns | array | Nameservers. |
| txt | array | TXT records, joined. |
| hints | object | email provider, spf, dmarc, verifications. |