# Quokka Korea Tools

> Quokka Korea Tools is a free MCP server for developer tools. Korean holidays, business days, won amounts, age and address tools for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://mcp.thequokkacompany.com
- **Repository:** https://github.com/rookie0031/korea-tools-mcp
- **MCP Registry name:** com.thequokkacompany/korea-tools
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Models often guess wrong about South Korea, and this server replaces the guess with fixed rules and data. The site notes that Labor Day (May 1) and Constitution Day (Jul 17) became public holidays in 2026, which a model trained earlier may not know, and holiday data comes from KASI special-day data covering 2024-2027 including substitute holidays and election days.

The tools go well beyond calendars: they write won amounts in Korean words and read them back as numbers, check business registration number check digits, compute 만 나이 and 연 나이, normalise phone numbers, split addresses and names (including two-character surnames), mask personal data, count text for NEIS and SMS byte limits, convert lunar and Gregorian dates and compute Civil Act deadlines.

Every tool also exists as a plain HTTP endpoint. Free use is 200 calls a day per client with no key; paid keys are planned but not yet on sale.

## Features

- **Holidays and business days:** Public holidays, business-day checks, and add or count business days.
- **Won amounts in words:** Converts amounts to Korean reading and contract forms and back, and checks words against digits.
- **Registration number check:** Validates the format and check digit of 사업자등록번호; offline, not an open or closed lookup.
- **Age and lunar dates:** International and year age, plus lunar-solar conversion with leap months.
- **Text cleanup:** Phone, address and name splitting and personal-data masking.
- **Legal deadlines:** Civil Act period calculation with weekend and holiday rules.

## Good for

