Skip to main content
Glama

지역 평형대별 시세 구간

realty_area_price_bands
Read-onlyIdempotent

지역의 매매 시세를 평형대 4구간(소형/중소형/중형/대형, 전용면적 기준)으로 조회한다. "○○구에서 무슨 평수대가 얼마쯤 해?"류 질문용 — 특정 단지는 realty_search_complexes를 쓰라.

**이 축의 자리(시세 도구 3종 중)**: 지역의 가격 **수준** 비교는 이게 기본값이다.
이상치 필터(계약해제 제외 + **직거래 중** 같은 평형대 중개거래 중앙값의 50% 미만만 제외)가
적용돼 realty_region_price_stats의 미필터 평균과
값이 다르며, **수준이 갈리면 이쪽을 우선하라**. 월별 **추이**가 필요하면
region_price_stats, 단지가 특정되면 search_complexes.

구간 라벨의 평수는 **전용평**이다. 사용자의 분양평 감각으로는 소형<60㎡≈분양 24평 미만,
중소형 60~85㎡≈분양 24~34평, 중형 85~115㎡≈분양 34~47평, 대형 115㎡+≈분양 47평 이상.

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_area_price_bands"
  }
}

Input Schema

NameRequiredDescriptionDefault
regionYes시군구명 (예: 마포구). **법정동까지 넣어도 된다**(예: '마포구 아현동') — 구 하나로 뭉치면 신도심·구도심이 한 값이 된다
by_dongNo법정동 × 평형대 중앙값을 함께 낸다. '이 구에서 어디가 싼가'류 질문의 자리다 — 실측(마포구 6개월, 전용 60~84㎡): 서교동 6.8억 ~ 용강동 27.1억으로 한 구 안에서 4배 갈린다. 표본 3건 이상 칸만 나오고 뺀 칸 수(by_dong_hidden_cells)를 공시한다. 평형 하나(전용 84㎡ 등)로 좁힌 동별 값은 realty_region_price_stats(by_dong=true, 평형 인자)가 같은 산식으로 준다
period_monthsNo집계 기간(개월) (허용 범위 1~24)
include_footnotesNotrue면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / by_dong / description
      Previous value: -"법정동 × 평형대 중앙값을 함께 낸다. '이 구에서 어디가 싼가'류 질문의 자리다 — 실측(마포구 6개월, 전용 60~84㎡): 서교동 6.8억 ~ 용강동 27.1억으로 한 구 안에서 4배 갈린다. 표본 3건 이상 칸만 나온다"New value: +"법정동 × 평형대 중앙값을 함께 낸다. '이 구에서 어디가 싼가'류 질문의 자리다 — 실측(마포구 6개월, 전용 60~84㎡): 서교동 6.8억 ~ 용강동 27.1억으로 한 구 안에서 4배 갈린다. 표본 3건 이상 칸만 나오고 뺀 칸 수(by_dong_hidden_cells)를 공시한다. 평형 하나(전용 84㎡ 등)로 좁힌 동별 값은 realty_region_price_stats(by_dong=true, 평형 인자)가 같은 산식으로 준다"
  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
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": true,
      -  "title": "realty_area_price_bandsDictOutput",
      -  "type": "object"
      -}New value: +null
  4. Changed1 schema field changed
    • changedInput schema / properties / period_months / description
      Previous value: -"집계 기간(개월)"New value: +"집계 기간(개월) (허용 범위 1~24)"
  5. Changed2 schema fields changed
    • addedInput schema / properties / by_dong
      Added value: +{
      +  "default": false,
      +  "description": "법정동 × 평형대 중앙값을 함께 낸다. '이 구에서 어디가 싼가'류 질문의 자리다 — 실측(마포구 6개월, 전용 60~84㎡): 서교동 6.8억 ~ 용강동 27.1억으로 한 구 안에서 4배 갈린다. 표본 3건 이상 칸만 나온다",
      +  "title": "By Dong",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / region / description
      Previous value: -"시군구명 (예: 마포구)"New value: +"시군구명 (예: 마포구). **법정동까지 넣어도 된다**(예: '마포구 아현동') — 구 하나로 뭉치면 신도심·구도심이 한 값이 된다"
  6. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations only cover the safety profile (readOnly/idempotent/openWorld), and the description goes well beyond them: it discloses the outlier filter (excluding cancelled contracts and sub-50%-of-median direct trades), warns that this makes values differ from realty_region_price_stats' unfiltered mean, and notes the 3-sample minimum plus by_dong_hidden_cells disclosure. That is exactly the methodological context an agent needs to avoid misreporting numbers.

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?

Front-loaded with purpose and the routing rule, and each block (axis position, filter note, pyeong conversion) earns its place. Slightly dense with bold markers and stacked alternatives, but no filler sentences.

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?

No output schema exists, yet the description still covers return-shape essentials (band labels in exclusive pyeong, per-row one-line vs full footnotes, hidden-cell count) plus the unit-conversion table so the agent can translate to user-facing 분양평. Nothing needed to call it correctly is missing.

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 baseline is 3; the description adds real meaning on top by explaining that region can take a legal-dong string and that gu-level aggregation conflates new/old downtown, and by framing by_dong as the answer to a specific question with an observed 4x spread. It does not add much on period_months or include_footnotes beyond what the schema already says.

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: retrieves sale price levels for a region bucketed into four exclusive-area bands, with the band definition (전용면적 기준) inline. It explicitly names what it is not for (specific complexes → realty_search_complexes), so it is separable from the 50+ siblings without opening a schema.

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?

Gives the exact question shape it answers ("○○구에서 무슨 평수대가 얼마쯤 해?") and then positions it against both relevant alternatives: trend questions → realty_region_price_stats, specific complex → realty_search_complexes, and 'which dong is cheap' → the by_dong parameter. It even states a precedence rule when the two price-level tools disagree.

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.