{"uid":"cap_xZSrRmxwUgRqe7fwrZMFz","slug":"agentreader-dns-lookup-d2defa8b","name":"AgentReader DNS Lookup","description":"DNS lookup over Cloudflare DoH: query A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA or PTR records for any domain and get structured JSON answers with TTLs. Useful for domain research, email validation and infrastructure checks.","url":"https://agent-reader.agent-reader.workers.dev/dns","method":"GET","headers":{},"bodySchema":{"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 to resolve"},"type":{"type":"string","description":"Record type (A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, PTR). Default A"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cXnfwircind6F-UiFVtV8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves DNS records (A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, PTR) for any domain via Cloudflare DoH, returning structured JSON with TTLs","exampleAgentPrompt":"Can you look up the MX records for gmail.com so I can see which mail servers handle their email?","exampleUseCases":[{"title":"Email domain validation check","prompt":"Look up the MX and TXT records for acme-corp.com so I can confirm their email is properly set up with SPF and valid mail servers."},{"title":"Subdomain CNAME investigation","prompt":"Check what the CNAME record is for shop.nike.com — I want to know what service or provider it's pointing to."},{"title":"Infrastructure nameserver audit","prompt":"Fetch the NS and SOA records for example.org so I can verify which nameservers are authoritative for that domain."}],"resultDescription":"A structured JSON object containing an array of DNS answer records, each with the record type, TTL, name, and data (e.g. IP address for A records, hostname for MX/CNAME, string for TXT), plus status codes indicating whether the query succeeded.","failureModes":["Domain does not exist (NXDOMAIN) — returns empty answers array or NXDOMAIN status","Invalid or unsupported record type requested — may return empty results or error","Network timeout reaching Cloudflare DoH upstream — connection error","Malformed domain name input — query may fail or return no results","SERVFAIL from upstream resolver if the domain's DNS is broken"],"whenToPreferThis":"Choose this endpoint when you need fast, structured DNS resolution with TTL data for any standard record type, especially for email validation (MX/TXT/SPF), infrastructure audits (NS/SOA), security checks (CAA), or reverse lookups (PTR). It is ideal for agents needing machine-readable JSON DNS answers without managing a DNS library or resolver directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:09.313Z","isFirstParty":false}