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

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: naver-land-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

• Architecture/design: docs/ARCHITECTURE.md

• Detailed 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.