MCP.Market

Korea Data Suite MCP server

by choiyounggi·io.github.choiyounggi/korea-data-mcp·v0.1.1·2 stars
No reviews yet

Korean public holidays, business-day math, and MOLIT real-estate transactions as MCP tools.

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

2 stars

Reviews

Write one

Nobody has reviewed Korea Data Suite yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Korea Data Suite tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_business_days

    특정 날짜에 N영업일을 더한 날짜를 계산한다 (주말·공휴일 자동 제외).

  • check_holiday

    특정 날짜가 공휴일/영업일인지 확인한다 (Is this date a holiday or a business day?).

  • count_business_days

    기간 내 영업일 수를 센다 (양끝 포함, 주말·공휴일 제외).

  • get_holidays

    대한민국 공휴일 목록을 조회한다 (List Korean public holidays).

  • get_real_estate_transactions

    국토교통부(MOLIT) 아파트/오피스텔/토지 실거래가를 정규화된 JSON으로 조회한다.

  • list_real_estate_regions

    실거래가 조회에 쓰는 지역 코드(LAWD 5자리) 목록을 반환한다.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan4 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 34 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Korea Data Suite compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Tools
6
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 75% of 28,688 servers

What its tools let an agent do: 5 read · 1 create

Install Korea Data Suite in Claude Code, Cursor or VS Code

claude mcp add korea-data-mcp -- uvx korea-data-mcp
Add to Cursor

What the publisher says

From the Korea Data Suite repository's README, as published. We do not edit it. Read it on GitHub

Korea Data Suite

English | 한국어

Clean, developer-friendly REST APIs for Korean public data. Korean government open data is powerful but hard to consume — Korean-only docs, XML responses, legacy auth. This suite normalizes it into simple JSON APIs.

▶ Try it on RapidAPI — free tier, no setup. Hosted and auto-updated; same code as this repo. For AI agents, it's on the MCP Registry — uvx korea-data-mcp.

APIs

Get started

Hosted (recommended) — a maintained instance with a free tier and no setup:

→ Subscribe on RapidAPI, grab your key, and call any endpoint. RapidAPI injects the key for you — copy a ready-made snippet from its Code Snippets panel.

Both run the exact same code (this repo). Pick RapidAPI if you'd rather not operate data pipelines; self-host if you want full control.

Self-host

uv sync
uv run uvicorn app.main:app --port 8642
curl "http://127.0.0.1:8642/v1/health"

Holidays & Business Days API

# All holidays in a year (or a month)
curl "http://127.0.0.1:8642/v1/holidays?year=2026" -H "X-API-Key: <key>"

# Is a given date a holiday / business day?
curl "http://127.0.0.1:8642/v1/holidays/check?date=2026-03-02" -H "X-API-Key: <key>"

# Add N business days (skips weekends & holidays)
curl "http://127.0.0.1:8642/v1/business-days/add?date=2026-12-31&days=1" -H "X-API-Key: <key>"

# Count business days in a range (inclusive)
curl "http://127.0.0.1:8642/v1/business-days/count?start=2026-09-21&end=2026-09-27" -H "X-API-Key: <key>"

Covers official public holidays, substitute holidays (대체공휴일), temporary holidays (임시공휴일), and election days — the cases most global holiday APIs get wrong for Korea.

Real Estate Transactions API

Normalized MOLIT (Ministry of Land) real transaction prices — apartment, officetel, and land; sale, jeonse, and monthly-rent — as clean English JSON with cursor pagination.

# Real transaction prices (apartment sales in Gangnam-gu)
curl "http://127.0.0.1:8642/v1/realestate/transactions?region=11680&property_type=apartment&trade_type=sale" -H "X-API-Key: <key>"

# Filter by date range + paginate with the returned cursor
curl "http://127.0.0.1:8642/v1/realestate/transactions?region=11680&date_from=2026-01-01&limit=50&cursor=<next_cursor>" -H "X-API-Key: <key>"

# Region codes (LAWD 5-digit)
curl "http://127.0.0.1:8642/v1/realestate/regions" -H "X-API-Key: <key>"

Daily sync ingests the current + previous month; use the backfill CLI for history:

uv run python scripts/backfill.py --from 2025-01 --to 2025-12 --regions 11680,11650

Configuration

Environment variables (prefix KDS_, .env supported):

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Korea Data Suite: common questions

Is Korea Data Suite MCP server safe?
Mostly: it is graded B (78/100). Read the Korea Data Suite safety report
How do I install Korea Data Suite?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Korea Data Suite need an API key?
Yes. The registry entry asks for KDS_API_KEY.
Is Korea Data Suite maintained?
The last commit was 75 days ago (2026-08-21). The latest release is v0.1.1.
How does Korea Data Suite compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.