{"uid":"cap_OMRSCZkfwjt6Zqv-5NtMr","slug":"agentshelf-dns-a-record-lookup-7020f767","name":"AgentShelf DNS A Record Lookup","description":"Call when an agent needs IPv4 addresses only. Empty is an error, unlike the bundled dns-lookup SKU. Exact $0.006 USDC. Prefer unpaid POST /v1/sandbox/dns-a first.","url":"https://agentshelf.syntexa.ch/v1/dns-a?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hostname":{"type":"string","examples":["example.com"],"maxLength":253,"minLength":1,"description":"Public DNS hostname such as example.com. Not a URL, not an IP literal, and not a private name."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wd7xum9bPDSKo3jjCSwIU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a hostname to its IPv4 addresses only, returning an error if no A records are found.","exampleAgentPrompt":"What IPv4 addresses does api.example.com resolve to? I need only the A records — if there are none, treat it as an error.","exampleUseCases":[{"title":"Verify server IP before deployment","prompt":"Before I deploy, can you resolve staging.myapp.io to its IPv4 address so I can confirm the DNS is pointing at the right server?"},{"title":"Security audit of suspicious domain","prompt":"I need to know what IPv4 addresses malicious-looking-domain.xyz resolves to — look up its A records for me."},{"title":"Check CDN IP assignment","prompt":"Can you fetch the IPv4 address that cdn.mycompany.com currently resolves to? I want to confirm it's hitting our CDN and not an old origin server."}],"resultDescription":"Returns the resolved IPv4 addresses (A records) for the given hostname. If the hostname has no A records, an error is returned rather than an empty result — this distinguishes it from a bundled DNS lookup that tolerates empty responses.","failureModes":["Hostname has no A records — returns an error (empty result is not allowed)","Invalid or malformed hostname — validation error","Hostname does not exist (NXDOMAIN) — error response","Private or internal hostnames may not resolve publicly","Network timeout from DNS resolver — error response"],"whenToPreferThis":"Choose this endpoint when you specifically need IPv4 (A record) DNS resolution and require that an empty result be treated as a hard error. Prefer the free POST /v1/sandbox/dns-a first for testing. Use this over a bundled DNS-lookup SKU when you want strict IPv4-only results without silent empty responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:47:44.834Z","isFirstParty":false,"canonicalSlug":"agentshelf-dns-a-record-lookup-7020f767"}