Real Estate

v1.0.0β€’Analyticsβ€’stable

🏠 Ask Claude about Korean apartment prices β€” powered by ꡭ토ꡐ톡뢀 open API

claudekoreamcpopenapireal-estate
Share:
348
Stars
0
Downloads
0
Weekly
0/5

What is Real Estate?

Real Estate is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🏠 ask claude about korean apartment prices β€” powered by ꡭ토ꡐ톡뢀 open api

🏠 Ask Claude about Korean apartment prices β€” powered by ꡭ토ꡐ톡뢀 open API

This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 🏠 Ask Claude about Korean apartment prices β€” powered by ꡭ토ꡐ톡

Use Cases

Query Korean apartment prices.
Analyze real estate data.
Access government real estate APIs.
tae0y

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx real-estate

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Real Estate

The Real Estate MCP server connects AI assistants to South Korea's public real estate data portal (곡곡데이터포털 / data.go.kr), enabling Claude to query apartment, officetel, villa, single-house, and commercial property transaction and rental prices across the country. It covers 14 or more datasets sourced from the Ministry of Land, Infrastructure and Transport (ꡭ토ꡐ톡뢀) and provides region-code lookup to make searches precise. Analysts, home buyers, and real estate professionals in Korea use it to ask plain-language questions about market prices and get answers backed by authoritative government data.

Prerequisites

  • Python 3.10 or newer
  • uv package manager installed (see https://docs.astral.sh/uv/getting-started/installation/)
  • A free API key from data.go.kr (Korea Public Data Portal) β€” register and request access to the real estate transaction datasets
  • An MCP client such as Claude Desktop
1

Clone the repository

Clone the real-estate-mcp project to your local machine.

git clone https://github.com/tae0y/real-estate-mcp.git
cd real-estate-mcp
2

Obtain a data.go.kr API key

Register at https://www.data.go.kr and request access to the apartment trade and rental APIs from the Ministry of Land, Infrastructure and Transport. Copy the issued service key β€” this is your DATA_GO_KR_API_KEY.

3

Install dependencies with uv

Use uv to install the Python dependencies defined in the project. This also creates a virtual environment automatically.

uv sync
4

Test the server locally

Run the MCP server directly to verify it starts without errors. Pass the API key as an environment variable.

DATA_GO_KR_API_KEY=your_api_key_here uv run python src/real_estate/mcp_server/server.py
5

Add the server to Claude Desktop configuration

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add the real-estate MCP server entry with your absolute path and API key.

{
  "mcpServers": {
    "real-estate": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/real-estate-mcp",
        "python",
        "src/real_estate/mcp_server/server.py"
      ],
      "env": {
        "DATA_GO_KR_API_KEY": "your_api_key_here"
      }
    }
  }
}
6

Restart Claude Desktop

Save the config file and restart Claude Desktop. The real-estate tools will become available and you can start querying Korean property prices.

Real Estate Examples

Client configuration

Full Claude Desktop config entry for the real-estate MCP server. Replace the directory path and API key with your actual values.

{
  "mcpServers": {
    "real-estate": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/yourname/real-estate-mcp",
        "python",
        "src/real_estate/mcp_server/server.py"
      ],
      "env": {
        "DATA_GO_KR_API_KEY": "your_data_go_kr_service_key"
      }
    }
  }
}

Prompts to try

Ask Claude questions about Korean real estate after the server is connected.

- "What were the average apartment trade prices in Gangnam-gu last month?"
- "Show me officetel rental prices in Mapo-gu for units under 50 square meters"
- "Look up the region code for Seongdong-gu and then find recent villa transactions"
- "Compare apartment prices between Bundang and Pangyo over the last 6 months"
- "What is the trend in single-house purchase prices in Jeju for this year?"

Troubleshooting Real Estate

API returns authentication error or empty results

Ensure the DATA_GO_KR_API_KEY value is the URL-decoded service key from data.go.kr. Some keys are URL-encoded and need to be decoded before use. Also confirm you have been approved for the specific dataset you are querying.

uv: command not found

Install uv following the official guide at https://docs.astral.sh/uv/getting-started/installation/. On macOS/Linux: 'curl -LsSf https://astral.sh/uv/install.sh | sh', then restart your terminal.

Server starts but no tools appear in Claude Desktop

Verify that the --directory argument points to the absolute path of the cloned repository and that server.py exists at src/real_estate/mcp_server/server.py. Check Claude Desktop logs for import errors.

Frequently Asked Questions about Real Estate

What is Real Estate?

Real Estate is a Model Context Protocol (MCP) server that 🏠 ask claude about korean apartment prices β€” powered by ꡭ토ꡐ톡뢀 open api It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Real Estate?

Follow the installation instructions on the Real Estate GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Real Estate?

Real Estate works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Real Estate free to use?

Yes, Real Estate is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Real Estate Alternatives β€” Similar Analytics Servers

Looking for alternatives to Real Estate? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "real-estate": { "command": "npx", "args": ["-y", "real-estate"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide β†’

Ready to use Real Estate?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides