AI 에이전트에 리치고 부동산 데이터를 붙이세요

https://m.richgo.ai/api/mcp

# 리치고 MCP 를 연결한 뒤
대치동 은마 30평 3개월 뒤 시세 전망은?
은마 30평 지금 호가 32억이면 적당해? 보유세는?
은마 시세 1년 동안 얼마나 빠졌어? 강남구 동별 평당가 순위는?
은마 근처 중학교 학군 어때?
전농9구역 사업시행인가 언제쯤 날까?
서울 강서구 아파트 경매 다음 주 물건 보여줘

claude mcp add --transport http richgo https://m.richgo.ai/api/mcp

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "richgo": { "url": "https://m.richgo.ai/api/mcp" }
  }
}

// .vscode/mcp.json
{
  "servers": {
    "richgo": { "type": "http", "url": "https://m.richgo.ai/api/mcp" }
  }
}

# 도구 목록 (JSON-RPC 를 직접 보냄)
curl -s https://m.richgo.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_apartments",
    "arguments": { "query": "대치동 은마" }
  }
}

{
  "query": "대치동 은마",
  "results": [
    {
      "danji_id": "a0sCdHW",
      "name": "은마",
      "address": "서울시 강남구 삼성로 212",
      "url": "https://m.richgo.ai/realty/danji/a0sCdHW"
    }
  ],
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0", "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_price_forecast_3m",
    "arguments": { "danji_id": "a0sCdHW" }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "address": "서울 강남구 대치동",
  "pyeong": 30,
  "forecast": {
    "horizon": "3개월",
    "target_month": "2027년 1월",
    "predicted_price_manwon": 321782,
    "predicted_price": "32억 1,782만",
    "outlook": "소폭 상승 예상",
    "change_pct": 2.1,
    "base_price_manwon": 315028,
    "base_price": "31억 5,028만",
    "base_date": "2026-10-19",
    "issued_at": "2026-10-19"
  },
  "method": "리치고 단기 예측 — 과거 12개월 리치고 시세 흐름을 …",
  "disclaimer": "모델 추정치이며 실제 거래 가격을 보장하지 않습니다. …",
  "cite_as": "리치고 단기 예측(2026-10-19 산출)",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW?pyeongType=30",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0", "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_recent_trades",
    "arguments": { "danji_id": "a0sCdHW", "limit": 2 }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "pyeong": 30,
  "period": "최근 3년",
  "trade_count_3y": 98,
  "trade_count_12m": 32,
  "trades": [
    {
      "contract_date": "2026-09-29",
      "price_manwon": 315000,
      "price": "31억 5,000만",
      "floor": 8,
      "dong": null,
      "private_area_m2": 76.79,
      "deal_type": "중개거래",
      "registered_date": null
    },
    …
  ],
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW?pyeongType=30",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_apartment_overview",
    "arguments": {
      "danji_id": "a0sCdHW"
    }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "address": {
    "road": "서울시 강남구 삼성로 212",
    "jibun": "서울시 강남구 대치동 316"
  },
  "households": 4424,
  "buildings": 28,
  "floors": "최고 14층",
  "construct_date": "1979-08-30",
  "years_since_construction": 48,
  "builder": "한보주택",
  "heating": "지역난방 · 열병합",
  "entrance_type": "복도식",
  "parking": {
    "total": 3021,
    "per_household": 0.68
  },
  "floor_area_ratio_pct": 204,
  "building_coverage_pct": 20,
  "tags": [
    "대단지",
    "재건축",
    …
  ],
  "pyeongs": [
    {
      "pyeong": 30,
      "households": 2674,
      "supply_area_m2": "101.52",
      "private_area_m2": "76.79",
      "richgo_sale_price_manwon": 315028,
      "richgo_sale_price": "31억 5,028만",
      "richgo_jeonse_price_manwon": 71776,
      "richgo_jeonse_price": "7억 1,776만",
      "jeonse_rate_pct": 12.58,
      "price_date": "2026-10-19",
      "latest_trade": {
        "price_manwon": 315000,
        "contract_date": "2026-09-29"
      },
      "sale_listings": {
        "count": 228,
        "asking_min_manwon": 302000,
        "asking_max_manwon": 350000,
        "as_of": "2026-10-19"
      },
      "jeonse_wolse_listing_count": 59
    },
    {
      "pyeong": 34,
      "households": 1750,
      "supply_area_m2": "115.54",
      "private_area_m2": "84.43",
      "richgo_sale_price_manwon": 356219,
      "richgo_sale_price": "35억 6,219만",
      "richgo_jeonse_price_manwon": 90684,
      "richgo_jeonse_price": "9억 684만",
      "jeonse_rate_pct": 12.12,
      "price_date": "2026-10-19",
      "latest_trade": {
        "price_manwon": 340000,
        "contract_date": "2026-10-03"
      },
      "sale_listings": {
        "count": 139,
        "asking_min_manwon": 330000,
        "asking_max_manwon": 400000,
        "as_of": "2026-10-19"
      },
      "jeonse_wolse_listing_count": 47
    }
  ],
  "total_listings": 292,
  "absorption": {
    "listing_count": 367,
    "months_to_sell_all": 91.8,
    "region": {
      "name": "강남구",
      "months_to_sell_all": 46.7
    },
    "trades_confirmed_through": "2026-08"
  },
  "note": "리치고 시세는 실거래·매물 등을 바탕으로 리치고가 추정한 값이며 실거래가가 아닙니다. 호가는 매물 등록 가격입니다. 가 …",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_fair_asking_price",
    "arguments": {
      "danji_id": "a0sCdHW"
    }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "address": "서울 강남구 대치동",
  "pyeong": 30,
  "fair_asking_price": {
    "base_week": "2026-10-19",
    "private_area_m2": 76.79,
    "listing_count": 226,
    "bands": [
      {
        "band": "저층",
        "floors": "1~4층",
        "fair_min_manwon": 306500,
        "fair_max_manwon": 313500,
        "quick_sale_from_manwon": 301000
      },
      {
        "band": "중층",
        "floors": "5~9층",
        "fair_min_manwon": 313500,
        "fair_max_manwon": 316000,
        "quick_sale_from_manwon": 308000
      },
      …
    ]
  },
  "summary": "은마 30평(전용 76.79㎡) 리치고 적정 호가 추정(2026-10-19 주 기준)은 저층(1~4층) 30.6억~31 …",
  "note": "매물 호가 분포로 추정한 범위이며 실거래가가 아닙니다. 동·호수별 값은 리치고 앱 단지 상세의 \"우리집 동호수 가격 보기\".",
  "cite_as": "리치고 적정 호가 추정(2026-10-19 주 기준)",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW?pyeongType=30",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_holding_tax",
    "arguments": {
      "danji_id": "a0sCdHW"
    }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "address": "서울 강남구 대치동",
  "pyeong": 30,
  "holding_tax": {
    "year": 2026,
    "total_won": 8100386,
    "property_tax_won": 4565036,
    "comprehensive_tax_won": 3535350,
    "published_price_manwon": 234403,
    "published_price_year": 2026
  },
  "summary": "은마 30평을 1주택 실거주로 가지면 2026년 보유세는 약 810만 원(재산세 457만 원 · 종부세 354만 원)입 …",
  "assumptions": "1주택 실거주, 보유 기간·나이 공제 미반영. 세무법인 검수를 거친 리치고 세금 계산기와 같은 계산.",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW?pyeongType=30",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_price_history",
    "arguments": {
      "danji_id": "a0sCdHW",
      "months": 3
    }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "address": "서울 강남구 대치동",
  "pyeong": 30,
  "latest": {
    "month": "2026-10",
    "sale_manwon": 315028,
    "sale": "31억 5,028만",
    "jeonse_manwon": 71776,
    "jeonse": "7억 1,776만",
    "jeonse_rate_pct": 22.8
  },
  "sale_change_pct": {
    "1y": -15.3,
    "3y": 33.4,
    "5y": 31.1
  },
  "jeonse_change_pct": {
    "1y": -2.5
  },
  "sale_peak": {
    "month": "2026-01",
    "sale_manwon": 372034,
    "from_peak_pct": -15.3
  },
  "monthly": [
    {
      "month": "2026-08",
      "sale_manwon": 335868,
      "jeonse_manwon": 70561
    },
    {
      "month": "2026-09",
      "sale_manwon": 318442,
      "jeonse_manwon": 69269
    },
    …
  ],
  "series_starts": "2007-01",
  "note": "리치고 시세는 실거래·매물 등을 바탕으로 리치고가 매월 추정한 값이며 실거래가가 아닙니다. 단위 만원.",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW?pyeongType=30",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_region_market",
    "arguments": {
      "region": "강남구"
    }
  }
}

