Korean Real Estate Transactions MCP

{
  "type": "object",
  "required": [
    "q"
  ],
  "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": {
      "enum": [
        "apartment",
        "officetel",
        "rowhouse",
        "detached",
        "presale",
        "land",
        "commercial",
        "industrial"
      ],
      "type": "string",
      "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."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max transaction rows returned (default 100). Statistics always cover the full matching set regardless of limit."
    },
    "areaMax": {
      "type": "number",
      "description": "Maximum EXCLUSIVE area (전용면적) in ㎡, inclusive.",
      "exclusiveMinimum": 0
    },
    "areaMin": {
      "type": "number",
      "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.",
      "exclusiveMinimum": 0
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "YYYY-MM inclusive. Default: current month."
    },
    "groupBy": {
      "enum": [
        "month"
      ],
      "type": "string",
      "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."
    },
    "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."
    },
    "tradeType": {
      "enum": [
        "sale",
        "rent"
      ],
      "type": "string",
      "description": "sale = 매매 (default), rent = 전월세 (jeonse + wolse combined unless rentSubtype filters)."
    },
    "rentSubtype": {
      "enum": [
        "jeonse",
        "wolse"
      ],
      "type": "string",
      "description": "Only with tradeType=rent. jeonse (전세) = deposit-only; wolse (월세) = has monthly rent."
    }
  }
}