realestate-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@realestate-mcp 서울 강남구 아파트 매매 실거래가 2024년 5월 조회해줘"
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.
⚠️ Service Termination Notice This MCP server ended its fly.io deployment as of 2026-08-23. The code remains in the repository for development reference.
realestate-mcp
A server that provides the Ministry of Land, Infrastructure and Transport's actual transaction price public data (data.go.kr) as MCP tools. It queries actual transaction prices for sales and jeonse/monthly rent of apartments/multi-family housing/single-family and multi-family homes/officetels by region code + contract year-month.
Provided Tools (8)
Tool name | Description |
| Apartment sales actual transaction prices |
| Apartment jeonse/monthly rent actual transaction prices |
| Single-family/multi-family home sales actual transaction prices |
| Single-family/multi-family home jeonse/monthly rent actual transaction prices |
| Multi-family housing sales actual transaction prices |
| Multi-family housing jeonse/monthly rent actual transaction prices |
| Officetel sales actual transaction prices |
| Officetel jeonse/monthly rent actual transaction prices |
Common inputs: regionCode (first 5 digits of the legal dong code, e.g., Seoul Jongno-gu 11110), dealYearMonth (YYYYMM),
pageNo (optional), numOfRows (optional, default 10)
Related MCP server: realestate-mcp
Deployment
Deployed as an HTTP (streamable) MCP server on Fly.io: https://realestate-mcp-hlucent.fly.dev/mcp
Since the server uses its own data.go.kr authentication key, you can connect directly to the above address without a separate ?key= parameter. (The previous ?key=your_authentication_key method is no longer used.)
A rate limit is applied to prevent excessive calls from the same IP (3 times per minute, 429 if exceeding 30 times per 24 hours). This does not interfere with normal interactive use.
Local Development
npm install
cp .env.example .env # DATA_GO_KR_SERVICE_KEY 입력 (서버가 사용할 자체 인증키)
npm run dev # http://localhost:8080/mcpIn the deployment environment, DATA_GO_KR_SERVICE_KEY is injected via Fly secrets
(fly secrets set DATA_GO_KR_SERVICE_KEY=...). It is never hardcoded in the code.
Documentation
Architecture/design:
docs/ARCHITECTURE.mdDetailed spec summary by API:
docs/api-spec/Development log (auto-generated):
docs/devlog/
Development Reference
When working with Claude Code, read CLAUDE.md first. It contains work rules for saving tokens.
Available Tools
8 toolsget_apt_rentB
아파트 전월세 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_apt_tradeC
아파트 매매 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_offi_rentC
오피스텔 전월세 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_offi_tradeB
오피스텔 매매 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_rh_rentA
연립다세대 전월세 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_rh_tradeB
연립다세대 매매 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_sh_rentA
단독/다가구 전월세 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
get_sh_tradeB
단독/다가구 매매 실거래가 조회 (지역코드+계약년월)
Inputs: regionCode (required), dealYearMonth (required), pageNo, numOfRows.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool uniquely combines a property type (office, apartment, single/detached, row house) with a transaction type (trade or rent), resulting in 8 mutually exclusive purposes. No two tools overlap in function.
All tools follow an identical get_<property_type>_<transaction_type> pattern with consistent snake_case. Property abbreviations are uniformly used across trade and rent variants, and transaction terms are consistent.
The server uses 8 tools, which is well-scoped for a real estate price lookup service covering four property types and two transaction types. Each tool represents a distinct and necessary query combination.
The tool set comprehensively covers the main property types (apartment, office, single/detached, row house) and both major transaction types (sale and rent/lease). No obvious gaps exist in the stated domain of real estate transaction price lookup.
Maintenance
Related MCP Connectors
Korean apartment and housing sale/rent records (MOLIT) by natural-language address. No key.
Official Korean apartment sale prices (MOLIT). Clean JSON, data global models cannot know — paid pe…
Seoul Open Data MCP — city data for Seoul via the Seoul Open Data Plaza API (openapi.seoul.go.kr).…
Korean business, bid and real-estate analytics, parcel, building register and simple-auth data
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables querying and searching for real estate listings, complexes, prices, and school information from Naver Land (Korean real estate platform) through a set of MCP tools. Supports region hierarchy navigation, coordinate-based search, and various trade types like sale, jeonse, and monthly rent.92-
- AlicenseNot gradedqualityCmaintenanceEnables 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.19 npmMIT
- FlicenseNot gradedqualityFmaintenanceEnables natural language queries to retrieve Korean real estate transaction data (land, commercial, apartments) from the public API, returning structured tables and summary statistics.-
- AlicenseNot gradedqualityBmaintenanceEnables natural-language queries about Korean addresses and apartment complexes to retrieve official MOLIT transaction records, including sales, jeonse, monthly rent, period statistics, monthly trends, and exclusive-area filters. It requires no API key and supports ambiguous-location candidate resolution.MIT