lookup_dns
Consulta los registros DNS de un tipo concreto para un dominio. Admite los mismos ocho tipos de registro que la herramienta DNS de namebeta.com.
Solo lectura · Mundo abierto
Pregúntale a tu asistente
Pega esto en una conversación con NameBeta conectado:
¿Qué servidores de correo usa github.com?
Tu asistente llama a lookup_dns con el tipo MX.
Entrada
| Campo | Tipo | Requerido | Restricciones |
|---|---|---|---|
domain | string | Sí | 1–253 caracteres; Coincide con \. |
type | string | No | Uno de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA; Predeterminado A |
Salida
Devuelto como structuredContent, y repetido como JSON en un bloque de contenido text.
| Campo | Tipo | Requerido | Restricciones |
|---|---|---|---|
domain | string | Sí | |
type | string | Sí | Uno de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records | object[] | Sí | |
records[].type | string | Sí | Uno de A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records[].data | string | Sí |
Comportamiento
domaindebe contener un punto. Puede ser un dominio registrado comoexample.como un nombre de host dentro de él, comowww.github.com.typeesApor defecto. Solo se devuelven los registros del tipo solicitado: un host que es un alias responde a una consultaAcon sus direcciones, y su registroCNAMEsolo aparece si pidesCNAME.dataes el valor del registro en forma de texto: una dirección paraAyAAAA, un nombre de host paraCNAMEyNS, y la preferencia seguida del host paraMX, como10 mail.example.com.- Si un nombre no tiene registros de ese tipo, se devuelve un array
recordsvacío; no es un error. - Un dominio que no acepta correo puede publicar un MX nulo (RFC 7505), que se devuelve como
0 ..example.comes uno de ellos.
Ejemplo
Argumentos:
{ "domain": "github.com", "type": "MX" }
Resultado de una llamada realizada el 29 de septiembre de 2026:
{
"domain": "github.com",
"type": "MX",
"records": [
{ "type": "MX", "data": "0 github-com.mail.protection.outlook.com" }
]
}
dig MX github.com devuelve el mismo registro: GitHub recibe su correo a través de Microsoft 365.
Cuota
| Herramienta | Categoría | Gratis (hora / día) | Pro (hora / día) | Negocios (hora / día) | Empresarial (hora / día) |
|---|---|---|---|---|---|
lookup_dns | dns | 20 / 50 | 200 / 400 | 500 / 1,000 | Ilimitado |
Errores
Errores propios de esta herramienta. Errores cubre el resto, incluido cómo llega cada tipo a tu cliente.
| Situación | Resultado |
|---|---|
domain no contiene ningún punto | Error de herramienta MCP error -32602: Input validation error: … (A full domain name is required) |
domain no es un dominio válido | Error de herramienta Invalid domain format |
type no es ninguno de los ocho | Error de herramienta MCP error -32602: Input validation error: … |
| No se conocen los servidores de nombres del TLD | Error de herramienta Zone missing |
| La consulta falla o se agota el tiempo de espera | Error de herramienta con el motivo |
Véase también
lookup_whois: quién registró el dominio y cuándo vence- Herramientas: las cinco herramientas y cómo se combinan
- Cuotas y Errores
- Conectar un cliente, si tu asistente aún no muestra las herramientas de NameBeta