{
  "bjd_code": "1168000000",
  "name": "서울 강남구",
  "level": "시군구",
  "price_per_pyeong_manwon": 9632.8,
  "price_per_pyeong": "9,633만",
  "price_rank": {
    "rank": 1,
    "of": 25,
    "among": "같은 상위 지역 안"
  },
  "price_change_pct": {
    "week": -0.1,
    "month": -0.2,
    "quarter": -0.9,
    "year": 1.1
  },
  "jeonse_rate_pct": 34.9,
  "recent_transactions": 107,
  "recent_transactions_change_pct": -3.6,
  "listings": 11713,
  "listings_change_pct": 1.8,
  "sub_regions_by_price": [
    {
      "name": "압구정동",
      "bjd_code": "1168011000",
      "price_per_pyeong_manwon": 15797.5,
      "year_change_pct": -7,
      "danji_count": 21
    },
    {
      "name": "개포동",
      "bjd_code": "1168010300",
      "price_per_pyeong_manwon": 10436.2,
      "year_change_pct": 3.3,
      "danji_count": 22
    },
    …
  ],
  "other_matches": [
    {
      "bjd_code": "1168010400",
      "name": "서울 강남구 청담동"
    },
    {
      "bjd_code": "1168010300",
      "name": "서울 강남구 개포동"
    },
    …
  ],
  "note": "리치고 아파트 평당 시세(만원, 리치고 추정)와 지역 상세 페이지의 지표입니다. 하위 지역은 평당 시세 높은 순.",
  "url": "https://m.richgo.ai/realty/region/1168000000",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_school_district",
    "arguments": {
      "danji_id": "a0sCdHW",
      "per_level": 1
    }
  }
}

