Korean Real Estate Transactions

io.github.goyo-studioPublished by GitHub account goyo-studiov1.0.0Updated Oct 31, 2026

Korean apartment and housing sale/rent records (MOLIT) by natural-language address. No key.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

Remote MCP server that answers Korean address or apartment-complex questions with official MOLIT real-estate sale and rent transaction records.

What you can do
  • Look up Korean real-estate transactions from a natural-language Korean address or apartment-complex name
  • Get sale, jeonse and monthly-rent records with period statistics (average, minimum, maximum price in KRW, or deposit and monthly rent)
  • Group results by month for trends and filter by exclusive floor area
  • Resolve ambiguous locations by re-querying with returned candidate names, and see inferred details and missing months in the response
When to use it
Useful when an assistant needs Korean apartment or housing transaction prices, rent levels or monthly price trends for a specific neighborhood or complex, without signing up for an API key.
Requirements
A remote Streamable HTTP endpoint; no authentication, API key or environment variable is needed. Clients that cannot add remote connectors can reach it through the mcp-remote npm package, which needs Node.js. The query text should be in Korean.
Before you install
Rate limited to 50 requests per 10 seconds per IP, with HTTP 429 and Retry-After beyond that. Currently free, but per-request micro-pricing may be introduced later. Data comes from MOLIT via data.go.kr and may change as reports are corrected or cancelled; it is provided as-is, is not affiliated with the government, and is not investment, legal or tax advice. The server is operated by a third party whose source code is not published.

Installation

In SourceWeft

  1. Open Korean Real Estate Transactions in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.goyo-studio%2Fkorean-real-estate-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "korean-real-estate-transactions": {
      "type": "http",
      "url": "https://realestate-api.goyostudio.io/mcp"
    }
  }
}

README

Korean Real Estate Transactions MCP

[Korean Real Estate Transactions MCP on Glama]

한국어 · English

Remote MCP server: https://realestate-api.goyostudio.io/mcp (Streamable HTTP, no authentication)

This repository holds documentation and registry metadata only. The server is operated by goyostudio; its source code is not published here.

한국어

무엇을 하나요

한국 주소나 아파트 단지명을 자연어로 물으면 국토교통부 실거래가 공개 데이터(data.go.kr)를 돌려주는 원격 MCP 서버입니다. 매매·전세·월세, 기간 통계(평균·최저·최고), 월별 추이, 전용면적 조건을 지원합니다. API 키가 필요 없습니다.

엔드포인트

항목값
URLhttps://realestate-api.goyostudio.io/mcp
전송Streamable HTTP (무상태, POST만. GET은 405)
인증없음
도구get_korean_real_estate_transactions (1개)

예시 질문

  • "강남구 대치동 은마 아파트 매매"
  • "마포구 아파트 전세 월별 추이" → groupBy: "month"
  • "송파구 헬리오시티 전용 84" → areaMin: 84, areaMax: 86

도구 호출 예:

json
{  "name": "get_korean_real_estate_transactions",  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }}

지역이 모호하면 HTTP 422와 candidates[]가 오고, 그 후보로 다시 호출합니다. 추론한 내용은 resolved_note에, 빠진 달은 missing_months에 표시됩니다. 자세한 내용은 docs/usage.md.

클라이언트 설정

Cursor (~/.cursor/mcp.json 또는 프로젝트의 .cursor/mcp.json):

json
{  "mcpServers": {    "korean-real-estate": {      "url": "https://realestate-api.goyostudio.io/mcp"    }  }}

Claude Desktop: 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 URL https://realestate-api.goyostudio.io/mcp 입력. 원격 커넥터를 쓸 수 없는 환경에서는 claude_desktop_config.json에 mcp-remote를 씁니다:

json
{  "mcpServers": {    "korean-real-estate": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]    }  }}

Claude Code: claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

이용 제한

IP당 50요청 / 10초. 초과하면 HTTP 429와 Retry-After 헤더가 옵니다. 그 초만큼 기다린 뒤 다시 시도하세요. 현재 무료이며, 추후 x402 프로토콜 기반 소액 과금이 도입될 수 있습니다(현재 상태: /openapi.json의 x-pricing).

