Metadata-Version: 2.4
Name: korea-data-mcp
Version: 0.1.1
Summary: MCP server for Korea Data Suite — Korean public holidays, business-day math, and MOLIT real-estate transactions as MCP tools.
Project-URL: Homepage, https://api.korea-data.cloud
Project-URL: Repository, https://github.com/choiyounggi/korea-data-suite
Author: choiyounggi
License: MIT
Keywords: api,holidays,korea,mcp,molit,public-data,real-estate
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2
Description-Content-Type: text/markdown

# Korea Data Suite — MCP server

<!-- mcp-name: io.github.choiyounggi/korea-data-mcp -->

An [MCP](https://modelcontextprotocol.io) server that exposes [Korea Data Suite](https://api.korea-data.cloud)
as tools, so AI agents (Claude Desktop/Code, Cursor, …) can query Korean public
data directly: public holidays & business-day math, and normalized MOLIT
real-estate transactions (apartment/officetel/land; sale/jeonse/monthly-rent).

## Tools

- `get_holidays(year, month?)` — Korean public holidays (incl. substitute/temporary)
- `check_holiday(date)` — is a date a holiday / business day?
- `add_business_days(date, days)` — add N business days (skips weekends & holidays)
- `count_business_days(start, end)` — business days in a range
- `list_real_estate_regions()` — LAWD region codes
- `get_real_estate_transactions(region, property_type?, trade_type?, date_from?, date_to?, limit?, cursor?)`

## Install & run

Bring your own API key (subscribe on the [RapidAPI listing](https://rapidapi.com/dch0202/api/korea-real-estate-holidays)):

```bash
KDS_API_KEY=<your key> uvx korea-data-mcp
```

Before it's on PyPI, install straight from the repo:

```bash
KDS_API_KEY=<your key> uvx --from "git+https://github.com/choiyounggi/korea-data-suite#subdirectory=packages/korea-data-mcp" korea-data-mcp
```

## MCP client config

```json
{
  "mcpServers": {
    "korea-data-suite": {
      "command": "uvx",
      "args": ["korea-data-mcp"],
      "env": {
        "KDS_API_KEY": "your-rapidapi-key",
        "KDS_API_BASE": "https://api.korea-data.cloud"
      }
    }
  }
}
```

Config env: `KDS_API_KEY` (required), `KDS_API_BASE` (default `https://api.korea-data.cloud`).

## License

MIT © choiyounggi
