Reevl — Korean Real Estate
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Korean apartment data: official transaction prices, jeonse ratios, AI forecasts. 45,000+ complexes.
| Author | kr.co.reevl |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 652 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Reevl — Korean Real Estate": {
"url": "https://reevl.co.kr/api/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (7)
search_apartmentsread-only전국 아파트 45,000여 개를 조건으로 거른다. "강남구 20억 이하 대단지", "전세가율 높은 곳", "AI 1년 예측이 높은 단지"처럼 조건이 있는 질문에 쓴다. 지역·브랜드·시공사는 완전일치이고, 수치 축은 <축>_min·<축>_max로 범위를 준다. 응답에 units(단위 설명)와 total이 함께 온다 — 단위를 지어내지 말고 units를 그대로 읽을 것. 기본 20건이며 total로 전체 규모를 알 수 있다. ★비교·순위·집계처럼 여러 건을 봐야 하는 질문이면 **한 번에 limit=100으로 받아 직접 추려라.** 20건씩 나눠 여러 번 부르는 것보다 그쪽이 훨씬 싸다(호출 비용은 건수와 거의 무관하다). 수천 건을 훑어야 하면 offset으로 넘기지 말고 describe_fields의 분포를 먼저 보고 조건을 좁혀라.
Parameters:
q— string — 단지명 부분 일치 검색어gu— string — 시군구. 예: 강남구, 수원시 장안구. ★구를 둔 시는 '수원시'처럼 **시 단위로도** 받는다(하위 구 전체가 잡히고 normalized에 그 사실이 온다)dong— string — 읍면동. 예: 대치동sido— string — 시도. 예: 서울, 경기, 부산. (광주는 전남광주로 정규화된다)sort— string — 정렬 축(수치 축 이름). 예: price, fc12, hh, jrbrand— string — 브랜드. 예: 자이, 래미안, 힐스테이트limit— number — 1~100, 기본 20order— string — 기본 descfields— string — 쉼표로 구분한 축 목록, 또는 'all'. 기본은 14축(토큰 절약)hh_min— number — 세대수 하한jr_min— number — 전세가율 하한(%). 값 그대로 — 60이면 60%offset— number — 건너뛸 건수(페이지네이션)status— string — 단지 상태로 좁힌다. existing=기존 단지 · upcoming=분양 예정(price가 분양가) · unranked=무순위 청약. ★예측(fc*)으로 정렬·필터하면 자동으로 existing만 남는다 — 분양 예정을 보려면 여기서 명시할 것age_max— number — 준공 후 경과 연수 상한builder— string — 시공사. 예: 현대건설fc12_min— number — 리블 AI 1년 예측 하한(%). 값 그대로price_max— number — 매매 대표가 상한(만원)price_min— number — 매매 대표가 하한(만원)
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_apartmentread-only단지 하나의 전 축을 뜻이 통하는 묶음(기본·가격·전세월세·거래·등락·AI예측·입지·건물)으로 준다. search_apartments로 고른 뒤 그 cid로 부른다. 특정 단지를 판단해야 할 때 쓴다.
Parameters:
cid(required) — string — 단지 식별자. 예: '11290|길음뉴타운1단지(래미안길음1차)|길음동|1279'
Hints: read-only yes · destructive no · idempotent yes · open-world no
search_propertiesread-only빌라(연립·다세대)·오피스텔·단독다가구·토지·상가/사무실·아파트 분양권의 실거래를 지역별로 준다. "송파구 빌라 시세", "제주 토지 평당가", "강남 상가 얼마"처럼 **아파트가 아닌** 질문에 쓴다. ★아파트는 이 도구가 아니라 search_apartments를 쓸 것 — 둘은 데이터가 완전히 분리돼 있다. ★지역(sido+gu)이 **반드시** 필요하다. 전국 단위 목록은 주지 않는다 — 빌라만 24만 곳이라 한 번에 줄 수 없고, 준다 해도 읽을 수 없다. ★집계 단위가 유형마다 다르다: 빌라·오피스텔·분양권은 **단지**, 단독·토지·상가는 **법정동**이다 (응답의 unit이 알려준다). 단독·토지·상가에서 name은 건물 이름이 아니라 동 이름이다. ★AI 예측(fc)은 없다. 빌라는 단지당 20년에 10건꼴이라 예측이 성립하지 않는다 — 있는 척하지 말고 "실거래 통계"로만 답할 것.
Parameters:
kind(required) — string — villa=연립다세대 · officetel=오피스텔 · detached=단독다가구 · land=토지 · commercial=상가/사무실/건물 · presale=아파트 분양권 · ★_rent가 붙으면 **전월세**다(villa_rent·officetel_rent·detached_rent) — rep_price 대신 jtot(전세 대표가)·wolse_med(중위 월세)를 본다 · subscription=청약(분양 공고, 실거래 없음) · rental=공공임대(LH·마이홈 공급정보, 실거래 없음) · auction=공매(온비드, 금액은 감정가이며 실거래가 아님)gu(required) — string — 시군구. 예: 송파구, 제주시sido— string — 시도. 예: 서울, 제주. (광주는 전남광주로 정규화된다)sort— string — 정렬 축. 기본 n_total(거래 많은 순). ★유형에 없는 축으로 정렬하면 순서가 무의미해진다 — 전월세는 jtot·wolse_med, 공매는 min_low, 청약은 sub_end를 쓴다limit— number — 1~100, 기본 20
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_transactionsread-only한 단지(또는 법정동)의 **개별 거래**를 최신순으로 준다 — 날짜·금액·면적·층까지. 다른 도구는 "최근 1년 102건"처럼 **집계**만 줘서 "가장 최근 거래가 언제 얼마"에 답할 수 없었다. "이 단지 최근 거래", "같은 평형 최근 10건", "직전 거래 대비 얼마나 올랐나"에 이 도구를 쓴다. ★아파트와 유형 **전부** 지원한다(kind 생략 시 아파트). ★전월세는 금액이 **보증금·월세 둘**이다 — price 하나로 뭉치지 말 것. 월세 0이면 순수 전세다. ★해제(취소)된 신고도 그대로 준다(canceled=true). 지우면 취소된 신고가를 확인할 방법이 없어서다 — 시세로 인용할 때는 반드시 빼고 말할 것. ★cid는 search_apartments·search_properties 응답에 들어 있다. 손으로 조립하지 말 것.
Parameters:
cid(required) — string — 단지 식별자. 검색 응답의 cid를 그대로 쓴다deal— string — 아파트만 해당. 기본 sale. rent면 전월세 실거래를 준다kind— string — 기본 apt(아파트). ★_rent는 전월세라 응답 형식이 다르다limit— number — 1~200, 기본 30area_m2— number — 전용면적(㎡)으로 거른다. ±1.5㎡ 안을 같은 평형으로 본다
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_loan_rulesread-only주택담보대출의 **현행 규제 수치**를 준다 — LTV·DSR·스트레스 가산금리·규제지역·가격대별 상한. "5억 아파트 사려면 대출 얼마 나오나", "연봉 5천에 현금 1억이면 살 수 있나"에 이 도구를 먼저 부른다. ★★리블은 **계산하지 않는다.** 이 값을 받아서 **네가** 계산하라 — 규제는 자주 바뀌는데 계산기를 우리가 들고 있으면 바뀐 날부터 조용히 틀린 답이 나간다. 우리는 사실과 기준일을 주고, 산수는 네가 하는 편이 정확하다. ★응답의 as_of 이후 개정은 반영돼 있지 않다 — 답할 때 그 날짜를 함께 말할 것. ★how_to_calculate에 순서가 적혀 있다. LTV 한도와 DSR 한도 중 **작은 쪽**이 실제 한도다. ★취득세·중개보수는 이 표에 **없다**(가격·주택수·지역에 따라 갈린다). 모르면 모른다고 하라.
Hints: read-only yes · destructive no · idempotent yes · open-world no
describe_fieldsread-only검색에 쓸 수 있는 모든 축과 **단위**, 값의 분포(최소·중위·최대)와 시도별 단지 수를 준다. ★조건 검색 전에 한 번 부르는 것을 권한다 — 단위를 모르고 범위를 넣으면 100배 틀린 조건이 된다 (예: 전세가율은 값 그대로 %, 세대당 대지지분은 10으로 나눠야 ㎡).
Parameters:
sido— string — field=gu일 때 특정 시도로 좁힌다field— string — 이 축의 실제 값 목록을 받는다(sido·gu·dong·brand·builder 등 문자 축)
Hints: read-only yes · destructive no · idempotent yes · open-world no
list_articlesread-only리블이 발행한 부동산 브리핑 목록(제목·요약·발행일·링크). 정책 보도자료 정리와 실거래 데이터 분석을 거의 매일 낸다. 최근 시장 상황이나 정책 흐름을 물을 때 근거로 쓴다.
Parameters:
limit— number — 1~30, 기본 10
Hints: read-only yes · destructive no · idempotent yes · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.