한국 부동산 경매·시세 데이터 MCP 서버. duckdb-api 백엔드를 감싸 ChatGPT·Claude 등 MCP 클라이언트에 읽기전용 도구로 노출한다. 법원경매, 아파트 실거래 시세·단지 분석, 청약 분양, 지역 순위·인구·거시지표를 다룬다.
28 tools with complete schemas and descriptions. Naming is consistent (verb_noun pattern: search_, get_, realty_*). Descriptions are domain-specific and actionable (avg ~120 chars, well above 20-char floor). All parameters have types and descriptions. Output schemas are documented in code comments. However, some parameter descriptions lack explicit constraints (enums, ranges), and error handling guidance is minimal. Tool composition is sound, each tool has a single responsibility. The INSTRUCTIONS block is exceptionally detailed (domain-specific routing, unit clarifications, tier explanations), which partially compensates for sparse per-tool error recovery hints.
아파트 실거래 시세 조회 — 지역·평형·기간으로 시세 통계 반환
양도세 계산 — 양도가·취득가·보유기간으로 양도세 계산 및 시나리오 비교
[유료] 단지 통합 리포트 — 단지의 시세·거래·평형별 분석 종합
법원경매 물건 상세 조회 — 사건번호와 법원명으로 특정 물건의 전체 정보 반환
[유료] 인프라 통계 — 지역의 학교·병원·대중교통·상점 밀도
[유료] 투자 위험 평가 — 지역의 시장 변동성·공실률·규제 위험
대출 한도 계산 — 지역·시가·차주 유형으로 LTV·가액구간 한도 계산
Enum constraints missing for string parameters. Tools like realty_policy_rules(topic), realty_presale(status), realty_notice_text(section) accept free-form strings without declared enums. LLMs will hallucinate invalid values (e.g. 'topic=invalid_topic'). Descriptions mention examples ('예: 접수중, 접수예정') but lack formal enum constraints.
Numeric parameter ranges undocumented. Tools like realty_apt_prices(months_back), realty_subscription_odds(my_score), realty_capital_gains_tax(holding_months) lack min/max constraints. LLMs may pass negative, zero, or absurdly large values (e.g. months_back=-5, my_score=999, holding_months=10000).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | B | 79 | 2026-07-28+ | v2 |
[유료] 입지 분석 — 지역의 교통·상권·학군·편의시설 점수
[유료] 시장 신호 — 거래량·가격 추세·심리 지표로 시장 신호 판정
도시정비법 39조 판정 — 투기과열·사업유형·단계로 입주권 양도 가능 여부 판정
비아파트(빌라·오피스텔·단독) 시세 — 빌라·다세대·연립·오피스텔·단독주택 매매 시세
청약 공고 원문 팩트시트 — 공고 원문에서 추출한 조건·가격표·일정
청약 공고 원문 조회 — 공고 원문의 특정 섹션(자격·유의사항 등) 반환
부동산 규제·세금 규칙 조회 — 규제지역·취득세·대출 규칙 표 반환
청약 분양 공고 목록 — 지역·상태로 공고 검색
분양 자금 계획 — 공고 총소요·자기자금·규제 상한으로 계약금·중도금·잔금 판정
[유료] 분양가 대 실거래 시세 비교 — 공고의 분양가를 주변 시세와 자동 대조
[유료] 가격 예측 — 머신러닝 모델로 향후 시세 예측
[유료] 재건축 현황 — 지역의 재건축 사업 진행 단계·예상 기간
[유료] 재개발 현황 — 지역의 재개발 사업 진행 단계·예상 기간
[유료] 지역 비교 — 여러 지역의 시세·거래·인구를 나란히 비교
지역 시세 통계 — 지역의 평형별·연도별 실거래 시세 분포
[유료] 지역 순위 — 지역별 시세·거래량·상승률 순위
[유료] 수익률 분석 — 매매·전월세 수익률 계산 및 비교
법원경매 물건 검색 — 사건번호·지역·가격·상태로 필터링
아파트 단지 검색 — 단지명·지역으로 검색하고 평형별 시세 반환
청약 경쟁률·당첨 가점 커트라인 — 공고의 경쟁률과 가점별 당첨 확률
오류·개선 신고 — 도구 결과의 오류나 개선 사항을 운영팀에 신고
Error handling lacks recovery guidance. Tools return errors (e.g. 'not found', 'invalid input') without actionable next steps. Per pattern:recovery-guide, errors should suggest alternatives: 'Region not found. Try realty_region_price_stats with a broader region (시도 level).' Current code has no such hints.
Paid tools ([유료]) lack clear API key requirement documentation in parameter descriptions. Tools like realty_price_prediction, realty_complex_report, realty_region_ranking mention '[유료]' in the tool description but do not document in parameters that an API key is required or how to provide it. LLMs may attempt calls without credentials and receive unhelpful 'purchase' responses.
Output schema documentation incomplete. While tool descriptions exist, the actual response structure (fields, types, pagination) is not formally documented in the source. LLMs cannot plan downstream tool calls without knowing what fields to expect (e.g. does realty_search_complexes return complex_key for use in realty_complex_report?).