Skip to main content
Glama

지역 실거래 시세 통계

realty_region_price_stats
Read-onlyIdempotent

지역의 아파트 실거래 시세 추이(월별)를 조회한다. 경매가가 싼지 판단하는 기준선이 된다.

**이 축의 자리(시세 도구 3종 중)**: 월별 흐름·방향이 필요할 때 이걸 쓴다. 지역의
가격 **수준**을 인용할 거면 realty_area_price_bands를 쓰라 — 평형(pyeong)을 지정하면
이 축은 셀 평균이라 직거래 이상치가 안 걸러지고(전체 평형은 해제·직거래 이상치 제외 —
행 avg_basis), **평형 지정 값이 bands와 갈리면 bands 쪽이 정상 매매에 가깝다**(세종
소형 실측 4,400만원 차). 단지가 특정된 질문("○○아파트
얼마야")은 realty_search_complexes가 기본이다 — 지역 평균은 단지 간 편차(같은 동
같은 평형에서 단지 평균 24% 차)를 뭉갠다.

region은 시군구명(예: '강남구') 또는 **법정동까지**(예: '강남구 대치동',
'세종특별자치시 나성동') — 세종처럼 시군구가 하나인 도시는 동 단위로 좁혀야 신도심·
구도심이 섞이지 않는다(2026-08-08, 8/7 테스터 제안 수용). 동명 지역이 여럿이면
시도를 앞에 붙여라 — 안 붙이면 **고르지 않고 거절**하며(region_ambiguous) 토큰이
정확히 같은 후보를 준다(그 목록을 사용자에게 되묻고, 고른 이름을 그대로 다시 넣어라).
지역은 토큰 정확일치로만 맞춘다 — '동구'는 '남동구', '서구'는 '달서구'가 아니다.
metric: price(매매) | rental(전월세). rental도 **months 창 월별 추이**(monthly_trend:
전세 평균·중앙, 월세 보증금·월세, 건수 분리)를 준다 — "전세 떨어지는 중이야?",
역전세 판단용(입주 물량은 realty_move_in_supply와 조합). 상단 필드는 최신월 스냅샷.
**rental엔 평형 인자가 안 먹는다** — 전월세 통계는 평형별로 나뉘어 있지 않아
pyeong_exclusive·pyeong_supply·area_m2_* 를 줘도 전체 평형 기준 값이 오고
warning_pyeong_fallback으로 실토한다(값이 잘못 나가는 게 아니라 **다른 모수**다).
평형별 전월세가 필요하면 단지 단위 realty_complex_rent_by_pyeong으로 가라.

**면적은 사용자가 말한 단위 그대로 넣어라 — 환산은 서버가 한다**(2026-08-22 제보):
- ㎡로 말했으면 → area_m2_exclusive(전용 84㎡ → 84) / area_m2_supply(공급 112.8㎡ → 112.8)
- 평으로 말했으면 → pyeong_supply(분양 "34평") / pyeong_exclusive(전용 실평수 25.4평)
㎡ 값을 평 인자에 넣으면 조용히 환산하지 않고 사유와 두 방향 출구를 적어 거절한다.

**가격순 '목록'이 필요하면 top_n을 준다**(2026-09-07 외부 신고 T-2026W34-352):
"강남구 신고가 상위 5개"·"제일 비싸게 팔린 아파트"처럼 개별 거래를 나열하는 질문은
이 인자 없이는 답이 안 나온다 — 종전엔 그런 질문이 이 도구로 라우팅된 뒤 집계
(최고/평균/중앙)만 받고 목록을 못 줬다. top_transactions에 단지·평형·금액·계약일·층이
온다. **다만 그것은 '창 안의 고가 거래'이지 신고가(역대 최고가 경신)가 아니다** —
그 경계는 top_n을 준 응답이 같은 블록에서 적는다(이 도구 설명은 필드 이름을 대지
않는다 — 조건부로만 실리는 키를 설명이 무조건 지목하면 top_n 없이 부른 응답에서
없는 이름을 찾게 만든다, S364).

**동별 시세는 by_dong=true 한 번으로**(2026-10-23, T-2026W43-38): '전주 덕진구 동별 84㎡
시세'처럼 시군구 안 동을 견주는 질문은 법정동마다 이 도구를 부르지 말고 시군구 region에
by_dong=true를 준다 — 매매는 평형 인자를 함께 주면 동별 그 평형 중앙값·건수가 온다.

**기준일 전후 비교·단지별 층/평형 분해는 여기서 한 번에**: 단지 목록엔 단지마다 층 밴드
분해(평형 미지정이면 평형대 4구간도)가 붙고 compare_from을 주면 전후 비교가 붙는다. 창은
months 전체(6개월 고정 아님)·계약해제 제외다. '고층 신고가냐 시세 상승이냐'는 전후 창의 층
분해로 가른다. 한쪽 3건 미만이면 변화율은 판정 보류, 기준일 이후 창은 신고기한 30일로 미완결.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "region": "<region>"
    },
    "name": "realty_region_price_stats"
  }
}

Input Schema

NameRequiredDescriptionDefault
top_nNo**가격순 상위 거래 '목록'을 함께 받는다**(1~20). '신고가 상위 5개', '제일 비싸게 팔린 아파트', '고가 거래 목록'처럼 **개별 거래를 나열**하는 질문이 이 인자다 — 안 주면 이 도구는 평균·중앙·최고 같은 **집계만** 답하고 목록은 못 준다. 행에 단지·전용면적·평형·금액·계약일·층이 실린다(top_transactions). metric='price'에서만 동작한다 (허용 범위 1~20)
metricNoprice=매매, rental=전월세. **평형 인자(pyeong_exclusive·pyeong_supply·area_m2_exclusive·area_m2_supply)는 price에서만 먹는다** — 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다(전체 평형 값이 오고 warning_pyeong_fallback으로 실토한다). 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라price
monthsNo조회 개월 수 (허용 범위 1~60)
regionYes지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 **법정동까지**(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 **고르지 않고 거절**하며 이름이 정확히 같은 후보 목록을 준다('동구'는 '남동구'가 아니다). 단지명은 여기 넣지 마라(단지는 realty_search_complexes·realty_complex_pyeong_price 담당)
by_dongNo시군구 안 **법정동별 중앙값**을 한 번에 함께 받는다(by_dong) — 동마다 이 도구를 따로 부르지 마라. metric='price'(매매): 평형 인자(area_m2_exclusive 등)를 주면 **동별 그 평형 매매 중앙값·건수**(동 하나에 한 행), 안 주면 법정동 × 평형대 4구간(소형<60·중소형 60~85·중형 85~115·대형 115㎡+) 중앙값과 지역 평형대 4구간 시세(이상치 필터)를 싣는다(창 상한 24개월). metric='rental': 법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값(평형 인자 미적용). 둘 다 표본 3건 이상 칸만 나오고 뺀 칸 수를 공시한다. region이 법정동 하나면 그 동 한 곳의 행만 온다 — 형제 동과 견주려면 region에 시군구를 넣어라
compare_fromNo기준일 전후 비교(YYYY-MM-DD) — '○○ 발표 전후 단지별 시세'. 단지마다 전·후 창의 건수·중앙값·최고가 거래(계약일·층)·변화율이 붙는다. 단지 도구를 단지마다 부르지 마라. 창은 months 전체라 기준일 이전이 들어오게 잡아라. price 전용
pyeong_supplyNo분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. **㎡로 말했으면 area_m2_supply를 쓰라** **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라.
area_m2_supplyNo공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~800)
pyeong_exclusiveNo전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라** (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡ **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라.
area_m2_exclusiveNo전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~500)
include_footnotesNotrue면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / by_dong / description
      Previous value: -"metric='rental'에서 **법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값**을 함께 받는다(by_dong). '세종 어느 동이 전세 2.3억 이하야'처럼 한 시군구 안에서 동을 고르는 질문의 자리다 — 세종은 시군구가 하나라 이 인자 없이는 동별 전세를 못 가른다. 표본 3건 이상 칸만 나온다. 매매 동별은 realty_area_price_bands(by_dong=true)"New value: +"시군구 안 **법정동별 중앙값**을 한 번에 함께 받는다(by_dong) — 동마다 이 도구를 따로 부르지 마라. metric='price'(매매): 평형 인자(area_m2_exclusive 등)를 주면 **동별 그 평형 매매 중앙값·건수**(동 하나에 한 행), 안 주면 법정동 × 평형대 4구간(소형<60·중소형 60~85·중형 85~115·대형 115㎡+) 중앙값과 지역 평형대 4구간 시세(이상치 필터)를 싣는다(창 상한 24개월). metric='rental': 법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값(평형 인자 미적용). 둘 다 표본 3건 이상 칸만 나오고 뺀 칸 수를 공시한다. region이 법정동 하나면 그 동 한 곳의 행만 온다 — 형제 동과 견주려면 region에 시군구를 넣어라"
  2. Changed1 schema field changed
    • addedInput schema / properties / include_footnotes
      Added value: +{
      +  "default": false,
      +  "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지",
      +  "title": "Include Footnotes",
      +  "type": "boolean"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / compare_from / description
      Previous value: -"**기준일 전후 비교**(YYYY-MM-DD, 예: '2026-08-01'). 주면 단지 목록의 단지마다 기준일 이전(조회 창 시작~전날)과 이후(기준일~오늘) 두 창의 건수·중앙값·최고가 거래(계약일·층·금액)와 중앙값 변화율이 붙는다 — '○○ 발표 전후 단지별 시세', '정책 전후 비교'가 이 인자다. 단지마다 단지 도구를 따로 불러 손으로 가르지 마라. 창 전체는 months(최대 60)이므로 기준일 이전 구간이 충분히 들어오게 months를 잡아라. 평형을 주면 그 평형만 비교한다. metric='price'에서만 동작한다"New value: +"기준일 전후 비교(YYYY-MM-DD) — '○○ 발표 전후 단지별 시세'. 단지마다 전·후 창의 건수·중앙값·최고가 거래(계약일·층)·변화율이 붙는다. 단지 도구를 단지마다 부르지 마라. 창은 months 전체라 기준일 이전이 들어오게 잡아라. price 전용"
  4. Changed1 schema field changed
    • addedInput schema / properties / compare_from
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "**기준일 전후 비교**(YYYY-MM-DD, 예: '2026-08-01'). 주면 단지 목록의 단지마다 기준일 이전(조회 창 시작~전날)과 이후(기준일~오늘) 두 창의 건수·중앙값·최고가 거래(계약일·층·금액)와 중앙값 변화율이 붙는다 — '○○ 발표 전후 단지별 시세', '정책 전후 비교'가 이 인자다. 단지마다 단지 도구를 따로 불러 손으로 가르지 마라. 창 전체는 months(최대 60)이므로 기준일 이전 구간이 충분히 들어오게 months를 잡아라. 평형을 주면 그 평형만 비교한다. metric='price'에서만 동작한다",
      +  "title": "Compare From"
      +}
  5. Changed1 schema field changed
    • addedInput schema / properties / by_dong
      Added value: +{
      +  "default": false,
      +  "description": "metric='rental'에서 **법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값**을 함께 받는다(by_dong). '세종 어느 동이 전세 2.3억 이하야'처럼 한 시군구 안에서 동을 고르는 질문의 자리다 — 세종은 시군구가 하나라 이 인자 없이는 동별 전세를 못 가른다. 표본 3건 이상 칸만 나온다. 매매 동별은 realty_area_price_bands(by_dong=true)",
      +  "title": "By Dong",
      +  "type": "boolean"
      +}
  6. Changed1 schema field changed
    • changedInput schema / properties / region / description
      Previous value: -"지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 **법정동까지**(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 거래량 최다 지역으로 답하고 나머지 후보를 region_candidates로 실토한다. 단지명은 여기 넣지 마라(단지는 realty_search_complexes·realty_complex_pyeong_price 담당)"New value: +"지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 **법정동까지**(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 **고르지 않고 거절**하며 이름이 정확히 같은 후보 목록을 준다('동구'는 '남동구'가 아니다). 단지명은 여기 넣지 마라(단지는 realty_search_complexes·realty_complex_pyeong_price 담당)"
  7. Changed1 schema field changed
    • addedInput schema / properties / top_n
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 20,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "**가격순 상위 거래 '목록'을 함께 받는다**(1~20). '신고가 상위 5개', '제일 비싸게 팔린 아파트', '고가 거래 목록'처럼 **개별 거래를 나열**하는 질문이 이 인자다 — 안 주면 이 도구는 평균·중앙·최고 같은 **집계만** 답하고 목록은 못 준다. 행에 단지·전용면적·평형·금액·계약일·층이 실린다(top_transactions). metric='price'에서만 동작한다 (허용 범위 1~20)",
      +  "title": "Top N"
      +}
  8. Changed5 schema fields changed
    • changedInput schema / properties / area_m2_exclusive / description
      Previous value: -"전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 (허용 범위 0 초과~500)"New value: +"전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~500)"
    • changedInput schema / properties / area_m2_supply / description
      Previous value: -"공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 (허용 범위 0 초과~800)"New value: +"공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~800)"
    • changedInput schema / properties / metric / description
      Previous value: -"price=매매, rental=전월세"New value: +"price=매매, rental=전월세. **평형 인자(pyeong_exclusive·pyeong_supply·area_m2_exclusive·area_m2_supply)는 price에서만 먹는다** — 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다(전체 평형 값이 오고 warning_pyeong_fallback으로 실토한다). 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라"
    • changedInput schema / properties / pyeong_exclusive / description
      Previous value: -"전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라** (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡"New value: +"전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라** (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡ **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라."
    • changedInput schema / properties / pyeong_supply / description
      Previous value: -"분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. **㎡로 말했으면 area_m2_supply를 쓰라**"New value: +"분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. **㎡로 말했으면 area_m2_supply를 쓰라** **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라."
  9. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": true,
      -  "title": "realty_region_price_statsDictOutput",
      -  "type": "object"
      -}New value: +null
  10. Changed7 schema fields changed
    • addedInput schema / properties / area_m2_exclusive
      Added value: +{
      +  "anyOf": [
      +    {
      +      "exclusiveMinimum": 0,
      +      "maximum": 500,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 (허용 범위 0 초과~500)",
      +  "title": "Area M2 Exclusive"
      +}
    • addedInput schema / properties / area_m2_supply
      Added value: +{
      +  "anyOf": [
      +    {
      +      "exclusiveMinimum": 0,
      +      "maximum": 800,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 (허용 범위 0 초과~800)",
      +  "title": "Area M2 Supply"
      +}
    • changedInput schema / properties / pyeong_exclusive / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "exclusiveMinimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / pyeong_exclusive / description
      Added value: +"전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라** (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡"
    • changedInput schema / properties / pyeong_supply / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "exclusiveMinimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / pyeong_supply / description
      Added value: +"분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. **㎡로 말했으면 area_m2_supply를 쓰라**"
    • addedInput schema / properties / region / description
      Added value: +"지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 **법정동까지**(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 거래량 최다 지역으로 답하고 나머지 후보를 region_candidates로 실토한다. 단지명은 여기 넣지 마라(단지는 realty_search_complexes·realty_complex_pyeong_price 담당)"
  11. Changed1 schema field changed
    • changedInput schema / properties / months / description
      Previous value: -"조회 개월 수"New value: +"조회 개월 수 (허용 범위 1~60)"
  12. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Goes well past the read-only/idempotent annotations: region matching is token-exact and ambiguous names are rejected with candidates rather than guessed, rental silently uses all-pyeong data and discloses it via warning_pyeong_fallback, top_n returns window highs (not all-time highs), cells under 3 samples are suppressed with a count of omissions, and post-baseline windows are incomplete due to the 30-day reporting deadline.

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

Conciseness3/5

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

Front-loaded and sectioned with bold headers, but bloated well past what an agent needs: the rental/pyeong fallback caveat is repeated verbatim across five parameter descriptions and the body, and internal changelog artifacts (ticket IDs T-2026W34-352, S364, dates, a truncated trailing sentence) add noise rather than selection signal.

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

Completeness5/5

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

For an 11-parameter, output-schema-less tool this covers what an agent needs to call it correctly: unit handling, metric-specific degradations, ambiguity rejection protocol, aggregation-vs-list behavior, sample-size suppression, and window limits.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3; the description earns more by adding a cross-cutting rule the schema fragments do not state (put the unit the user spoke in, the server converts; ㎡ values in pyeong params are rejected with reasons and two exits) and by explaining the by_dong/compare_from window interactions.

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

Purpose5/5

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

States a specific verb+resource+granularity (지역 아파트 실거래 시세 월별 추이 조회) and immediately positions itself among three 시세 tools, naming realty_area_price_bands (level/quote) and realty_search_complexes (specific complex) as the alternatives with the conditions that select each.

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

Usage Guidelines5/5

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

Explicit routing rules for every branch: monthly flow → this tool; price level quoting → bands; specific apartment → search_complexes; per-dong comparison → by_dong instead of per-dong calls; per-pyeong rental → realty_complex_rent_by_pyeong; listing questions → top_n. It also states what to do when a name is rejected (re-ask with the returned candidate list).

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.