{"uid":"cap_yjD8LJLn9MwRamKGl0PEe","slug":"agentshelf-carddav-srv-dns-lookup-981e0c25","name":"AgentShelf CardDAV SRV DNS Lookup","description":"Call when an agent needs SRV records at _carddav._tcp.{hostname} for CardDAV. The caller sends the registrable domain, not the underscored name. Exact $0.003 USDC. Prefer unpaid POST /v1/sandbox/dns-srv-carddav first.","url":"https://agentshelf.syntexa.ch/v1/dns-srv-carddav?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.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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r7OtckS9QmuZ4M81l0RCH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up DNS SRV records at _carddav._tcp.{hostname} for a given registrable domain to discover CardDAV server endpoints.","exampleAgentPrompt":"Can you look up the CardDAV SRV DNS records for apple.com so I can find out where their contacts sync server is?","exampleUseCases":[{"title":"CardDAV server discovery for contacts app","prompt":"I'm setting up a contacts sync client and need to auto-discover the CardDAV server for the domain fastmail.com — can you fetch the SRV records for me?"},{"title":"Verifying CardDAV configuration for a domain","prompt":"Check whether the domain company.example has CardDAV SRV records configured in DNS so I can confirm their contact server is properly set up."},{"title":"Building a multi-domain address book integration","prompt":"I need to find the CardDAV service endpoints for each of these domains: icloud.com, google.com, and proton.me — start by resolving the SRV records for icloud.com."}],"resultDescription":"Returns the DNS SRV record(s) found at _carddav._tcp.{hostname}, including fields such as priority, weight, port, and target hostname of the CardDAV server. If no records exist, returns an empty or null result indicating CardDAV is not configured for the domain.","failureModes":["Domain has no _carddav._tcp SRV record — returns empty result","Invalid or malformed hostname input — validation error","DNS resolution timeout or upstream DNS failure — service error","Domain does not exist in DNS — NXDOMAIN response","Payment failure for x402 micropayment — request rejected before processing"],"whenToPreferThis":"Use this endpoint when an agent needs to auto-discover a CardDAV contacts synchronization server for a given domain via the standard _carddav._tcp DNS SRV lookup mechanism. Prefer this over manual configuration or generic DNS tools when you specifically need CardDAV service location. Use the free sandbox POST /v1/sandbox/dns-srv-carddav first when available to avoid the $0.003 USDC charge.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:57:48.266Z","isFirstParty":false,"canonicalSlug":"agentshelf-carddav-srv-dns-lookup-981e0c25"}