lookup_dns
도메인에서 한 가지 유형의 DNS 레코드를 조회합니다. namebeta.com의 DNS 도구와 같은 8가지 레코드 유형을 지원합니다.
읽기 전용 · 오픈 월드
AI 어시스턴트에게 물어보기
NameBeta가 연결된 대화에 다음을 붙여 넣으세요.
github.com은 어떤 메일 서버를 쓰고 있어?
AI 어시스턴트는 유형을 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배열을 반환하며, 오류가 아닙니다. - 이메일을 받지 않는 도메인은 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 | 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이 8가지 유형 중 하나가 아님 | 도구 오류 MCP error -32602: Input validation error: … |
| 해당 TLD의 네임서버를 알 수 없음 | 도구 오류 Zone missing |
| 조회가 실패하거나 시간 초과됨 | 원인이 담긴 도구 오류 |
참고 항목
lookup_whois: 도메인을 누가 등록했고 언제 만료되는지- 도구: 다섯 가지 도구 전체와 함께 쓰는 방법
- 할당량 및 오류
- AI 어시스턴트에 아직 NameBeta 도구가 표시되지 않는다면 클라이언트 연결