Skip to main content
Glama

숙소 검색

stay_search
Read-onlyIdempotent

조건에 맞는 국내 숙소를 찾는다.

**재고를 확인하지 못한 숙소를 결과에서 지우지 않는다.** availability가 unknown이면
빈방 여부를 모른다는 뜻이고, 만실이라는 뜻이 아니다. 사용자에게 그렇게 전달하라.

Input Schema

NameRequiredDescriptionDefault
limitNo반환 개수 (1~50)
guestsNo인원(1~30)
regionNo지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 대개 질의가 건 시도 안의 이름이지만, 토큰이 **한 시도에만 있는** 시군구를 이름으로 불렀는데 건 시도가 그 시도가 아니면 **다른 시도 이름**이 온다('경북 군위' → '대구광역시 군위군' — 군위는 대구로 편입됐다) — 그때는 meta.region.tokens[].other_sido_sigungu와 meta.unapplied_conditions가 '건 시도의 시군구가 아니다'를 공시한다. 같은 이름이 여러 시도에 있거나('서구') 앞 두 글자만 겹친 다른 시도 이름은 region_retry가 아니라 meta.region_retry_other_sido로 갈라 온다. 시도를 안 줬으면 region_retry는 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라. **숙소 이름 검색은 없다**(이름 대신 그 숙소의 주소를 넣어라) · 업종어('펜션'·'게스트하우스')는 region이 아니라 category로 건다
checkinNo체크인 YYYY-MM-DD. checkout과 **둘 다** 주고 재고 채널이 붙어 있을 때만 재고(availability)를 조회한다 — 한쪽만 줬거나 채널이 없으면 날짜로 거르지 않고 availability=unknown이며(미조회 사유는 각 행의 unavailable_reason), 날짜가 적용되지 않은 사실은 meta.unapplied_conditions에 실린다. 채널이 있어도 목록은 날짜로 거르지 않는다(재고 표시에만 쓴다) — 지난 날짜면 재고는 조회하지 않는다(목록은 그대로 나온다)
categoryNo숙소 종류. 라벨은 두 원천의 어휘에서 오고, 같은 숙소라도 원천마다 이름이 다르다. TourAPI 마케팅 라벨: 관광호텔·콘도미니엄·유스호스텔·펜션·모텔·민박·게스트하우스·홈스테이·서비스드레지던스·한옥 인허가 원장 법정 업종명: 관광호텔·여관업·숙박업(생활)·여인숙업·일반호텔·숙박업 기타·휴양콘도미니엄업·농어촌민박업·외국인관광 도시민박업·한옥체험업 두 어휘에 다 있는 라벨: 관광호텔 — 양쪽 원천을 함께 거른다. 그 밖의 라벨은 자기 원천의 숙소만 거르고, 다른 원천의 같은 종류 숙소는 빠진다(예: '펜션'으로 걸면 원장의 '농어촌민박업'이 빠진다). 전체를 보려면 다른 어휘의 대응 라벨로 한 번 더 걸어라.
checkoutNo체크아웃 YYYY-MM-DD
include_footnotesNotrue면 계산값(건수·요금)의 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다(기본은 행마다 한 줄 요지)

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / checkin / description
      Previous value: -"체크인 YYYY-MM-DD. 주면 재고 조회를 시도한다 — 지난 날짜면 재고는 조회하지 않는다(목록은 그대로 나온다)"New value: +"체크인 YYYY-MM-DD. checkout과 **둘 다** 주고 재고 채널이 붙어 있을 때만 재고(availability)를 조회한다 — 한쪽만 줬거나 채널이 없으면 날짜로 거르지 않고 availability=unknown이며(미조회 사유는 각 행의 unavailable_reason), 날짜가 적용되지 않은 사실은 meta.unapplied_conditions에 실린다. 채널이 있어도 목록은 날짜로 거르지 않는다(재고 표시에만 쓴다) — 지난 날짜면 재고는 조회하지 않는다(목록은 그대로 나온다)"
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라. **숙소 이름 검색은 없다**(이름 대신 그 숙소의 주소를 넣어라) · 업종어('펜션'·'게스트하우스')는 region이 아니라 category로 건다"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 대개 질의가 건 시도 안의 이름이지만, 토큰이 **한 시도에만 있는** 시군구를 이름으로 불렀는데 건 시도가 그 시도가 아니면 **다른 시도 이름**이 온다('경북 군위' → '대구광역시 군위군' — 군위는 대구로 편입됐다) — 그때는 meta.region.tokens[].other_sido_sigungu와 meta.unapplied_conditions가 '건 시도의 시군구가 아니다'를 공시한다. 같은 이름이 여러 시도에 있거나('서구') 앞 두 글자만 겹친 다른 시도 이름은 region_retry가 아니라 meta.region_retry_other_sido로 갈라 온다. 시도를 안 줬으면 region_retry는 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라. **숙소 이름 검색은 없다**(이름 대신 그 숙소의 주소를 넣어라) · 업종어('펜션'·'게스트하우스')는 region이 아니라 category로 건다"
  2. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라. **숙소 이름 검색은 없다**(이름 대신 그 숙소의 주소를 넣어라) · 업종어('펜션'·'게스트하우스')는 region이 아니라 category로 건다"
  3. Changed1 schema field changed
    • addedInput schema / properties / include_footnotes
      Added value: +{
      +  "default": false,
      +  "description": "true면 계산값(건수·요금)의 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다(기본은 행마다 한 줄 요지)",
      +  "title": "Include Footnotes",
      +  "type": "boolean"
      +}
  4. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 전국은 region을 비운다(빈 값 = 지역 조건 없음 — '전국'·'한국'은 지역 이름이 아니라 주소 글자로 걸린다). 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"
  5. Changed2 schema fields changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담고, 시도를 안 줬으면 토큰이 이름으로 부른 시군구만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"
    • addedInput schema / properties / region / maxLength
      Added value: +200
  6. Changed1 schema field changed
    • changedInput schema / properties / limit / description
      Previous value: -"반환 개수 (최대 50)"New value: +"반환 개수 (1~50)"
  7. Changed1 schema field changed
    • changedInput schema / properties / category / description
      Previous value: -"숙소 종류"New value: +"숙소 종류. 라벨은 두 원천의 어휘에서 오고, 같은 숙소라도 원천마다 이름이 다르다.\nTourAPI 마케팅 라벨: 관광호텔·콘도미니엄·유스호스텔·펜션·모텔·민박·게스트하우스·홈스테이·서비스드레지던스·한옥\n인허가 원장 법정 업종명: 관광호텔·여관업·숙박업(생활)·여인숙업·일반호텔·숙박업 기타·휴양콘도미니엄업·농어촌민박업·외국인관광 도시민박업·한옥체험업\n두 어휘에 다 있는 라벨: 관광호텔 — 양쪽 원천을 함께 거른다.\n그 밖의 라벨은 자기 원천의 숙소만 거르고, 다른 원천의 같은 종류 숙소는 빠진다(예: '펜션'으로 걸면 원장의 '농어촌민박업'이 빠진다). 전체를 보려면 다른 어휘의 대응 라벨로 한 번 더 걸어라."
  8. Changed2 schema fields changed
    • addedInput schema / properties / guests / maximum
      Added value: +30
    • addedInput schema / properties / guests / minimum
      Added value: +1
  9. Changed3 schema fields changed
    • changedInput schema / properties / guests / description
      Previous value: -"인원"New value: +"인원(1~30)"
    • removedInput schema / properties / guests / maximum
      Removed value: -30
    • removedInput schema / properties / guests / minimum
      Removed value: -1
  10. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 다시 걸 이름이 meta.region_retry로 온다(0건 = '없다'가 아니다). **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 복구 경로가 meta.unapplied_conditions로 **반드시** 오고, 다시 걸 이름을 댈 수 있을 때만 meta.region_retry가 함께 온다(0건 = '없다'가 아니다). region_retry는 질의가 건 시도 안의 이름만 담는다. **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"
  11. Changed2 schema fields changed
    • changedInput schema / properties / checkin / description
      Previous value: -"체크인 YYYY-MM-DD. 주면 재고 조회를 시도한다"New value: +"체크인 YYYY-MM-DD. 주면 재고 조회를 시도한다 — 지난 날짜면 재고는 조회하지 않는다(목록은 그대로 나온다)"
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 다시 걸 이름이 meta.region_retry로 온다(0건 = '없다'가 아니다)"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 다시 걸 이름이 meta.region_retry로 온다(0건 = '없다'가 아니다). **로마자는 시도만 받는다**('Seoul'·'Jeju-do'는 통하고 'Gangnam'은 안 통한다) — 시군구 이하는 한글로 써라"
  12. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 정식명·구명·약칭 다 받는다('제주도'='제주'='제주특별자치도'). 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다. 0건이면 다시 걸 이름이 meta.region_retry로 온다(0건 = '없다'가 아니다)"
  13. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역. '강원 속초', '서울 마포구'처럼 시도+시군구"New value: +"지역. '강원 속초', '서울 마포구'처럼 시도+시군구. 행정구역 어휘와 대조해 걸고, 어휘에 없는 말(읍·면·동·도로명)은 주소 부분문자열로 내려간다 — 어느 쪽이었는지는 meta.region_matched_on에 적힌다"
  14. First observed

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Although annotations already declare readOnly/idempotent/non-destructive/openWorld, the description adds a genuinely non-obvious behavioral rule: results with unknown availability must not be dropped, and unknown means 'vacancy undetermined', not 'fully booked', which must be conveyed to the user. That guards against a likely misinterpretation the annotations do not cover. It stops short of describing pagination, result ordering, or scale, so it is not a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short blocks: the purpose first, then the critical caveat in bold, which is a good front-loaded structure. The un-bolded sentence slightly restates the bolded one, a small redundancy that keeps the definition from a perfect score.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Annotations are rich, an output schema exists, and the schema documents all 7 parameters at full coverage, so the description need not explain return shapes. It covers purpose and the single most dangerous interpretation pitfall; only sibling routing and typical follow-up (detail/booking) are missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the region, category, and date parameters carry exhaustive in-schema documentation (including retry semantics and label vocabularies). The description body adds no parameter-level meaning of its own, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource: '조건에 맞는 국내 숙소를 찾는다' (find domestic accommodations matching conditions), with an explicit domestic and condition-filtered scope. It never names the sibling tools (stay_detail, stay_booking_link), so the agent must infer from their names that detail and booking are elsewhere; the purpose is clear but not differentiated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description contains no when-to-use or when-not-to-use guidance and no routing to stay_detail or stay_booking_link, even though they are natural follow-ups. The second paragraph guides post-result interpretation ('사용자에게 그렇게 전달하라') but that is output handling, not tool selection, so real selection guidance is absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources