real-estate-mcp
๐ Ask Claude about Korean apartment prices โ powered by ๊ตญํ ๊ตํต๋ถ open API
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/tae0y--real-estate-mcp)HTML
<a href="/listings/tae0y--real-estate-mcp"><img src="/api/listings/tae0y--real-estate-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The fastest way to get started โ the server runs as a child process of Claude Desktop.
1. Clone this repository locally.
```bash git clone <repository_url> cd real-estate-mcp ```
1. Open the Claude Desktop config file.
```bash # macOS open "$HOME/Library/Application Support/Claude/claude_desktop_config.json" ```
```powershell # Windows notepad %APPDATA%\Claude\claude_desktop_config.json ```
1. Add the entry below under `mcpServers`.
```json { "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" } } } } ```
1. Restart Claude Desktop. Setup is complete when you can see the `real-estate` server in the tool list.
1. For better responses, create a **Project** in Claude Desktop and paste [resources/custom-instructions-ko.md](resources/custom-instructions-ko.md) into the **Project Instructions** tab.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md ยท README ยท 109 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Korea Real Estate MCP
- [English](README.md) | [ํ๊ตญ์ด](README-ko.md)
- Connect Claude to Korea's MOLIT real estate API and simulate **buy now / buy later / invest only** scenarios based on your income, savings, and retirement goals.
- Provides 14+ tools for live transaction data and financial calculations โ apartment, officetel, villa, single-house, and commercial.
- ## Supported Tools
- - [x] Apartment trade / rent (`get_apartment_trades`, `get_apartment_rent`)
- - [x] Officetel trade / rent (`get_officetel_trades`, `get_officetel_rent`)
- - [x] Villa / multi-family housing trade / rent (`get_villa_trades`, `get_villa_rent`)
- - [x] Single-house / multi-household trade / rent (`get_single_house_trades`, `get_single_house_rent`)
- - [x] Commercial building trades (`get_commercial_trade`)
- - [x] Apartment subscription notices / results (`get_apt_subscription_info`, `get_apt_subscription_results`)
- - [x] Region code lookup (`get_region_code`)
- ## Prerequisites
- - [uv](https://docs.astral.sh/uv/getting-started/installation/)
- - API key from [๊ณต๊ณต๋ฐ์ดํฐํฌํธ](https://www.data.go.kr) โ apply for the services below:
- - [๊ตญํ ๊ตํต๋ถ\_์ํํธ ๋งค๋งค ์ค๊ฑฐ๋๊ฐ ์๋ฃ](https://www.data.go.kr/data/15126469/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์ํํธ ์ ์์ธ ์๋ฃ](https://www.data.go.kr/data/15126474/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์คํผ์คํ ๋งค๋งค ์ ๊ณ ์๋ฃ](https://www.data.go.kr/data/15126464/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์คํผ์คํ ์ ์์ธ ์๋ฃ](https://www.data.go.kr/data/15126475/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์ฐ๋ฆฝ๋ค์ธ๋ ๋งค๋งค ์ค๊ฑฐ๋๊ฐ ์๋ฃ](https://www.data.go.kr/data/15126467/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์ฐ๋ฆฝ๋ค์ธ๋ ์ ์์ธ ์ค๊ฑฐ๋๊ฐ ์๋ฃ](https://www.data.go.kr/data/15126473/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_๋จ๋ /๋ค๊ฐ๊ตฌ ๋งค๋งค ์ค๊ฑฐ๋๊ฐ ์๋ฃ](https://www.data.go.kr/data/15126465/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_๋จ๋ /๋ค๊ฐ๊ตฌ ์ ์์ธ ์๋ฃ](https://www.data.go.kr/data/15126472/openapi.do)
- - [๊ตญํ ๊ตํต๋ถ\_์์ ์ ๋ฌด์ฉ ๋ถ๋์ฐ ๋งค๋งค ์ ๊ณ ์๋ฃ](https://www.data.go.kr/data/15126463/openapi.do)
- - [ํ๊ตญ๋ถ๋์ฐ์_์ฒญ์ฝํ_APT ๋ถ์์ ๋ณด](https://www.data.go.kr/data/15101046/fileData.do)
- - [ํ๊ตญ๋ถ๋์ฐ์_์ฒญ์ฝํ ์ฒญ์ฝ ์ ์ฒญยท๋น์ฒจ์ ์ ๋ณด ์กฐํ ์๋น์ค](https://www.data.go.kr/data/15110812/openapi.do)
- > For parsing API specs in hwp or docx format, see [Common Utils Guide](docs/guide-common-utils.md)
- ## 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.
- ```bash
- git clone <repository_url>
- cd real-estate-mcp
- ```
- 1. Open the Claude Desktop config file.
- ```bash
- # macOS
- open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
- ```
- ```powershell
- # Windows
- notepad %APPDATA%\Claude\claude_desktop_config.json
- ```
- 1. Add the entry below under `mcpServers`.
- ```json
- {
- "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"
- }
- }
- }
- }
- ```
- 1. Restart Claude Desktop.
- Setup is complete when you can see the `real-estate` server in the tool list.
- 1. For better responses, create a **Project** in Claude Desktop and paste [resources/custom-instructions-ko.md](resources/custom-instructions-ko.md) into the **Project Instructions** tab.
- ## Connect with Other Clients
- For other clients, transport options, or per-service API key configuration, see the docs below.
- | Guide | Transport | Clients |
- |-------|-----------|---------|
- | [docs/setup-prerequisites.md](docs/setup-prerequisites.md) | โ | All clients |
- | [docs/setup-with-stdio.md](docs/setup-with-stdio.md) | stdio / local HTTP | Claude Desktop, Claude CLI, Codex CLI |
- | [docs/setup-with-http.md](docs/setup-with-http.md) | HTTP (remote) | Claude (web), Claude CLI, Codex CLI |
- | [docs/setup-reverse-proxy.md](docs/setup-reverse-proxy.md) | โ | Server-side proxy setup (Cloudflare Tunnel) |
- ## Contributors
- This project exists thanks to all the people who contribute. [[Contributing](https://github.com/tae0y/real-estate-mcp/blob/main/CONTRIBUTING.md)]
- <a href="https://github.com/tae0y/real-estate-mcp/graphs/contributors">
- <img src="https://contrib.rocks/image?repo=tae0y/real-estate-mcp" />
- </a>
- Made with [contrib.rocks](https://contrib.rocks).
- ## Support
- If you find this project useful, buy me a coffee!
- <a href="https://www.buymeacoffee.com/tae0y" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itโs helped, pass it on.