{"uid":"cap_fjHEBpSXNcAXUYg8MrX17","slug":"agentshelf-dns-srv-mqtt-lookup-bfd30255","name":"AgentShelf DNS SRV MQTT Lookup","description":"Call when an agent needs SRV records at _mqtt._tcp.{hostname} for MQTT. The caller sends the registrable domain, not the underscored name. Exact $0.009 USDC. Prefer unpaid POST /v1/sandbox/dns-srv-mqtt first.","url":"https://agentshelf.syntexa.ch/v1/dns-srv-mqtt?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.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8asnB3pWyzViJGppmH5Al","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves SRV records at _mqtt._tcp.{hostname} for a given registrable domain, returning MQTT broker connection details.","exampleAgentPrompt":"What MQTT broker does example.com use? Look up the SRV record at _mqtt._tcp.example.com and give me the host and port.","exampleUseCases":[{"title":"IoT device MQTT broker discovery","prompt":"My IoT sensors need to connect to the right MQTT broker for acmecorp.com — can you look up the _mqtt._tcp SRV record so I know which host and port to configure them with?"},{"title":"MQTT client auto-configuration","prompt":"Before my agent connects to the MQTT service for iotplatform.io, find the SRV record at _mqtt._tcp.iotplatform.io so it knows the correct broker address and port."},{"title":"MQTT infrastructure verification","prompt":"Can you check whether smarthome.example.net has a valid _mqtt._tcp SRV DNS record and tell me what broker hostname and port it points to?"}],"resultDescription":"Returns the SRV record data for _mqtt._tcp.{hostname}, typically including the target broker hostname, port number, priority, and weight values that allow an MQTT client to connect to the correct broker.","failureModes":["No SRV record found for the given domain (NXDOMAIN or empty answer)","Invalid or malformed hostname input","Domain exists but has no _mqtt._tcp SRV record configured","DNS resolution timeout","Payment failure or insufficient USDC balance"],"whenToPreferThis":"Use this endpoint when an agent needs to programmatically discover the MQTT broker for a domain via standard DNS SRV records, particularly in IoT, home automation, or messaging pipeline contexts where broker endpoints are published via DNS rather than hardcoded. Prefer the free sandbox endpoint POST /v1/sandbox/dns-srv-mqtt first for testing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:49:58.048Z","isFirstParty":false,"canonicalSlug":"agentshelf-dns-srv-mqtt-lookup-bfd30255"}