Richgo Real Estate MCP
An official MCP server by Richgo providing read-only access to Korean real estate data, including apartment price forecasts, recent transaction records, fair asking prices, holding taxes, school districts, redevelopment status, and court auction statistics.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://m.richgo.ai/api/mcpWhat you can do with it
- Search for apartments by name or district to get IDs
- Predict 3-month future apartment prices using statistical models
- Retrieve recent 3-year transaction history for specific units
- Analyze court auction details and regional sales rates
Source and maintenance
Protocol and capabilities
- Server
- richgo 1.3.0
- MCP protocol
- 2025-06-18
- Tools
- 15 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
15 advertised
search_apartments — 아파트 단지 찾기
Find Korean apartment complexes by name or neighborhood and get their danji_id. 아파트 이름·동 이름으로 단지를 찾아 danji_id 를 돌려줍니다. 다른 도구를 쓰기 전에 먼저 부르세요.
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 40,
"description": "단지 이름 또는 동 이름 (예: 메이플자이, 반포동 래미안)"
}
},
"additionalProperties": false
}{
"title": "아파트 단지 찾기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_price_forecast_3m — 3개월 뒤 시세 예측
Richgo's 3-month-ahead sale price forecast for an apartment complex (one floor-plan size). 단지·평형의 3개월 뒤 매매 시세 예측(리치고 단기 예측: 과거 12개월 시세 흐름을 이어 본 통계 모델)과 기준 시세·변동률·전망(상승/유지/하락)을 돌려줍니다. "○○아파트 전망" 질문에 쓰세요. 추정치이며 투자 권유가 아닙니다.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"pyeong": {
"type": "integer",
"description": "평형(공급면적 평). 비우면 대표 평형"
},
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "3개월 뒤 시세 예측",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_recent_trades — 실거래가
Recent recorded sale transactions (MOLIT data) for an apartment complex and floor-plan size, newest first. 단지·평형의 최근 3년 매매 실거래(계약일·가격·층·동·거래 유형·등기일)를 최근 계약순으로 돌려줍니다.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "몇 건까지(기본 10, 최대 30)"
},
"pyeong": {
"type": "integer",
"description": "평형(공급면적 평). 비우면 대표 평형"
},
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "실거래가",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_apartment_overview — 단지 개요·평형별 시세
Apartment complex profile and per-size prices: households, completion date, builder, floor-area ratio, parking, and for each floor-plan size the Richgo estimated sale/jeonse price, latest recorded sale and current listings. 단지 개요(세대수·입주·시공사·용적률·주차)와 평형별 리치고 매매·전세 시세, 최근 실거래, 매물 수·호가 범위, 매물 소화 기간.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "단지 개요·평형별 시세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_fair_asking_price — 적정 호가
Richgo's fair asking-price range by floor band (low/mid/high floors) for one floor-plan size, plus the quick-sale level. 평형의 층 구간별(저·중·고층) 리치고 적정 호가 추정 범위와 급매 수준, 기준 주, 매물 수. "이 가격 적당해?" 질문에 쓰세요.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"pyeong": {
"type": "integer",
"description": "평형. 비우면 대표 평형"
},
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "적정 호가",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_holding_tax — 1주택 보유세
This year's holding tax (property tax + comprehensive real estate tax) for one home of the given size, assuming a single-home owner-occupier, based on the official published price. 평형의 올해 1주택 실거주 보유세(재산세·종부세) — 고시 공시가격 기준, 리치고 세금 계산기와 같은 계산.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"pyeong": {
"type": "integer",
"description": "평형. 비우면 대표 평형"
},
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "1주택 보유세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_price_history — 리치고 시세 추이
Monthly Richgo estimated sale and jeonse prices of an apartment complex size, with 1/3/5-year change and the peak. 단지·평형의 월별 리치고 매매·전세 시세 추이와 1·3·5년 변동률, 최고점 대비 위치를 돌려줍니다.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"months": {
"type": "integer",
"maximum": 240,
"minimum": 1,
"description": "최근 몇 개월을 돌려줄지(기본 36, 최대 240)"
},
"pyeong": {
"type": "integer",
"description": "평형. 비우면 대표 평형"
},
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
}
},
"additionalProperties": false
}{
"title": "리치고 시세 추이",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_region_market — 지역 시세
Apartment market of a province/district/neighborhood: Richgo price per pyeong and its rank, weekly/monthly/yearly change, jeonse ratio, recent transactions and listings, and the sub-regions ranked by price. 시도·시군구·읍면동의 아파트 평당 시세·순위·변동률(주·월·분기·연)·전세가율·거래량·매물 수와 하위 지역 시세 순위.
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "지역 이름 (예: 서울, 강남구, 대치동, 수원시 영통구)"
},
"bjd_code": {
"type": "string",
"description": "10자리 법정동 코드 (하위 지역을 이어 볼 때 결과의 bjd_code 를 그대로)"
}
},
"additionalProperties": false
}{
"title": "지역 시세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_school_district — 단지 주변 학교(학군)
Nearest elementary, middle and high schools of an apartment complex with walking distance and the Richgo school-district rank within the province. 단지에서 가까운 초·중·고(거리순)와 시도 내 학군 순위, 학교 ID.
{
"type": "object",
"required": [
"danji_id"
],
"properties": {
"danji_id": {
"type": "string",
"description": "search_apartments 로 얻은 7자리 단지 ID"
},
"per_level": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "학교급별 몇 곳(기본 3, 최대 5)"
}
},
"additionalProperties": false
}{
"title": "단지 주변 학교(학군)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_school — 학교 상세
School profile: type, students, teachers, province rank, admission results (special high schools for middle schools, university entrance for high schools, notable admissions), and nearby apartment complexes. 학교 상세 — 설립·학생 수·교사 수·시도 순위, 중학교는 특목·자사고 진학률, 고등학교는 대학 진학률·진학 실적, 주변 아파트.
{
"type": "object",
"required": [
"level",
"school_id"
],
"properties": {
"level": {
"enum": [
"elementary",
"middle",
"high"
],
"type": "string",
"description": "학교급"
},
"school_id": {
"type": "string",
"description": "get_school_district 로 얻은 학교 ID (예: S010000719)"
}
},
"additionalProperties": false
}{
"title": "학교 상세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_redevelopment — 재개발·재건축 사업지 찾기
Find redevelopment/reconstruction project sites near an apartment complex (within 1 km) or by name. 단지 주변 1km 안 재개발·재건축 사업지(거리순) 또는 이름으로 사업지를 찾아 site_id 를 돌려줍니다.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 40,
"description": "사업지 이름으로 찾을 때 (예: 전농9구역, 압구정3구역)"
},
"danji_id": {
"type": "string",
"description": "이 단지 주변 사업지를 찾을 때 — search_apartments 로 얻은 단지 ID"
}
},
"additionalProperties": false
}{
"title": "재개발·재건축 사업지 찾기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_redevelopment — 재개발·재건축 사업지 상세
Detail of a redevelopment/reconstruction site: current stage, stage timeline with dates, Richgo AI expected approval month for the current stage, supply plan, permit history and, where published, the estimated member contribution basis. 사업지 상세 — 현재 단계·단계별 일정·AI 예상 통과월·공급 계획·인허가 이력·추정 분담금 자료.
{
"type": "object",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"description": "search_redevelopment 로 얻은 사업지 ID (예: d7lHXyA)"
},
"previous_asset_manwon": {
"type": "integer",
"minimum": 1,
"description": "추정 분담금 계산용 종전자산 평가액(만원, 예: 50000 = 5억). 비우면 원문 예시 기준만"
}
},
"additionalProperties": false
}{
"title": "재개발·재건축 사업지 상세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_auctions — 진행 중 법원 경매 찾기
In-progress Korean court auction items filtered by province/district, court or use type, nearest bidding date first. 시도·시군구·법원·용도로 진행 중 법원경매 물건을 찾습니다(매각기일 가까운 순): 감정가·최저매각가·유찰 횟수·매각기일.
{
"type": "object",
"properties": {
"sd": {
"type": "string",
"description": "시도 축약형 (예: 서울, 경기, 부산)"
},
"sgg": {
"type": "string",
"description": "시군구 (예: 강서구, 창원시 의창구). sd 와 함께"
},
"court": {
"type": "string",
"description": "법원 전체 이름 (예: 서울남부지방법원)"
},
"limit": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "몇 건까지(기본 10, 최대 30)"
},
"category": {
"enum": [
"주거시설",
"업무상업시설",
"토지",
"공업시설"
],
"type": "string",
"description": "용도 대분류"
},
"item_type": {
"type": "string",
"description": "용도 세분류 (예: 아파트, 다세대, 오피스텔)"
}
},
"additionalProperties": false
}{
"title": "진행 중 법원 경매 찾기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_auction — 경매 물건 개요
Public overview of one court auction item: case number, court, address, appraised/minimum price, failed rounds, bidding date, schedule history, appraisal notes and a rights summary (base right, assumed rights count). 경매 물건 개요 — 사건번호·법원·감정가·최저가·유찰·매각기일·진행 이력·감정평가 요약·말소기준권리와 인수 권리 건수.
{
"type": "object",
"required": [
"auction_id"
],
"properties": {
"auction_id": {
"type": "string",
"description": "search_auctions 로 얻은 경매 물건 ID (예: C88PQDUZ)"
}
},
"additionalProperties": false
}{
"title": "경매 물건 개요",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_auction_stats — 지역 경매 낙찰가율·매각률
Court auction statistics for the last 12 months in a province/district: number of auctions, sales, sale ratio and winning-bid-to-appraisal ratio, monthly and by property type. 전국·시도·시군구의 최근 12개월 경매 건수·매각 건수·매각률·매각가율(낙찰가÷감정가), 월별 추이와 용도별 합계.
{
"type": "object",
"properties": {
"sd": {
"type": "string",
"description": "시도 축약형 (예: 서울). 비우면 전국"
},
"sgg": {
"type": "string",
"description": "시군구 (예: 강서구). sd 와 함께"
}
},
"additionalProperties": false
}{
"title": "지역 경매 낙찰가율·매각률",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 655 ms
- 95th percentile latency
- 655 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 655 ms · metadata changed · 15 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http richgo-real-estate-mcp https://m.richgo.ai/api/mcpCodex
codex mcp add richgo-real-estate-mcp --url https://m.richgo.ai/api/mcpCursor
{
"mcpServers": {
"richgo-real-estate-mcp": {
"url": "https://m.richgo.ai/api/mcp"
}
}
}Cline
{
"mcpServers": {
"richgo-real-estate-mcp": {
"type": "streamableHttp",
"url": "https://m.richgo.ai/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"richgo-real-estate-mcp": {
"type": "http",
"url": "https://m.richgo.ai/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http richgo-real-estate-mcp https://m.richgo.ai/api/mcpClaude Desktop
{
"mcpServers": {
"richgo-real-estate-mcp": {
"url": "https://m.richgo.ai/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"richgo-real-estate-mcp": {
"serverUrl": "https://m.richgo.ai/api/mcp"
}
}
}Let your agent find its tools
Find servers like Richgo Real Estate MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Richgo Real Estate MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.