`lookup_dns`

Consulta os registros DNS de um tipo para um domínio. Oferece suporte aos mesmos oito tipos de registro da ferramenta de DNS de namebeta.com.

Somente leitura · Mundo aberto

Pergunte ao seu assistente

Cole isto em um chat com o NameBeta conectado:

Quais servidores de e-mail o github.com usa?

O assistente chama lookup_dns com o tipo MX.

Campo	Tipo	Obrigatório	Restrições
`domain`	`string`	Sim	1–253 caracteres; Corresponde a `\.`
`type`	`string`	Não	Um de `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`, `SOA`; Padrão `A`

Retornado como structuredContent, e repetido como JSON em um bloco de conteúdo text.

Campo	Tipo	Obrigatório	Restrições
`domain`	`string`	Sim
`type`	`string`	Sim	Um de `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`, `SOA`
`records`	`object[]`	Sim
`records[].type`	`string`	Sim	Um de `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`, `SOA`
`records[].data`	`string`	Sim

domain precisa conter um ponto. Pode ser um domínio registrado, como example.com, ou um nome de host abaixo dele, como www.github.com.
type tem A como padrão. Só são retornados registros do tipo solicitado: um host que é um alias responde a uma consulta A com seus endereços, e o registro CNAME dele só aparece quando você pede CNAME.
data é o valor do registro em texto: um endereço para A e AAAA, um nome de host para CNAME e NS, e a preferência seguida do host para MX, como 10 mail.example.com.
Um nome sem registros do tipo pedido retorna um array records vazio; isso não é um erro.
Um domínio que não recebe e-mails pode publicar um null MX (RFC 7505), que é retornado como 0 .. example.com é um desses casos.

Argumentos:

{ "domain": "github.com", "type": "MX" }

Resultado de uma chamada em 29 de setembro de 2026:

{
    "domain": "github.com",
    "type": "MX",
    "records": [
        { "type": "MX", "data": "0 github-com.mail.protection.outlook.com" }
    ]
}

dig MX github.com retorna o mesmo registro: o GitHub recebe seus e-mails pelo Microsoft 365.

Ferramenta	Categoria	Gratuito (hora / dia)	Pro (hora / dia)	Business (hora / dia)	Enterprise (hora / dia)
`lookup_dns`	`dns`	20 / 50	200 / 400	500 / 1,000	Ilimitado

Erros específicos desta ferramenta. Erros cobre os demais, incluindo como cada tipo chega ao seu cliente.

Situação	Resultado
`domain` não tem ponto	Erro de ferramenta `MCP error -32602: Input validation error: …` (`A full domain name is required`)
`domain` não é um domínio válido	Erro de ferramenta `Invalid domain format`
`type` não é um dos oito tipos	Erro de ferramenta `MCP error -32602: Input validation error: …`
Os servidores de nomes do TLD são desconhecidos	Erro de ferramenta `Zone missing`
A consulta falha ou esgota o tempo	Erro de ferramenta com o motivo

lookup_whois: quem registrou o domínio e quando ele expira
Ferramentas: as cinco ferramentas e como elas se complementam
Cotas e Erros
Conectar um cliente, se o seu assistente ainda não lista as ferramentas do NameBeta