# Korea Real Estate Data (실거래가·단지·청약)

> Korean apartment transactions, complex profiles and housing subscription data by region/complex name

- name: io.github.hoftlab/kr-realestate-mcp
- version: 0.2.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 89/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.hoftlab%2Fkr-realestate-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.hoftlab%2Fkr-realestate-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "kr-realestate-mcp": {
      "type": "http",
      "url": "https://kr-realestate-mcp.gamto.workers.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 45
- drivers: +website +reachable +uptime-100% +updated-7d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 89/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 14 of 14 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,945 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 14, about 2,945 tokens to load them all
- tool set hash: 2274af3a1015b2f19f4e8ac0cc22c8d8
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.hoftlab/kr-realestate-mcp.svg)](https://protogrid.dev/servers/io.github.hoftlab/kr-realestate-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://kr-realestate-mcp.gamto.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.96153843)
- https://kr-realestate-mcp.gamto.workers.dev/sse (sse, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (14)

- `kr_apt_compare`: [평소 $0.03/호출 — 현재 무료 모드] 2~5개 단지를 같은 기간으로 나란히 비교한다: 세대수·사용승인·면적타입별 매매 건수/중위가/평당가·전세 중위 보증금·전세가율, 그리고 두 단지 이상에 공통인 면적타입 교차표. 다른 시군구 단지끼리도 가능. Compare 2-5 complexes side by side.
- `kr_apt_price_summary`: [평소 $0.02/호출 — 현재 무료 모드] 단지의 매매 실거래를 면적타입별로 집계한다: 건수·최저/최고/평균/중위·최근 거래·최고가·평당가·기간 전후반 변화율, 월별 추이. Price summary by area type for a complex.
- `kr_apt_profile`: [평소 $0.01/호출 — 현재 무료 모드] 단지 기본정보: 세대수·동수·사용승인일·시공사·분양/임대·난방·복도형식·관리방식·면적 구성·주차·승강기·CCTV·지하철역/도보·버스·교육/편의/복지시설. kaptCode를 알면 region/aptName 대신 직접 지정. Complex profile from K-apt.
- `kr_apt_rents`: [평소 $0.01/호출 — 현재 무료 모드] 단지명과 기간으로 아파트 전월세 실거래 목록을 돌려준다(전세/월세 구분, 보증금·월세 만원, 신규/갱신, 갱신요구권, 종전 계약 조건). Jeonse/monthly-rent transactions for a complex.
- `kr_apt_rent_summary`: [평소 $0.02/호출 — 현재 무료 모드] 단지의 전월세 실거래를 면적타입별로 집계하고(전세 중위 보증금, 월세 보증금/월세 중위, 갱신 비중) 같은 기간 매매 중위가 대비 전세가율(%)을 계산한다. Rent summary with jeonse-to-price ratio.
- `kr_apt_report`: [평소 $0.05/호출 — 현재 무료 모드] 단지 종합 리포트 한 번에: 기본정보(K-apt) + 최근 N개월(기본 12) 매매 요약 + 전월세 요약 + 전세가율 + 최근 거래 10건 + 같은 시군구 시장 맥락(월별 거래량·평당가). 여러 공공 API를 결합한 상위 도구. All-in-one complex report.
- `kr_apt_search`: [무료] 지역 + 단지명 키워드로 K-apt(공동주택관리정보시스템) 등록 단지 후보를 찾는다. 단지코드(kaptCode)·법정동·유사도 점수를 돌려주므로 유료 도구 호출 전에 정확한 단지명을 확정하는 데 쓴다. Search apartment complexes by region and name keyword.
- `kr_apt_trades`: [평소 $0.01/호출 — 현재 무료 모드] 단지명과 기간으로 아파트 매매 실거래 목록을 돌려준다(지역코드 변환·단지명 유사도 매칭·다개월 결합·금액/면적 정규화 포함). 금액 단위 만원, 평당가 포함. Apartment sale transactions for a complex over a period.
- `kr_presale_trades`: [평소 $0.02/호출 — 현재 무료 모드] 아파트 분양권·입주권 전매 실거래. 단지명을 주면 그 단지, 생략하면 시군구 전체(단지별 집계). 권리구분(분양권/입주권)·면적타입별 건수·중위가·평당가와 거래 목록. Presale/occupancy-right resale transactions.
- `kr_pricing`: [무료] 이 서버의 도구 목록·건당 가격·결제 방식(x402, USDC)·데이터 출처와 갱신 주기·면책을 반환한다. Returns tool catalog, per-call prices and data sources.
- `kr_region_lookup`: [무료] 지역명('분당', '서울 강남구', '역삼동', '수원')을 실거래가 API용 법정동코드 5자리(lawdCd)로 변환한다. 구가 있는 시는 구 코드 목록(lawdCds)으로 펼친다. Map a Korean region name to the 5-digit legal district code.
- `kr_region_market`: [평소 $0.03/호출 — 현재 무료 모드] 시군구 단위 매매 시장 스냅샷: 월별 거래량·해제 건수·직거래 비중·중위가·평당가, 법정동별 집계, 면적대 분포, 거래 많은 단지 Top N, 평당가 높은 단지 Top N. Market snapshot for a district.
- `kr_subscription_competition`: [평소 $0.02/호출 — 현재 무료 모드] 청약 공고 1건의 상세: 주택형별 공급세대·분양가(최고가, 만원)·순위/거주지역별 접수건수와 경쟁률·특별공급 신청현황·당첨가점(최저/최고/평균). houseManageNo를 모르면 name으로 검색해 단일 공고일 때만 진행. Competition rates and prices for one subscription notice.
- `kr_subscription_search`: [평소 $0.01/호출 — 현재 무료 모드] APT 청약(분양) 공고를 지역·공고일 기간·단지명으로 검색한다. 접수 일정(특별공급/1·2순위), 공급세대, 당첨자 발표, 계약, 입주예정, 시공사, 규제지역·분양가상한제 플래그, 공고 URL 포함. 기본 기간: 최근 90일 공고. Search apartment subscription notices.