lookup_dns
Consulte les enregistrements DNS d’un type donné pour un domaine. L’outil prend en charge les mêmes huit types d’enregistrements que l’outil DNS de namebeta.com.
Lecture seule · Monde ouvert
Demander à votre assistant
Collez ceci dans une conversation où NameBeta est connecté :
Quels serveurs de messagerie github.com utilise-t-il ?
Votre assistant appelle lookup_dns avec le type MX.
Entrée
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
domain | string | Oui | 1–253 caractères; Correspond à \. |
type | string | Non | Un de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA; Valeur par défaut A |
Sortie
Retourné comme structuredContent, et répété en JSON dans un bloc de contenu text.
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
domain | string | Oui | |
type | string | Oui | Un de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records | object[] | Oui | |
records[].type | string | Oui | Un de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records[].data | string | Oui |
Fonctionnement
domaindoit contenir un point. Il peut s’agir d’un domaine enregistré commeexample.comou d’un nom d’hôte qui en dépend, commewww.github.com.typevautApar défaut. Seuls les enregistrements du type demandé sont renvoyés : un hôte qui est un alias répond à une requêteAavec ses adresses, et son enregistrementCNAMEn’apparaît que si vous demandezCNAME.dataest la valeur de l’enregistrement sous forme de texte : une adresse pourAetAAAA, un nom d’hôte pourCNAMEetNS, et la priorité suivie de l’hôte pourMX, par exemple10 mail.example.com.- Un nom qui n’a aucun enregistrement du type demandé renvoie un tableau
recordsvide ; ce n’est pas une erreur. - Un domaine qui n’accepte aucun e-mail peut publier un MX nul (RFC 7505), renvoyé sous la forme
0 .. C’est le cas deexample.com.
Exemple
Arguments :
{ "domain": "github.com", "type": "MX" }
Résultat d’un appel effectué le 29 septembre 2026 :
{
"domain": "github.com",
"type": "MX",
"records": [
{ "type": "MX", "data": "0 github-com.mail.protection.outlook.com" }
]
}
dig MX github.com renvoie le même enregistrement : GitHub reçoit ses e-mails via Microsoft 365.
Quota
| Outil | Catégorie | Gratuit (heure / jour) | Pro (heure / jour) | Business (heure / jour) | Entreprise (heure / jour) |
|---|---|---|---|---|---|
lookup_dns | dns | 20 / 50 | 200 / 400 | 500 / 1,000 | Illimité |
Erreurs
Erreurs propres à cet outil. La page Erreurs couvre les autres cas, y compris la manière dont chaque type d’erreur parvient à votre client.
| Situation | Résultat |
|---|---|
domain ne contient pas de point | Erreur d’outil MCP error -32602: Input validation error: … (A full domain name is required) |
domain n’est pas un domaine valide | Erreur d’outil Invalid domain format |
type ne fait pas partie des huit types | Erreur d’outil MCP error -32602: Input validation error: … |
| Les serveurs de noms du TLD sont inconnus | Erreur d’outil Zone missing |
| La consultation échoue ou dépasse le délai d’attente | Erreur d’outil indiquant la cause |
Voir aussi
lookup_whois: qui a enregistré le domaine et quand il expire- Outils : les cinq outils et leur articulation
- Quotas et Erreurs
- Connecter un client, si votre assistant n’affiche pas encore les outils de NameBeta