Korean Real Estate Transactions
Korean apartment and housing sale/rent records (MOLIT) by natural-language address. No key.
Should I use this
Quality & Safety
Findings (3)
- HIGH
- MEDIUMin get_korean_real_estate_transactions
- LOWin get_korean_real_estate_transactions
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"korean-real-estate-mcp": {
"url": "https://realestate-api.goyostudio.io/mcp"
}
}
}Remote endpoints
https://realestate-api.goyostudio.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (1)
π’get_korean_real_estate_transactions(q, type, tradeType, rentSubtype, startDate, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Natural-language Korean address and/or complex name. Max ~30 Korean characters (90 UTF-8 bytes), max 8 whitespace-separated tokens. Do not include period words ('μ΅κ·Ό 3κ°μ' is ignored β use startDate/endDate)."
},
"type": {
"type": "string",
"enum": [
"apartment",
"officetel",
"rowhouse",
"detached",
"presale",
"land",
"commercial",
"industrial"
],
"description": "Property type. Default apartment unless inferred from q. rent is available only for apartment/officetel/rowhouse/detached; presale/land/commercial/industrial are sale-only."
},
"tradeType": {
"type": "string",
"enum": [
"sale",
"rent"
],
"description": "sale = λ§€λ§€ (default), rent = μ μμΈ (jeonse + wolse combined unless rentSubtype filters)."
},
"rentSubtype": {
"type": "string",
"enum": [
"jeonse",
"wolse"
],
"description": "Only with tradeType=rent. jeonse (μ μΈ) = deposit-only; wolse (μμΈ) = has monthly rent."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM inclusive. Default: 11 months before endDate (12-month window). Max range 24 months."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM inclusive. Default: current month."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "Max transaction rows returned (default 100). Statistics always cover the full matching set regardless of limit."
},
"areaMin": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Minimum EXCLUSIVE area (μ μ©λ©΄μ ) in γ‘, inclusive. Not supply area (곡κΈλ©΄μ ). A '84 type' apartment is usually 84.0-85.9γ‘, so pin it with areaMin=84 & areaMax=86."
},
"areaMax": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Maximum EXCLUSIVE area (μ μ©λ©΄μ ) in γ‘, inclusive."
},
"groupBy": {
"type": "string",
"enum": [
"month"
],
"description": "Set to 'month' for stats_by_month[] β per-month aggregates over the full matching set. Required for trend/μΆμ΄ questions: the transaction rows are capped at limit, so a trend cannot be rebuilt from them."
}
},
"required": [
"q"
]
}Community
Evidence