Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tae0y--real-estate-mcp/badge.svg)](/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

i

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)

  1. # Korea Real Estate MCP
  2. [English](README.md) | [ํ•œ๊ตญ์–ด](README-ko.md)
  3. 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.
  4. Provides 14+ tools for live transaction data and financial calculations โ€” apartment, officetel, villa, single-house, and commercial.
  5. ## Supported Tools
  6. - [x] Apartment trade / rent (`get_apartment_trades`, `get_apartment_rent`)
  7. - [x] Officetel trade / rent (`get_officetel_trades`, `get_officetel_rent`)
  8. - [x] Villa / multi-family housing trade / rent (`get_villa_trades`, `get_villa_rent`)
  9. - [x] Single-house / multi-household trade / rent (`get_single_house_trades`, `get_single_house_rent`)
  10. - [x] Commercial building trades (`get_commercial_trade`)
  11. - [x] Apartment subscription notices / results (`get_apt_subscription_info`, `get_apt_subscription_results`)
  12. - [x] Region code lookup (`get_region_code`)
  13. ## Prerequisites
  14. - [uv](https://docs.astral.sh/uv/getting-started/installation/)
  15. - API key from [๊ณต๊ณต๋ฐ์ดํ„ฐํฌํ„ธ](https://www.data.go.kr) โ€” apply for the services below:
  16. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์•„ํŒŒํŠธ ๋งค๋งค ์‹ค๊ฑฐ๋ž˜๊ฐ€ ์ž๋ฃŒ](https://www.data.go.kr/data/15126469/openapi.do)
  17. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์•„ํŒŒํŠธ ์ „์›”์„ธ ์ž๋ฃŒ](https://www.data.go.kr/data/15126474/openapi.do)
  18. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์˜คํ”ผ์Šคํ…” ๋งค๋งค ์‹ ๊ณ  ์ž๋ฃŒ](https://www.data.go.kr/data/15126464/openapi.do)
  19. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์˜คํ”ผ์Šคํ…” ์ „์›”์„ธ ์ž๋ฃŒ](https://www.data.go.kr/data/15126475/openapi.do)
  20. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์—ฐ๋ฆฝ๋‹ค์„ธ๋Œ€ ๋งค๋งค ์‹ค๊ฑฐ๋ž˜๊ฐ€ ์ž๋ฃŒ](https://www.data.go.kr/data/15126467/openapi.do)
  21. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์—ฐ๋ฆฝ๋‹ค์„ธ๋Œ€ ์ „์›”์„ธ ์‹ค๊ฑฐ๋ž˜๊ฐ€ ์ž๋ฃŒ](https://www.data.go.kr/data/15126473/openapi.do)
  22. - [๊ตญํ† ๊ตํ†ต๋ถ€\_๋‹จ๋…/๋‹ค๊ฐ€๊ตฌ ๋งค๋งค ์‹ค๊ฑฐ๋ž˜๊ฐ€ ์ž๋ฃŒ](https://www.data.go.kr/data/15126465/openapi.do)
  23. - [๊ตญํ† ๊ตํ†ต๋ถ€\_๋‹จ๋…/๋‹ค๊ฐ€๊ตฌ ์ „์›”์„ธ ์ž๋ฃŒ](https://www.data.go.kr/data/15126472/openapi.do)
  24. - [๊ตญํ† ๊ตํ†ต๋ถ€\_์ƒ์—…์—…๋ฌด์šฉ ๋ถ€๋™์‚ฐ ๋งค๋งค ์‹ ๊ณ  ์ž๋ฃŒ](https://www.data.go.kr/data/15126463/openapi.do)
  25. - [ํ•œ๊ตญ๋ถ€๋™์‚ฐ์›_์ฒญ์•ฝํ™ˆ_APT ๋ถ„์–‘์ •๋ณด](https://www.data.go.kr/data/15101046/fileData.do)
  26. - [ํ•œ๊ตญ๋ถ€๋™์‚ฐ์›_์ฒญ์•ฝํ™ˆ ์ฒญ์•ฝ ์‹ ์ฒญยท๋‹น์ฒจ์ž ์ •๋ณด ์กฐํšŒ ์„œ๋น„์Šค](https://www.data.go.kr/data/15110812/openapi.do)
  27. > For parsing API specs in hwp or docx format, see [Common Utils Guide](docs/guide-common-utils.md)
  28. ## Quick Start: Claude Desktop (stdio)
  29. The fastest way to get started โ€” the server runs as a child process of Claude Desktop.
  30. 1. Clone this repository locally.
  31. ```bash
  32. git clone <repository_url>
  33. cd real-estate-mcp
  34. ```
  35. 1. Open the Claude Desktop config file.
  36. ```bash
  37. # macOS
  38. open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
  39. ```
  40. ```powershell
  41. # Windows
  42. notepad %APPDATA%\Claude\claude_desktop_config.json
  43. ```
  44. 1. Add the entry below under `mcpServers`.
  45. ```json
  46. {
  47. "mcpServers": {
  48. "real-estate": {
  49. "command": "uv",
  50. "args": [
  51. "run",
  52. "--directory", "/path/to/real-estate-mcp",
  53. "python", "src/real_estate/mcp_server/server.py"
  54. ],
  55. "env": {
  56. "DATA_GO_KR_API_KEY": "your_api_key_here"
  57. }
  58. }
  59. }
  60. }
  61. ```
  62. 1. Restart Claude Desktop.
  63. Setup is complete when you can see the `real-estate` server in the tool list.
  64. 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.
  65. ## Connect with Other Clients
  66. For other clients, transport options, or per-service API key configuration, see the docs below.
  67. | Guide | Transport | Clients |
  68. |-------|-----------|---------|
  69. | [docs/setup-prerequisites.md](docs/setup-prerequisites.md) | โ€” | All clients |
  70. | [docs/setup-with-stdio.md](docs/setup-with-stdio.md) | stdio / local HTTP | Claude Desktop, Claude CLI, Codex CLI |
  71. | [docs/setup-with-http.md](docs/setup-with-http.md) | HTTP (remote) | Claude (web), Claude CLI, Codex CLI |
  72. | [docs/setup-reverse-proxy.md](docs/setup-reverse-proxy.md) | โ€” | Server-side proxy setup (Cloudflare Tunnel) |
  73. ## Contributors
  74. This project exists thanks to all the people who contribute. [[Contributing](https://github.com/tae0y/real-estate-mcp/blob/main/CONTRIBUTING.md)]
  75. <a href="https://github.com/tae0y/real-estate-mcp/graphs/contributors">
  76. <img src="https://contrib.rocks/image?repo=tae0y/real-estate-mcp" />
  77. </a>
  78. Made with [contrib.rocks](https://contrib.rocks).
  79. ## Support
  80. If you find this project useful, buy me a coffee!
  81. <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 in

Free to use. If itโ€™s helped, pass it on.