Korea Real Estate
Query South Korea's official real-estate transactions and compute jeonse ratios
- 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-mcpAdd 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.


