# Korea Real Estate

> Korea Real Estate is an open-source MCP server for analytics and data. Query South Korea's official real-estate transactions and compute jeonse ratios. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/hall7024/korea-realestate-mcp
- **MCP Registry name:** io.github.hall7024/korea-realestate-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

Built on the Ministry of Land, Infrastructure and Transport's transaction data via data.go.kr, this server covers 13 datasets: apartments, row houses, detached houses, officetels, presale rights, commercial property, land and factories or warehouses. Every answer ends with the source and query time, and the exclusions behind each number are printed (cancelled deals, direct family-style sales, area tolerance, sample size and a confidence rating).

It guards against silent failures. The upstream API returns zero results without error for wrong, future or retired region codes, so inputs are validated first, and the 2026 administrative reorganisation is mapped to new codes. A doctor command checks which dataset subscriptions your key is missing.

You need a free data.go.kr service key set as DATA_GO_KR_SERVICE_KEY. The package also ships a CLI and a TypeScript library, is MIT licensed, and states results are reference data rather than advice.

## Features

- **13 transaction datasets:** Sales and rentals for apartments, villas, officetels and more, plus land and commercial.
- **Jeonse ratio analysis:** Estimates lease price against sale price, with quartiles and a confidence level.
- **Region resolution:** Maps names, legal-dong codes and old names to the codes the API accepts.
- **Doctor command:** Reports which dataset subscriptions are active for your key.
- **Key kept out of output:** Errors and logs mask the service key, which travels in the URL query.

## Good for

- Ask what a 84 square-metre flat in a given complex sells for
- Check whether a proposed jeonse deposit is high against local sales
- Pull recent transactions for a district
- Research price trends by month for a neighbourhood

## Install

### Claude Code (Terminal)

```sh
claude mcp add korea-realestate-mcp --env DATA_GO_KR_SERVICE_KEY='<DATA_GO_KR_SERVICE_KEY>' -- npx -y korea-realestate-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "korea-realestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-realestate-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "korea-realestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-realestate-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "korea-realestate-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "korea-realestate-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "korea-realestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-realestate-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "korea-realestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-realestate-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

## Tools

- `resolve_region`: Turns a place name into district codes and legal-dong names.
- `search_deals`: Returns raw transactions across the 13 datasets, newest first (up to 50, 24 months).
- `market_summary`: Sale price median, range, quartiles, per-area price, monthly trend and recent deals.
- `jeonse_ratio`: Jeonse-to-sale ratio, with estimates against a given deposit and area.

## FAQ

### What do I need to use it?

A free service key from data.go.kr, with an application for each dataset you query.

### How recent is the data?

The default window is the last 12 months by contract date; the last two months can be undercounted because of the 30-day reporting deadline.

### Is any call limit applied?

One query stays within 80 API calls, and a development account allows 10,000 calls per day.

### Is it financial advice?

No. The README says results are reference data and not a basis for contract or investment decisions.

### Is Korea Real Estate free?

Yes. Korea Real Estate is open source, so you can use and self-host it for free.

### How do I add Korea Real Estate to Claude Code?

Run this command in your terminal: claude mcp add korea-realestate-mcp --env DATA_GO_KR_SERVICE_KEY='<DATA_GO_KR_SERVICE_KEY>' -- npx -y korea-realestate-mcp

### What are the best alternatives to Korea Real Estate?

The closest alternatives to Korea Real Estate are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/korea-real-estate