{
  "danji_id": "a0sCdHW",
  "name": "은마",
  "schools": [
    {
      "level": "elementary",
      "level_name": "초등학교",
      "school_id": "S010000750",
      "name": "서울대현초등학교",
      "walk_distance_m": 824,
      "straight_distance_m": 687,
      "grade": "S",
      "sd_rank": "서울 상위 3%",
      "admission_records": [],
      "url": "https://m.richgo.ai/realty/place/elementary/S010000750"
    },
    {
      "level": "middle",
      "level_name": "중학교",
      "school_id": "S010000704",
      "name": "단국대학교사범대학부속중학교",
      "walk_distance_m": 904,
      "straight_distance_m": 753,
      "grade": "S",
      "sd_rank": "서울 상위 5%",
      "admission_records": [],
      "url": "https://m.richgo.ai/realty/place/middle/S010000704"
    },
    …
  ],
  "note": "거리순 주변 학교입니다. 실제 배정은 교육청 학구도·배정 기준을 확인하세요. 학교 상세는 get_school(level …",
  "url": "https://m.richgo.ai/realty/danji/a0sCdHW",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_school",
    "arguments": {
      "level": "middle",
      "school_id": "S010000719"
    }
  }
}

{
  "level": "middle",
  "level_name": "중학교",
  "school_id": "S010000719",
  "name": "수서중학교",
  "organization_type": "공립",
  "established": "1993-04-30",
  "region": "서울 강남구 수서동",
  "students": 568,
  "teachers": 47,
  "classes": 24,
  "students_per_teacher": 12.1,
  "grade": "B",
  "sd_rank": "서울 상위 52%",
  "admission_rates": {
    "special_high_school_pct": 7.2,
    "science_high_pct": 0.7,
    "foreign_international_high_pct": 1.3,
    "autonomous_private_high_pct": 5.3
  },
  "admission_records": [],
  "feeder_schools": [
    {
      "school_id": "S010000514",
      "name": "은광여자고등학교"
    },
    {
      "school_id": "S010000538",
      "name": "진선여자고등학교"
    },
    …
  ],
  "nearby_apartments": [
    {
      "danji_id": "a8YWIct",
      "name": "수서한아름",
      "walk_distance_m": 252,
      "pyeong": 36,
      "richgo_price_manwon": 279000,
      "url": "https://m.richgo.ai/realty/danji/a8YWIct"
    },
    {
      "danji_id": "a2hiRZR",
      "name": "삼익",
      "walk_distance_m": 313,
      "pyeong": 26,
      "richgo_price_manwon": 239000,
      "url": "https://m.richgo.ai/realty/danji/a2hiRZR"
    },
    …
  ],
  "note": "진학률·순위는 리치고 학교 상세 페이지와 같은 값입니다. 진학 실적은 상위권 대학 위주 건별 수집 자료라 없으면 빈 목 …",
  "url": "https://m.richgo.ai/realty/place/middle/S010000719",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_redevelopment",
    "arguments": {
      "danji_id": "a2IhImJ"
    }
  }
}

{
  "danji_id": "a2IhImJ",
  "radius_m": 1000,
  "sites": [
    {
      "site_id": "d2ndHUg",
      "name": "청량리동19일대",
      "kind": "재개발",
      "distance_m": 91,
      "url": "https://m.richgo.ai/realty/place/redevelop/d2ndHUg"
    },
    {
      "site_id": "d0GzHZo",
      "name": "청량리8구역",
      "kind": "재개발",
      "distance_m": 382,
      "url": "https://m.richgo.ai/realty/place/redevelop/d0GzHZo"
    },
    …
  ],
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_redevelopment",
    "arguments": {
      "site_id": "d7lHXyA"
    }
  }
}

{
  "site_id": "d7lHXyA",
  "kind": "재개발",
  "name": "전농9구역",
  "official_name": "전농9",
  "region": "서울 동대문구 전농동",
  "planned_households": 1159,
  "constructor": "현대엔지니어링",
  "current_stage": {
    "step": 6,
    "name": "사업시행 인가",
    "speed": "보통",
    "since": "2023-07-13"
  },
  "ai_expected_pass": {
    "stage": "사업시행 인가",
    "expected_date": "2028-07-12",
    "as_of": "2026-09-21"
  },
  "timeline": [
    {
      "step": 1,
      "name": "기본계획 수립",
      "status": "완료",
      "actual_date": "2004-06-23",
      "ai_expected_date": null
    },
    {
      "step": 2,
      "name": "안전진단",
      "status": "완료",
      "actual_date": null,
      "ai_expected_date": null
    },
    …
  ],
  "plan": [
    {
      "group": "기본 정보",
      "label": "구역면적",
      "value": "49,058㎡"
    },
    {
      "group": "기본 정보",
      "label": "토지등소유자",
      "value": "717명"
    },
    …
  ],
  "permit_history": [
    {
      "date": "2024-12-22",
      "event": "현대엔지니어링"
    },
    {
      "date": "2023-07-13",
      "event": "사업시행자지정"
    },
    …
  ],
  "contribution_basis": null,
  "notes": [
    "AI 예상 통과월은 리치고 모형 추정이며 실제 인가일과 다릅니다.",
    "추정 분담금은 고시·원문의 비례율·조합원 분양가 기준 계산이며 실제 분담금과 다를 수 있습니다."
  ],
  "url": "https://m.richgo.ai/realty/place/redevelop/d7lHXyA",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_auctions",
    "arguments": {
      "sd": "서울",
      "sgg": "강서구",
      "item_type": "아파트",
      "limit": 2
    }
  }
}

{
  "filters": {
    "sd": "서울",
    "sgg": "강서구",
    "court": null,
    "category": null,
    "item_type": "아파트"
  },
  "total_count": 27,
  "items": [
    {
      "auction_id": "C15HIXZY",
      "case_number": "2026타경3433",
      "item_number": 1,
      "court": "서울남부지방법원",
      "address": "서울특별시 강서구 방화동 841 장미아파트 제101동 제7층 제707호",
      "item_type": "아파트",
      "category": "주거시설",
      "appraised_price_manwon": 59400,
      "appraised_price": "5억 9,400만",
      "lowest_price_manwon": 59400,
      "lowest_price": "5억 9,400만",
      "lowest_to_appraised_pct": 100,
      "failed_count": 0,
      "bidding_date": "2026-10-20",
      "building_area_m2": 59.04,
      "land_area_m2": 39.06,
      "url": "https://m.richgo.ai/auctionMobile/C15HIXZY"
    },
    {
      "auction_id": "C18NYGOF",
      "case_number": "2026타경3888",
      "item_number": 1,
      "court": "서울남부지방법원",
      "address": "서울특별시 강서구 화곡동 922-17 우공아파트  제3층 제304호",
      "item_type": "아파트",
      "category": "주거시설",
      "appraised_price_manwon": 24900,
      "appraised_price": "2억 4,900만",
      "lowest_price_manwon": 24900,
      "lowest_price": "2억 4,900만",
      "lowest_to_appraised_pct": 100,
      "failed_count": 0,
      "bidding_date": "2026-10-20",
      "building_area_m2": 27,
      "land_area_m2": 8.14,
      "url": "https://m.richgo.ai/auctionMobile/C18NYGOF"
    }
  ],
  "note": "진행 중 물건을 매각기일 가까운 순으로. 금액 단위 만원(감정가·최저매각가). 매각기일이 지난 항목은 결과 반영 전이라 …",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_auction",
    "arguments": {
      "auction_id": "C18NYGOF"
    }
  }
}

