This project, tae0y/real-estate-mcp, provides a suite of tools for querying comprehensive Korean real estate data, including apartment prices, rents, subscriptions, and auction results, powered by MOLIT's open API. It enables users, particularly via AI assistants like Claude, to easily access and analyze complex Korean property market information.

How It Works

The system exposes over 14 distinct tools for querying specific real estate data categories from Korean government sources (MOLIT, Onbid, Cheongyakhome) via their open APIs. Designed for AI integration, it translates natural language queries into data retrieval operations, simplifying complex data access.

Quick Start & Requirements

The primary quick-start method involves integrating with Claude Desktop. After cloning the repository, users must configure claude_desktop_config.json with the server command and a DATA_GO_KR_API_KEY. Restarting Claude Desktop activates the real-estate server.

Prerequisites

• uv API key from 공공데이터포털 (Public Data Portal).
• Subscriptions to specific 공공데이터포털 services (e.g., apartment sales/rentals, officetel, single-house, commercial, Onbid, Cheongyakhome).
• Python environment.
• Claude Desktop (for primary quick-start).

Detailed setup guides for other clients (Claude Web, CLI, ChatGPT, Docker) are available in the docs/ directory.

Highlighted Details

• Offers 14+ tools for apartment, officetel, villa, single-house, commercial trade/rent, subscriptions, and public auction data.
• Integrates with multiple AI clients including Claude Desktop, Web, CLI, Codex CLI, and ChatGPT.
• Includes lookup tools for region codes and Onbid auction item details.

Maintenance & Community

The project acknowledges contributors and offers a "buy me a coffee" link. Specific community channels are not detailed in the provided README excerpt.

Licensing & Compatibility

The license type and compatibility notes for commercial use or closed-source linking are not explicitly stated in the provided README excerpt.

Limitations & Caveats

Onbid public auction bid results and item lookup are marked as Work In Progress (WIP). Obtaining the necessary API keys and subscribing to multiple specific Korean government data services presents a significant setup hurdle, particularly for users unfamiliar with the ecosystem.