Skip to main content
Glama

korea-realty

by app.sallim
OverviewDiscussionsAdmin

급매 경매 물건

realty_auction_alerts
Read-onlyIdempotent

유찰이 쌓여 최저입찰가가 크게 떨어진 경매 물건을 골라낸다.

유찰이 누적돼 최저입찰가가 크게 떨어진 물건을 찾는다. "○○에서 유찰 많은 물건"은
sido/sigungu로 좁혀라.

유찰이 많다는 건 싸다는 뜻이기도 하지만 권리관계·물건 하자 등 팔리지 않는 이유가
있다는 뜻이기도 하다. 결과를 추천으로 제시하지 말고 확인이 필요한 후보로 제시하라.

**같은 축의 다른 문**: realty_search_auctions(min_fail_count)로도 유찰 물건을 거를 수
있다 — 조건 필터·목록이 목적이면 그쪽, 저감 큰 후보 발굴(극단 할인 컷 포함)이면 이쪽.
둘을 합쳐 세지 마라(같은 물건이 양쪽에 나온다).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sidoNo시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라.
limitNo반환 개수 (최대 50) (허용 범위 1~50)
sigunguNo시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다.
usage_nameNo물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(**표기를 바꾸지 않는다** — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지·임야·전답으로 나뉘어 있다. 비우면 전 종류
min_bid_countNo최소 유찰 횟수 (허용 범위 0~100)
max_discount_pctNo감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100)
min_discount_pctNo감정가 대비 최소 할인율(%) (허용 범위 0~100)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / sigungu / description
      Previous value: -"시군구 (예: 강남구, 수원시)"New value: +"시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
  2. Changed1 schema field changed
    • changedInput schema / properties / usage_name / description
      Previous value: -"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류"New value: +"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(**표기를 바꾸지 않는다** — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지·임야·전답으로 나뉘어 있다. 비우면 전 종류"
  3. Changed1 schema field changed
    • changedInput schema / properties / sido / description
      Previous value: -"시도 (예: 세종, 경기도)"New value: +"시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
-  "additionalProperties": true,
-  "title": "realty_auction_alertsDictOutput",
-  "type": "object"
-}New value: +null
  5. Changed1 schema field changed
    • addedInput schema / properties / usage_name / description
      Added value: +"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류"
  6. Changed4 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"반환 개수 (최대 50)"New value: +"반환 개수 (최대 50) (허용 범위 1~50)"
    • changedInput schema / properties / max_discount_pct / description
      Previous value: -"감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라"New value: +"감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100)"
    • changedInput schema / properties / min_bid_count / description
      Previous value: -"최소 유찰 횟수"New value: +"최소 유찰 횟수 (허용 범위 0~100)"
    • changedInput schema / properties / min_discount_pct / description
      Previous value: -"감정가 대비 최소 할인율(%)"New value: +"감정가 대비 최소 할인율(%) (허용 범위 0~100)"
  7. Changed3 schema fields changed
    • addedInput schema / properties / max_discount_pct
      Added value: +{
+  "default": 100,
+  "description": "감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라",
+  "maximum": 100,
+  "minimum": 0,
+  "title": "Max Discount Pct",
+  "type": "integer"
+}
    • addedInput schema / properties / sido
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "시도 (예: 세종, 경기도)",
+  "title": "Sido"
+}
    • addedInput schema / properties / sigungu
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "시군구 (예: 강남구, 수원시)",
+  "title": "Sigungu"
+}
  8. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, destructiveHint=false, so the safety profile is covered. The description adds genuine behavioral context beyond that: results must be presented as candidates needing verification, not recommendations, and it warns that many failed bids can signal rights issues or property defects. This interpretive/presentation guidance is valuable beyond the annotations.

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?

The description is a few tight sentences, front-loaded with the core purpose, followed by narrowing guidance, interpretation caution, presentation rule, and sibling differentiation. Each sentence earns its place — no filler. It is slightly longer than strictly necessary, but every clause adds functional value for the agent.

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?

For a read-only filtered search tool, the combination is nearly complete: annotations cover safety (readOnly, openWorld, idempotent, non-destructive), the schema covers all parameters with ambiguity and mapping caveats, and the description covers purpose, usage routing, interpretation, and presentation. The return format is not described, but no output schema exists and the tool's output (a list of matching auction properties with discount details) is predictable from the name and purpose. Nothing critical is missing for correct invocation.

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% — all 7 parameters are documented in the schema with rich detail (ambiguity warnings for '광주' and '중구', usage_name mapping notes for '빌라', max_discount_pct extreme-discount caveat). The description adds no parameter-level semantics beyond schema, which is acceptable per the baseline-3 rule for high schema coverage. The description's sido/sigungu narrowing hint maps to existing schema docs rather than adding new param meaning.

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?

The description opens with a specific verb and resource: '유찰이 쌓여 최저입찰가가 크게 떨어진 경매 물건을 골라낸다' (selects auction properties where failed bids accumulated and the minimum bid dropped significantly). It states the selection criterion (accumulated failed bids → big price drop) and explicitly names the sibling it is not — realty_search_auctions(min_fail_count) — so an agent can distinguish them without opening schemas.

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?

Usage guidance is explicit and actionable: narrow by sido/sigungu for '○○에서 유찰 많은 물건' queries, and the tool explicitly routes to the sibling — realty_search_auctions(min_fail_count) for condition filtering/list, this tool for big-discount candidate discovery (including extreme discount cuts). It also warns not to combine both because the same items appear in both, preventing duplicate-result confusion.

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

All korea-realty toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources