Quokka Korea Tools
Server Details
Korean holidays, business days & legal deadlines, won amounts in words, NEIS/SMS byte counts
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 15 tools
Most tools target a clear, distinct task (address split, name split, phone format, PII masking, text count, amount conversion in each direction). The one soft cluster is date arithmetic — kr_business_day, kr_add_business_days, kr_count_business_days, kr_relative_date and kr_legal_deadline all touch business-day logic, and an agent could hesitate between 'add N business days' and 'legal deadline' without reading the descriptions carefully. The detailed descriptions largely resolve this, but the overlap keeps it below a 5.
All 15 tools share a consistent kr_ prefix and snake_case style with no camelCase or abbreviation drift. The internal word order varies (kr_add_business_days vs kr_address_split vs kr_amount_to_korean), so the verb/noun pattern is not uniform, but every name is predictable and readable.
15 tools sits squarely in the well-scoped range for a multi-domain utility kit. Each tool covers a distinct Korean-specific capability (holidays, business days, ages, amounts, addresses, names, phones, PII, text metrics) rather than duplicating functionality.
The surface covers the core Korean localization chores an agent would hit: date/holiday math, currency in both directions, age systems, address and name parsing, phone normalization, PII masking, and text counting. Minor gaps remain — no resident-registration-number validation (only masking), no forward Korean date-to-text rendering, and holiday data limited to 2024-2027 — but these are workable limits rather than dead ends.
Available Tools
15 toolskr_add_business_daysAdd Korean business daysARead-onlyIdempotentInspect
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 Constitution Day (Jul 17).
Inputs: days (required), start, extra_closed_dates.
kr_address_splitSplit Korean addressesARead-onlyIdempotentInspect
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.
Inputs: addresses (required).
kr_ageKorean age (만 나이)ARead-onlyIdempotentInspect
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.
Inputs: birth (required), on.
kr_amount_to_koreanNumber to Korean amount wordsARead-onlyIdempotentInspect
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.
Inputs: amount (required).
kr_business_dayIs it a Korean business day?ARead-onlyIdempotentInspect
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).
Inputs: date, extra_closed_dates.
kr_business_number_checkCheck Korean business registration numbersARead-onlyIdempotentInspect
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.
Inputs: numbers (required).
kr_count_business_daysCount Korean business daysARead-onlyIdempotentInspect
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).
Inputs: to (required), from (required), include_end, include_start, +1 more.
kr_holidaysKorean public holidaysARead-onlyIdempotentInspect
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).
Inputs: to, from, year.
kr_korean_to_amountKorean amount words to numberARead-onlyIdempotentInspect
Read a Korean money expression as an exact number: "1억 2천만 원", "삼백오십만원", "일금 일백만원정", "2.5억", "12만3천". Returns digits and comma form.
Inputs: text (required).
kr_legal_deadlineKorean legal deadline (민법 기간 계산)ARead-onlyIdempotentInspect
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 deadline moves to the next working day. Use for "within 14 days of receipt", "1 month from notice", contract terms. Not legal advice; some statutes set their own rules. 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).
Inputs: unit (required), amount (required), event_date (required), extra_closed_dates, +1 more.
kr_mask_piiMask Korean personal dataARead-onlyIdempotentInspect
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.
Inputs: text, items.
kr_name_splitSplit Korean namesARead-onlyIdempotentInspect
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.
Inputs: names (required).
kr_phone_formatNormalize Korean phone numbersARead-onlyIdempotentInspect
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.
Inputs: numbers (required), style.
kr_relative_dateKorean relative date to calendar dateARead-onlyIdempotentInspect
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.
Inputs: expressions (required), base_date.
kr_text_countKorean character and byte countARead-onlyIdempotentInspect
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.
Inputs: text (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Korean personal tax, payroll, labor, real estate and calendar calculators. Code, no LLM.
All KR Data tools in one server: Korean business checks, addresses, laws, car flood records & more
Exact Japanese text & date tools: char count, business days with JP holidays, era, tax, units.
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables accurate calculation of Korean public holidays, substitute holidays, and business days, with tools to check dates, list holidays, and compute working-day intervals. It works as a public MCP connector requiring no authentication or API keys.MIT
- AlicenseBqualityCmaintenanceExposes Korean-language utility tools to AI agents over a stdio MCP server, covering Hangul initial-consonant (chosung) extraction, conversion of integers into Korean currency words, lookup of Korean public holidays, and business-day checks for a given date.4Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA Korean life utility MCP server providing 15 tools for Hangul decomposition, romanization, number-to-Korean conversion, business number validation, holiday lookup, and more, all without external API calls.1-
- AlicenseAqualityBmaintenanceEnables AI agents to compute Korean corporate tax, income tax, VAT, withholding, deemed interest, penalties, and limitation periods using verified year-by-year rate tables, with every result citing its governing statute. Runs entirely locally with no API key, and returns an error rather than estimating for years lacking a verified table.1196,097 PyPI98MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.