lookup_dns
查询域名某一类型的 DNS 记录。支持的八种记录类型与 namebeta.com 上的 DNS 查询工具相同。
只读 · 开放世界
向助手提问
在已连接 NameBeta 的对话中粘贴:
github.com 用的是哪些邮件服务器?
助手会以类型 MX 调用 lookup_dns。
输入
| 字段 | 类型 | 必需 | 约束 |
|---|---|---|---|
domain | string | 是 | 1–253 字符; 匹配 \. |
type | string | 否 | 其中之一 A, AAAA, CNAME, MX, TXT, NS, SRV, SOA; 默认 A |
输出
以structuredContent形式返回,并在text内容块中重复为JSON。
| 字段 | 类型 | 必需 | 约束 |
|---|---|---|---|
domain | string | 是 | |
type | string | 是 | 其中之一 A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records | object[] | 是 | |
records[].type | string | 是 | 其中之一 A, AAAA, CNAME, MX, TXT, NS, SRV, SOA |
records[].data | string | 是 |
行为
domain必须包含点号。它可以是example.com这样的已注册域名,也可以是其下的主机名,例如www.github.com。type默认为A。只返回所请求类型的记录:对于作为别名的主机,A查询返回的是它最终解析到的地址,只有查询CNAME时才会返回它的CNAME记录。data是记录值的文本形式:A和AAAA为地址,CNAME和NS为主机名,MX为优先级加主机名,例如10 mail.example.com。- 如果该名称没有此类型的记录,返回空的
records数组;这不算错误。 - 不接收邮件的域名可能会发布空 MX 记录(RFC 7505),返回值为
0 .。example.com就是这样。
示例
参数:
{ "domain": "github.com", "type": "MX" }
2026 年 9 月 29 日调用的结果:
{
"domain": "github.com",
"type": "MX",
"records": [
{ "type": "MX", "data": "0 github-com.mail.protection.outlook.com" }
]
}
dig MX github.com 返回的记录相同:GitHub 通过 Microsoft 365 收取邮件。
配额
| 工具 | 桶 | 免费 (小时 / 天) | 专业版 (小时 / 天) | 商业版 (小时 / 天) | 企业版 (小时 / 天) |
|---|---|---|---|---|---|
lookup_dns | dns | 20 / 50 | 200 / 400 | 500 / 1,000 | 无限制 |
错误
本工具特有的错误。其他错误以及各类错误如何返回给客户端,见错误。
| 情况 | 结果 |
|---|---|
domain 中没有点号 | 工具错误 MCP error -32602: Input validation error: …(A full domain name is required) |
domain 不是有效的域名 | 工具错误 Invalid domain format |
type 不是这八种之一 | 工具错误 MCP error -32602: Input validation error: … |
| 该 TLD 的域名服务器未知 | 工具错误 Zone missing |
| 查询失败或超时 | 工具错误,附带原因 |
另请参阅
lookup_whois:域名由谁注册、何时到期- 工具:全部五个工具及其配合方式
- 配额和错误
- 连接客户端:如果你的助手还没有列出 NameBeta 的工具