korea-realty

# korea-realty — Korean Real Estate Data MCP Server

Give your AI real Korean real estate data. Court auctions, 10M+ official transaction
records (MOLIT), apartment complex reports, and price prediction — served as an MCP
server that works with Claude, Cursor, ChatGPT, and any MCP-capable client.

**Remote endpoint (no install, no signup):**

```
https://realty.sallim.app/mcp
```

Listed in the official MCP registry as `app.sallim/korea-realty`.

## Why

Ask an AI "반포자이 최근 6개월 실거래 추이 보여줘" and it normally answers from stale
training data. With this server attached, the AI queries the actual data and answers
with evidence: real transaction records, court auction filings, complex-level price
history.

- **Data honesty first** — every response discloses its data vintage (`data_as_of`),
  aggregation windows, and known coverage limits. Tools refuse to fabricate: unknown
  complex → `not_found`, ambiguous region → candidates are surfaced, stale sources →
  explicit warnings.
- **Korean market domain rules built in** — pyeong conversions (supply vs exclusive
  area), region-name disambiguation (six districts named 중구 exist), auction failure
  histories decoded from court codes.

## Quickstart

### Claude Code

```bash
claude mcp add --transport http korea-realty https://realty.sallim.app/mcp
```

### Claude Desktop / Cursor (mcp.json)

```json
{
  "mcpServers": {
    "korea-realty": {
      "type": "http",
      "url": "https://realty.sallim.app/mcp"
    }
  }
}
```

### ChatGPT

Add a custom connector with the URL `https://realty.sallim.app/mcp`.
(ChatGPT supports MCP connectors on paid plans only.)

## Free vs PRO

| | Free (no key) | PRO (API key) |
|---|---|---|
| Rate limit | 30 calls/day per IP | 500 calls/day per key |
| Court auctions — search, case detail, sale-rate stats (refreshed every 15 min) | ✅ | ✅ |
| Regional apartment price trends (MOLIT official records) | ✅ | ✅ |
| Complex price prediction (XGBoost, backtest scores disclosed in responses) | — | ✅ |
| Complex unified report (prices + jeonse + location) · region comparison | — | ✅ |
| Rental yield · station/school/hospital location analysis | — | ✅ |
| Investment risk score · unsold/market-sentiment signals · reconstruction screening | — | ✅ |

Pricing, purchase, and refund policy: **https://realty.sallim.app/mcp/pricing**

## Data sources

- MOLIT (Ministry of Land) official real-transaction records — public data, commercial
  use permitted; disclosure lag up to 30 days by reporting rules
- Korean court auction filings (refreshed every 15 minutes)
- Public data portal (data.go.kr) — demographics, presale, POI datasets

⚠️ **This service is an information tool built on public data, not investment advice.**
Price predictions and risk scores are statistical model outputs for reference; purchase
and sale decisions and their outcomes are the user's responsibility.

## Contact

sallimapp@gmail.com

---

## 한국어 안내

Claude·ChatGPT 같은 AI에 한국 부동산 실데이터를 연결하는 MCP 서버입니다.
국토부 실거래가 1,000만+ 건·법원경매(15분 주기 갱신)·단지 리포트·가격 예측을 제공합니다.

- **무료(키 불필요, IP당 하루 30회)**: 경매 물건 검색·사건 상세·낙찰가율 통계, 지역 실거래 시세 추이
- **PRO(키당 하루 500회)**: 단지 가격 예측·통합 리포트·지역 비교·수익률·입지 분석·투자위험·재건축 스크리닝

등록 주소는 `https://realty.sallim.app/mcp` 한 줄이면 됩니다(Claude Code·Claude Desktop·
Cursor·ChatGPT 커넥터 지원). 가격·구매·환불 정책: https://realty.sallim.app/mcp/pricing

본 서비스는 공공데이터 기반 정보 제공 도구이며 **투자 자문이 아닙니다**. 가격예측·위험점수는
통계 모델의 참고 지표이고, 매수·매도 판단과 결과는 이용자 책임입니다.