How do I use korea-realestate-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@korea-realestate-mcp Show me recent apartment sale prices in Gangnam" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

korea-realestate-mcp

by ohkyuetaek

Overview Schema Source Related Servers Discussions Admin

Python

Remote

korea-realestate-mcp

한국 부동산(아파트) 실거래가 조회 및 분석을 위한 MCP(Model Context Protocol) 서버입니다.

AI 에이전트(Claude Desktop, Cursor, Claude Code 등)에서 자연어로 아파트 매매/전월세 시세를 조회하고 분석할 수 있습니다.

한국 부동산 데이터를 제공하는 최초의 MCP 서버입니다.

제공 도구

도구	설명
`realestate_search_apt_trade`	아파트 매매 실거래가 조회
`realestate_search_apt_rent`	아파트 전월세 실거래가 조회
`realestate_get_region_code`	지역명 → 법정동 코드 조회 (퍼지 매칭)
`realestate_analyze_price_trend`	시세 추이 분석 (월별 통계, 변동률)
`realestate_compare_regions`	2~5개 지역 시세 비교
`realestate_analyze_rent_ratio`	매매가 대비 전세가율 분석
`realestate_get_apt_summary`	특정 아파트 단지 종합 요약

Related MCP server: MOLIT Real Estate Transactions MCP Server

설치

uvx (권장)

uvx korea-realestate-mcp

pip

pip install korea-realestate-mcp

설정

1. API 키 발급

공공데이터포털에서 회원가입 후 아래 API의 활용 신청을 합니다:

국토교통부_아파트매매 실거래자료 (링크)
국토교통부_아파트 전월세 자료 (링크)

신청 즉시 승인되며, 마이페이지에서 **서비스 키(Decoding)**를 복사합니다.

2. Claude Desktop 설정

claude_desktop_config.json에 아래를 추가합니다:

{
  "mcpServers": {
    "korea-realestate": {
      "command": "uvx",
      "args": ["korea-realestate-mcp"],
      "env": {
        "PUBLIC_DATA_API_KEY": "<발급받은 서비스 키>"
      }
    }
  }
}

3. Claude Code 설정

export PUBLIC_DATA_API_KEY="<발급받은 서비스 키>"
claude mcp add korea-realestate -- uvx korea-realestate-mcp

사용 시나리오

1. 아파트 시세 조회

"강남구 아파트 최근 시세 알려줘"

realestate_search_apt_trade가 호출되어 최근 거래 내역을 Markdown 테이블로 반환합니다.

2. 특정 단지 시세 추이

"래미안대치팰리스 84㎡ 최근 1년 시세 추이 보여줘"

realestate_analyze_price_trend가 월별 평균가, 변동률, 거래량을 분석합니다.

3. 지역 비교

"분당 vs 일산 아파트 가격 비교해줘"

realestate_compare_regions가 지역별 평균가, 중앙값, ㎡당 단가를 비교합니다.

4. 전세가율 분석

"분당 전세가율 어때?"

realestate_analyze_rent_ratio가 매매가 대비 전세가율과 갭투자 금액을 산출합니다.

5. 단지 종합 정보

"판교 힐스테이트 종합 정보"

realestate_get_apt_summary가 최근 거래, 면적대별 시세, 전세가율을 요약합니다.

데이터 출처

기술 스택

Python 3.10+
FastMCP (MCP Python SDK)
httpx (비동기 HTTP)
SQLite 캐시 (aiosqlite)
pandas (데이터 분석)

라이선스

MIT

Available Tools

7 tools

realestate_analyze_price_trendA

Read-onlyIdempotent

특정 지역 또는 아파트 단지의 시세 추이를 분석한다.

Args:
    region: 지역명
    start_year_month: 분석 시작 "202301"
    end_year_month: 분석 종료 "202412"
    apt_name: 특정 단지 필터
    area_range: 면적대 필터 "59-84" (㎡ 범위)
    response_format: "markdown" (기본) 또는 "json"

Inputs: region (required), end_year_month (required), start_year_month (required), apt_name, +2 more. Returns: result

realestate_analyze_rent_ratioA

Read-onlyIdempotent

매매가 대비 전세가율을 분석한다.

Args:
    region: 지역명
    year_month: 분석 기준 년월
    apt_name: 특정 단지 필터
    response_format: "markdown" (기본) 또는 "json"

Inputs: region (required), year_month (required), apt_name, response_format. Returns: result

realestate_compare_regionsA

Read-onlyIdempotent

2개 이상 지역의 시세를 비교 분석한다.

Args:
    regions: 비교할 지역명 목록 (최소 2, 최대 5)
    year_month: 비교 기준 년월
    area_range: 면적대 필터 "59-84"
    response_format: "markdown" (기본) 또는 "json"

Inputs: regions (required), year_month (required), area_range, response_format. Returns: result

realestate_get_apt_summaryA

Read-onlyIdempotent

특정 아파트 단지의 종합 요약 정보를 제공한다.

Args:
    region: 지역명
    apt_name: 아파트명
    months: 최근 N개월 조회 (기본 6, 최대 24)
    response_format: "markdown" (기본) 또는 "json"

Inputs: region (required), apt_name (required), months, response_format. Returns: result

realestate_get_region_codeA

Read-onlyIdempotent

지역명으로 법정동 코드를 조회한다. 퍼지 매칭 지원.

Args:
    query: 지역명 검색어 (예: "분당", "강남", "수원 영통")

Inputs: query (required). Returns: result

realestate_search_apt_rentA

Read-onlyIdempotent

특정 지역·기간의 아파트 전월세 실거래가를 조회한다.

Args:
    region: 지역명 (예: "강남구", "분당구", "서울 송파구")
    year_month: 특정 년월 "202401"
    start_year_month: 기간 시작 "202301"
    end_year_month: 기간 종료 "202312"
    apt_name: 아파트명 필터 (부분 매칭)
    min_area: 최소 전용면적(㎡)
    max_area: 최대 전용면적(㎡)
    rent_type: "전세" | "월세" | "전체"(기본)
    response_format: "markdown" (기본) 또는 "json"

Inputs: region (required), apt_name, max_area, min_area, +5 more. Returns: result

realestate_search_apt_tradeA

Read-onlyIdempotent

특정 지역·기간의 아파트 매매 실거래가를 조회한다.

Args:
    region: 지역명 (예: "강남구", "분당구", "서울 송파구")
    year_month: 특정 년월 "202401" (year_month 또는 start/end 중 하나 필수)
    start_year_month: 기간 시작 "202301"
    end_year_month: 기간 종료 "202312"
    apt_name: 아파트명 필터 (부분 매칭)
    min_area: 최소 전용면적(㎡)
    max_area: 최대 전용면적(㎡)
    response_format: "markdown" (기본) 또는 "json"

Inputs: region (required), apt_name, max_area, min_area, +4 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

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

TDQS

A4/5.0

Scored 2026-08-02 14:00 across 7 tools

Disambiguation4/5

Each tool has a clear, distinct purpose: region code lookup, trade price search, rent price search, trend analysis, region comparison, rent ratio analysis, and apartment summary. The analysis tools (trend, compare, ratio) might seem similar but operate on different dimensions (time, regions, sale-vs-rent), so confusion is unlikely with the given descriptions.

Naming Consistency5/5

All tools follow a consistent 'realestate_' prefix followed by a verb_noun pattern (e.g., search_apt_trade, analyze_price_trend, compare_regions). This is uniform and predictable, making it easy for an agent to infer tool behavior from names.

Tool Count5/5

Seven tools is well-scoped for a real estate data and analysis MCP server. Each tool covers a distinct core function without redundancy, and the count is within the ideal range for a focused domain.

Completeness4/5

The server covers the core life cycle of real estate price lookup: region code resolution, raw transaction search (trade/rent), analytical tools (trend, comparison, rent ratio), and a summary endpoint. A minor gap is the lack of a dedicated tool to list all apartments in a region, but that can be inferred from search results, so it's not a dead end.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Reevl — Korean Real EstateA
kr.co.reevl
Korean apartment data: official transaction prices, jeonse ratios, AI forecasts. 45,000+ complexes.
Real Estate Open Data
71
https://reevl.co.kr/api/mcp
kr-groundtruthA
io.github.ChloePark85
Korean fact-verification tools for AI agents: business registration, address, DART, apt prices, laws
Government Data Open Data Search
81
https://kr-groundtruth-mcp.vercel.app/api/mcp
kr-apt-trades
io.github.HyosikPark
Official Korean apartment sale prices (MOLIT). Clean JSON, data global models cannot know — paid pe…
Real Estate Government Data Open Data
1
https://hawker-gateway.fly.dev/mcp/kr-apt-trades
리치고 부동산 (Richgo)A
ai.richgo.m
Korean apartment prices, trades, forecasts, tax, school districts, redevelopment, court auctions
Real Estate Finance Government Data
151
https://m.richgo.ai/api/mcp

Related MCP Servers

realestate-mcp
Real Estate Open Data
kimju1416
A
license
Not graded
quality
C
maintenance
Enables querying Korean apartment sales and rental transaction data from the public data portal through natural language, with tools for searching transactions and computing price statistics.
Updated a month ago (2026-10-04 19:54 UTC)
25 npm
MIT
MOLIT Real Estate Transactions
Real Estate Open Data
jeon3709-dev
F
license
Not graded
quality
F
maintenance
Enables natural language queries to retrieve Korean real estate transaction data (land, commercial, apartments) from the public API, returning structured tables and summary statistics.
Updated 2 months ago (2026-09-30 04:58 UTC)
-
naver-land-mcp
Real Estate Finance
kimju1416
A
license
A
quality
C
maintenance
Enables searching Korean apartment listings, market prices, and recent transactions via Naver Real Estate through natural language.
Updated 18 days ago (2026-10-29 07:39 UTC)
2
6
MIT
Reevl MCP
Real Estate Open Data
exclusiveyon-a11y
A
license
Not graded
quality
B
maintenance
Enables AI assistants to query Korean apartment real-estate data, including official transaction prices, jeonse ratios, and AI price forecasts for 45,000+ complexes.
Updated 2 months ago (2026-09-05 05:25 UTC)
1
MIT

korea-realestate-mcp

제공 도구

설치

uvx (권장)

pip

설정

1. API 키 발급

2. Claude Desktop 설정

3. Claude Code 설정

사용 시나리오

1. 아파트 시세 조회

2. 특정 단지 시세 추이

3. 지역 비교

4. 전세가율 분석

5. 단지 종합 정보

데이터 출처

기술 스택

라이선스

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

realestate-mcp

MOLIT Real Estate Transactions

naver-land-mcp

Reevl MCP