Skip to content
MCP server

Korea Real Estate

Query South Korea's official real-estate transactions and compute jeonse ratios

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.2
Listing updated
today

Similar MCP servers

About Korea Real Estate

Korea Real Estate is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • DATA_GO_KR_SERVICE_KEY공공데이터포털 일반 인증키 (Encoding·Decoding 어느 쪽이든)Required

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; free data.go.kr key required

Korea Real Estate 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.

How AIPoweredBot checks servers