출처와 면책

  • 출처: 국토교통부 실거래가 공개시스템, data.go.kr OpenAPI. 모든 응답에 source 필드가 있습니다.
  • 정부 공식 서비스가 아니며 국토교통부와 관계가 없습니다.
  • 무보증(AS-IS). 신고 정정·해제로 수치가 바뀔 수 있습니다. 투자·법률·세무 자문이 아닙니다.
  • 약관: https://realestate-api.goyostudio.io/terms

English

What it does

A remote MCP server that answers natural-language questions about Korean addresses or apartment complexes with official real-estate transaction records from the Ministry of Land, Infrastructure and Transport (MOLIT, via data.go.kr). It covers sales, jeonse and monthly rent, period statistics (avg/min/max), monthly trends, and exclusive-area filters. No API key.

Endpoint

ItemValue
URLhttps://realestate-api.goyostudio.io/mcp
TransportStreamable HTTP (stateless, POST only; GET returns 405)
AuthNone
Toolget_korean_real_estate_transactions (one tool)

Example

json
{  "name": "get_korean_real_estate_transactions",  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }}

The query q is Korean. Ambiguous locations return HTTP 422 with candidates[]; call again with one of them. Inferences are disclosed in resolved_note, coverage gaps in missing_months. See docs/usage.md.

Client configuration

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

json
{  "mcpServers": {    "korean-real-estate": {      "url": "https://realestate-api.goyostudio.io/mcp"    }  }}

Claude Desktop: Settings → Connectors → Add custom connector, URL https://realestate-api.goyostudio.io/mcp. Where remote connectors are not available, use mcp-remote in claude_desktop_config.json:

json
{  "mcpServers": {    "korean-real-estate": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]    }  }}

Claude Code: claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

Rate limit

50 requests / 10 seconds per IP. Over the limit you get HTTP 429 with a Retry-After header; wait that many seconds and retry. Currently free. Per-request micro-pricing via the x402 protocol may be introduced later (status: x-pricing in /openapi.json).

Data source and disclaimer

  • Source: 국토교통부 실거래가 공개시스템 (MOLIT) via the data.go.kr OpenAPI. Every response carries a source field.
  • Not affiliated with, operated by, or endorsed by MOLIT or any government body.
  • Provided AS IS, without warranty. Official reports may be corrected or cancelled after publication. Not investment, legal, or tax advice.
  • Terms: https://realestate-api.goyostudio.io/terms

License

Documentation in this repository: MIT. The data returned by the service is subject to the terms and the original data.go.kr terms.

Source: README.md at commit c9c915f

Tools

1

get_korean_real_estate_transactions

Query official Korean real-estate transaction records (국토교통부 실거래가, MOLIT via data.go.kr) with a natural-language Korean address or apartment-complex name, e.g. '강남구 대치동 은마 아파트 매매'. Returns flat JSON: period statistics (avg/min/max price in KRW, or deposit/monthly-rent stats for rentals) plus individual transactions, newest first. For trend questions ('월별 추이', 'how did prices move'), pass groupBy=month to get stats_by_month[]; for a size condition ('전용 84', '국평'), pass an areaMin/areaMax band — both aggregate over the full matching set, unlike the row list which is capped at limit. Hint words inside q (아파트/오피스텔…, 매매/전세/월세) are auto-inferred as type/tradeType/rentSubtype; explicit fields always win. Ambiguous locations return HTTP 422 with candidates[] — pick one and retry. Unresolvable locations return 404. All inferences are disclosed in resolved_note; coverage gaps in missing_months. Terms (as-is, no warranty): https://realestate-api.goyostudio.io/terms — data may be corrected or cancelled after initial publication; not investment advice. PRICING: currently free within edge or app rate limits (50 requests / 10 seconds per IP). HTTP 429 with error RATE_LIMITED and a Retry-After header — wait that many seconds, then retry. x402-ready: a fixed micro-price per request (indicative $0.001–$0.01, USDC on Base) may be enabled later, after which unpaid requests receive HTTP 402 Payment Required per the x402 protocol (https://x402.org); agents with x402 support handle this automatically. Current pricing status: GET https://realestate-api.goyostudio.io/openapi.json → x-pricing.

ParametersqrequiredtypelimitareaMaxareaMinendDategroupBystartDatetradeTyperentSubtype

Version history

1
  1. v1.0.0LatestOct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts