Skip to main content
Glama
realestate-mcp
by hlucent

⚠️ 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

get_apt_trade

Apartment sales actual transaction prices

get_apt_rent

Apartment jeonse/monthly rent actual transaction prices

get_sh_trade

Single-family/multi-family home sales actual transaction prices

get_sh_rent

Single-family/multi-family home jeonse/monthly rent actual transaction prices

get_rh_trade

Multi-family housing sales actual transaction prices

get_rh_rent

Multi-family housing jeonse/monthly rent actual transaction prices

get_offi_trade

Officetel sales actual transaction prices

get_offi_rent

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/mcp

In 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

Development Reference

When working with Claude Code, read CLAUDE.md first. It contains work rules for saving tokens.

Available Tools

8 tools
get_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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables 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.
      9
      2
      -
    • 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.
      19 npm
      MIT
    • 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.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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