본문으로 건너뛰기

lookup_dns

도메인에서 한 가지 유형의 DNS 레코드를 조회합니다. namebeta.com의 DNS 도구와 같은 8가지 레코드 유형을 지원합니다.

읽기 전용 · 오픈 월드

AI 어시스턴트에게 물어보기​

NameBeta가 연결된 대화에 다음을 붙여 넣으세요.

github.com은 어떤 메일 서버를 쓰고 있어?

AI 어시스턴트는 유형을 MX로 지정해 lookup_dns를 호출합니다.

입력​

필드유형필수제약 조건
domainstring예1–253 문자; \.과 일치
typestring아니요A, AAAA, CNAME, MX, TXT, NS, SRV, SOA 중 하나; 기본값 A

출력​

structuredContent로 반환되며, text 콘텐츠 블록에서 JSON으로 반복됩니다.

필드유형필수제약 조건
domainstring예
typestring예A, AAAA, CNAME, MX, TXT, NS, SRV, SOA 중 하나
recordsobject[]예
records[].typestring예A, AAAA, CNAME, MX, TXT, NS, SRV, SOA 중 하나
records[].datastring예

동작​

  • domain에는 점이 있어야 합니다. example.com 같은 등록된 도메인이나 www.github.com처럼 그 아래의 호스트 이름을 쓸 수 있습니다.
  • type의 기본값은 A입니다. 요청한 유형의 레코드만 반환됩니다. 별칭인 호스트는 A 질의에 주소로 응답하며, 그 CNAME 레코드는 CNAME을 요청할 때만 나타납니다.
  • data는 레코드 값을 텍스트로 나타낸 것입니다. A와 AAAA는 주소, CNAME과 NS는 호스트 이름, MX는 10 mail.example.com처럼 우선순위 뒤에 호스트가 옵니다.
  • 해당 유형의 레코드가 없는 이름은 빈 records 배열을 반환하며, 오류가 아닙니다.
  • 이메일을 받지 않는 도메인은 null 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 dns20 / 50200 / 400500 / 1,000무제한

오류​

이 도구에만 해당하는 오류입니다. 나머지 오류와 각 오류가 클라이언트에 전달되는 방식은 오류에서 설명합니다.

상황결과
domain에 점이 없음도구 오류 MCP error -32602: Input validation error: … (A full domain name is required)
domain이 유효한 도메인이 아님도구 오류 Invalid domain format
type이 8가지 유형 중 하나가 아님도구 오류 MCP error -32602: Input validation error: …
해당 TLD의 네임서버를 알 수 없음도구 오류 Zone missing
조회가 실패하거나 시간 초과됨원인이 담긴 도구 오류

참고 항목​