- Compute a delivery date skipping Korean holidays
- Write a contract amount in 일금 form and verify it
- Validate business registration numbers in a spreadsheet
- Count characters and bytes for a job application or SMS
- Convert a lunar birthday to this year's date

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http korea-tools https://mcp.thequokkacompany.com/korea
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.thequokkacompany.com/korea
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "korea-tools": {
      "url": "https://mcp.thequokkacompany.com/korea"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "korea-tools": {
      "type": "http",
      "url": "https://mcp.thequokkacompany.com/korea"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "korea-tools": {
      "serverUrl": "https://mcp.thequokkacompany.com/korea"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "korea-tools": {
      "type": "http",
      "url": "https://mcp.thequokkacompany.com/korea"
    }
  }
}
```

## Tools

- `kr_holidays`: List South Korean public holidays (공휴일) for a year or a date range, with Korean names. Holiday data covers 2024-2027 (source: KASI; updated 2026-11-12). It includes substitute holidays and election days, and the 2026 additions Labor Day (May 1) and Constitution Day (Jul 17).
- `kr_business_day`: Check whether a date is a business day in South Korea (not a weekend and not a public holiday), and give the previous and next business days. Holiday data covers 2024-2027 (source: KASI; updated 2026-11-12). It includes substitute holidays and election days, and the 2026 additions Labor Day (May 1) and Constitution Day (Jul 17).
- `kr_add_business_days`: Move forward (or back, with negative days) a number of South Korean business days from a start date, skipping weekends and public holidays. The start date itself is not counted. Use for deadlines like "within 7 business days". Holiday data covers 2024-2027 (source: KASI; updated 2026-11-12). It includes substitute holidays and election days, and the 2026 additions Labor Day (May 1) and Constitutio
- `kr_count_business_days`: Count South Korean business days between two dates (both ends included by default). Also returns weekend and weekday-holiday counts. Holiday data covers 2024-2027 (source: KASI; updated 2026-11-12). It includes substitute holidays and election days, and the 2026 additions Labor Day (May 1) and Constitution Day (Jul 17).
- `kr_amount_to_korean`: Write a won amount in Korean words exactly: reading form ("백이십삼만 사천오백육십칠 원", spaced every 만 per Korean orthography), contract/receipt form ("일금 일백이십삼만사천오백육십칠원정"), and mixed form ("123만 4,567원"). Whole numbers below 10^20.
- `kr_korean_to_amount`: Read a Korean money expression as an exact number: "1억 2천만 원", "삼백오십만원", "일금 일백만원정", "2.5억", "12만3천". Returns digits and comma form.
- `kr_business_number_check`: Validate the format and check digit of South Korean business registration numbers (사업자등록번호, 10 digits, NTS weights 1,3,7,1,3,7,1,3,5) and format them as 123-45-67890. This is an offline checksum test only: it does not tell whether the business is open or closed.
- `kr_age`: Compute international age (만 나이, the legal standard in Korea since June 2023) and year age (연 나이, used by the Youth Protection Act and military service) on a reference date. Input a birth date, or the first 7 digits of a resident registration number (YYMMDD-G) to also get sex and century. Feb 29 birthdays turn a year older on Mar 1 in common years. The input is not stored.
- `kr_phone_format`: Normalize South Korean phone numbers (mobile 010, Seoul 02, regional 031-064, 070, 050x safe numbers, 15xx/16xx/18xx company numbers) to one style. Restores a leading 0 dropped by Excel, converts +82, keeps extensions. Unknown shapes return null.
- `kr_address_split`: Split South Korean addresses into province/city (시도, normalized to the official name such as 서울특별시), district (시군구, including 일반구 like 수원시 영통구), base address (road name + building number) and detail (unit). Handles leading postal codes and addresses written without spaces. Rule-based; does not look up a database.
- `kr_name_split`: Split Korean full names into family name and given name, recognizing two-character surnames (남궁, 황보, 제갈, 선우 …). Flags names that are ambiguous from the characters alone (선우진 = 선 + 우진 or 선우 + 진). Latin-script names use the last word as family name.
- `kr_mask_pii`: Mask Korean personal data before you store, log or share it. Text mode finds and masks resident registration numbers (900101-1******), phone numbers (010-****-5678), emails (ab****@x.com) and 16-digit card numbers inside free text. Item mode masks given values by kind, including names (홍*동). Nothing is stored or logged.
- `kr_legal_deadline`: Compute when a period expires under the Korean Civil Act (arts. 155-161), the default rule when a law or contract does not say otherwise: the first day is not counted unless the period starts at 00:00; weeks, months and years follow the calendar and end the day before the corresponding date (or at month end if that date does not exist); if the last day is a Saturday, Sunday or public holiday the d
- `kr_text_count`: Count Korean text exactly: characters with and without spaces (as Korean job sites count 자기소개서), lines, words, UTF-8 bytes, NEIS school-record bytes (Hangul 3, ASCII 1), and SMS/LMS bytes with the message type. Models see tokens, not characters, so use this instead of estimating length.
- `kr_relative_date`: Turn a Korean relative date expression into an exact date and weekday, counted from a base date in Korea time: 오늘/내일/모레/내일모레/글피, 어제/그제, "3일 뒤", "이틀 후", "2주 후", "한 달 뒤", "3영업일 후", "다음 주 화요일", "지난주 금요일", "이번 주말", "금요일", "다음 달 말일", "이번 달 25일", "내년 3월 1일", "연말". Weeks start on Monday. Also says whether the result is a Korean business day. Use this instead of working out weekdays yourself.
- `kr_lunar_convert`: Convert between the Korean lunar calendar (음력) and the Gregorian calendar using the Korea Astronomy and Space Science Institute standard, with leap months (윤달) and 간지. Korean and Chinese lunar dates differ in some years (2027 Lunar New Year: Korea Feb 7, China Feb 6), so do not use a Chinese lunar library for Korean dates. For a lunar birthday or memorial day (제사) give lunar_month_day and years to
- `kr_amount_check`: Find amounts written both in Korean words and in digits in a contract, quote or IOU, e.g. "일금 일백이십삼만원정(₩1,230,000)" or "1,230,000원(금 일백이십삼만원)", and check that the two agree. Mismatches come back with both values and the correct Korean words for the digits. You can also pass explicit pairs. Use before sending or signing a Korean document with amounts.

## FAQ

### Is there a free limit?

200 calls a day per client, reset at 00:00 Korea time, with no account or key.

### Does the business number check confirm the business exists?

No. It validates format and check digit offline and is not an open or closed lookup.

### What years of holidays are covered?

The README lists KASI data for 2024 to 2027.

### Is there an HTTP API?

Yes. Each tool is also a POST endpoint under /api/korea/ with an OpenAPI spec.

### What licence is the code?

MIT.

### Is Quokka Korea Tools free?

Yes. Quokka Korea Tools is free to use.

### How do I add Quokka Korea Tools to Claude Code?

Run this command in your terminal: claude mcp add --transport http korea-tools https://mcp.thequokkacompany.com/korea

### What are the best alternatives to Quokka Korea Tools?

The closest alternatives to Quokka Korea Tools are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/quokka-korea-tools
