Korea Real Estate MCP

English | 한국어

Ask Claude about Korean apartment prices — powered by MOLIT's open API. Provides 14+ tools for querying apartment, officetel, villa, single-house, and commercial trade/rent data, apartment subscriptions, and public auctions.

Supported Tools

• Apartment trade / rent (get_apartment_trades, get_apartment_rent)
• Officetel trade / rent (get_officetel_trades, get_officetel_rent)
• Villa / multi-family housing trade / rent (get_villa_trades, get_villa_rent)
• Single-house / multi-household trade / rent (get_single_house_trades, get_single_house_rent)
• Commercial building trades (get_commercial_trade)
• Apartment subscription notices / results (get_apt_subscription_info, get_apt_subscription_results)
• Onbid public auction bid results (get_public_auction_items, get_public_auction_item_detail) / ⚠️ WIP
• Onbid item lookup (get_onbid_thing_info_list) / ⚠️ WIP
• Onbid code / address lookup (get_onbid_*_code_info, get_onbid_addr*_info)
• Region code lookup (get_region_code)

Prerequisites

• uv
• API key from 공공데이터포털 — apply for the services below:
  • 국토교통부_아파트 매매 실거래가 자료
  • 국토교통부_아파트 전월세 자료
  • 국토교통부_오피스텔 매매 신고 자료
  • 국토교통부_오피스텔 전월세 자료
  • 국토교통부_연립다세대 매매 실거래가 자료
  • 국토교통부_연립다세대 전월세 실거래가 자료
  • 국토교통부_단독/다가구 매매 실거래가 자료
  • 국토교통부_단독/다가구 전월세 자료
  • 국토교통부_상업업무용 부동산 매매 신고 자료
  • 한국자산관리공사_온비드 코드 조회서비스
  • 한국자산관리공사_온비드 물건 정보 조회서비스
  • 한국자산관리공사_차세대 온비드 물건 입찰결과목록 조회서비스
  • 한국자산관리공사_차세대 온비드 물건 입찰결과상세 조회서비스
  • 한국부동산원_청약홈_APT 분양정보
  • 한국부동산원_청약홈 청약 신청·당첨자 정보 조회 서비스

For parsing API specs in hwp or docx format, see Common Utils Guide

Quick Start: Claude Desktop (stdio)

The fastest way to get started — the server runs as a child process of Claude Desktop.

1. Clone this repository locally.

   git clone <repository_url>
   cd real-estate-mcp

2. Open the Claude Desktop config file.

   # macOS
   open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

   # Windows
   notepad %APPDATA%\Claude\claude_desktop_config.json

3. Add the entry below under mcpServers.

   {
     "mcpServers": {
       "real-estate": {
         "command": "uv",
         "args": [
           "run",
           "--directory", "/path/to/real-estate-mcp",
           "python", "src/real_estate/mcp_server/server.py"
         ],
         "env": {
           "DATA_GO_KR_API_KEY": "your_api_key_here"
         }
       }
     }
   }

4. Restart Claude Desktop. Setup is complete when you can see the real-estate server in the tool list.

5. For better responses, create a Project in Claude Desktop and paste resources/custom-instructions-ko.md into the Project Instructions tab.

Connect with Other Clients

For HTTP mode, other clients, or per-service API key configuration, see the docs below.

Client	Transport	Guide
Claude Desktop	stdio / HTTP	docs/setup-claude-desktop.md
Claude (web)	HTTP only	docs/setup-claude-web.md
Claude CLI	stdio / HTTP	docs/setup-claude-cli.md
Codex CLI	stdio / HTTP	docs/setup-codex-cli.md
ChatGPT (web)	HTTP only	docs/setup-chatgpt-web.md
Docker (HTTP + Caddy)	HTTP	docs/setup-docker.md
OAuth (public access)	—	docs/setup-oauth.md

Contributors

This project exists thanks to all the people who contribute. [Contributing]

Made with contrib.rocks.

Support

If you find this project useful, buy me a coffee!