{
  "auction_id": "C18NYGOF",
  "case_number": "2026타경3888",
  "item_number": 1,
  "court": "서울남부지방법원",
  "address": "서울특별시 강서구 화곡동 922-17 우공아파트  제3층 제304호",
  "region": "서울 강서구 화곡동",
  "item_type": "아파트",
  "category": "주거시설",
  "status": "진행중",
  "appraised_price_manwon": 24900,
  "appraised_price": "2억 4,900만",
  "lowest_price_manwon": 24900,
  "lowest_price": "2억 4,900만",
  "lowest_to_appraised_pct": 100,
  "failed_count": 0,
  "bidding_date": "2026-10-20",
  "bid_deposit_manwon": 2490,
  "registered_date": "2026-02-27",
  "building_area_m2": 27,
  "land_area_m2": 8.14,
  "years_since_construction": null,
  "sale_result": null,
  "history": [
    {
      "order": 1,
      "type": "매각기일",
      "date": "2026-10-20",
      "lowest_price_manwon": 24900,
      "result": null
    },
    {
      "order": 2,
      "type": "매각결정기일",
      "date": "2026-10-27",
      "lowest_price_manwon": null,
      "result": null
    }
  ],
  "appraisal_summary": [
    "본건은 서울특별시 강서구 화곡동 소재 지하철 2호선 및 5호선 '까치산역' 남서측 인근에 위 치하는 '우공아파트' 제3 …",
    "본건까지 제반 차량의 진출입이 가능하며, 인근에 노선버스정류장 및 지하철 2호선 및 5호선 '까치산역'이 소재하는 등 제반",
    …
  ],
  "rights_summary": {
    "has_registry_data": true,
    "base_right": {
      "type": "강제경매",
      "date": "2026-02-27"
    },
    "assumed_right_count": 0,
    "assumed_tenant_count": 0,
    "uncertain_tenant_count": 0,
    "has_assumption": false
  },
  "not_included": "등기 권리분석 상세·예상 배당표·인수금·AI 추천 입찰가·수익률은 리치고 앱 유료 기능이라 제공하지 않습니다.",
  "url": "https://m.richgo.ai/auctionMobile/C18NYGOF",
  "source": "리치고(Richgo) m.richgo.ai"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_auction_stats",
    "arguments": {
      "sd": "서울",
      "sgg": "강서구"
    }
  }
}

{
  "region": "서울 강서구",
  "period": {
    "from": "2025-11",
    "to": "2026-10"
  },
  "last_12_months": {
    "auction_count": 7792,
    "sell_count": 2073,
    "sell_ratio_pct": 26.6,
    "sell_price_ratio_pct": 69.6
  },
  "by_item_type": [
    {
      "item_type": "아파트",
      "auction_count": 285,
      "sell_count": 78,
      "sell_ratio_pct": 27.4,
      "sell_price_ratio_pct": 91.1
    },
    {
      "item_type": "오피스텔",
      "auction_count": 2162,
      "sell_count": 583,
      "sell_ratio_pct": 27,
      "sell_price_ratio_pct": 68.4
    },
    …
  ],
  "note": "매각률 = 매각 건수 ÷ 경매 건수, 매각가율 = 낙찰가 합계 ÷ 감정가 합계. 매월 갱신.",
  "url": "https://m.richgo.ai/auction/stats/%EC%84%9C%EC%9A%B8/%EA%B0%95%EC% …",
  "source": "리치고(Richgo) m.richgo.ai"
}