Skip to content
MCP server

Quokka Korea Tools

Korean holidays, business days, won amounts, age and address tools for AI assistants

Status and history

Answered our latest tool-list check yesterday with 17 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
0.5.2
Listing updated
3 days ago

About Quokka Korea Tools

Quokka Korea Tools is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.thequokkacompany.com/korea
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "korea-tools": {
      "url": "https://mcp.thequokkacompany.com/korea"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (17)

Read directly from the server.

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.

What it does

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

Pricing

Free

200 calls/day free; paid keys planned

Prices change. Check mcp.thequokkacompany.com before you buy.

Quokka Korea Tools 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 to Quokka Korea Tools

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity