Quokka Korea Tools

npx add-mcp 'https://mcp.thequokkacompany.com/korea'

Quokka Korea Tools

A remote MCP server for things about South Korea that a language model tends to get wrong when it guesses.

Labor Day (노동절, May 1) and Constitution Day (제헌절, Jul 17) became public holidays in Korea in 2026. Models trained before that may not know, and they cannot see substitute holidays or election days announced later. These tools answer from data and fixed rules instead.

https://mcp.thequokkacompany.com/korea

Streamable HTTP, no sign-up, no key needed for the free tier.

Connect

Claude Code

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

Cursor, Windsurf, VS Code and other clients (mcp.json)

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

Claude.ai and Claude Desktop: Settings → Connectors → Add custom connector, paste the URL above.

Tools

kr_holidays	List South Korean public holidays (공휴일) for a year or a date range, with Korean names.
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.
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.
kr_count_business_days	Count South Korean business days between two dates (both ends included by default).
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원").
kr_korean_to_amount	Read a Korean money expression as an exact number: "1억 2천만 원", "삼백오십만원", "일금 일백만원정", "2.5억", "12만3천".
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.
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.
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.
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).
kr_name_split	Split Korean full names into family name and given name, recognizing two-character surnames (남궁, 황보, 제갈, 선우 …).
kr_mask_pii	Mask Korean personal data before you store, log or share it.
kr_legal_deadline	Compute when a period expires under the Korean Civil Act (arts.
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.
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일", "연말".

HTTP API

Every tool is also a plain endpoint: POST https://mcp.thequokkacompany.com/api/korea/<tool> with the arguments as a JSON body. Spec: /openapi.json. For agents: /llms.txt.

curl -s https://mcp.thequokkacompany.com/api/korea/kr_add_business_days \
  -H 'content-type: application/json' -d '{"start":"2026-09-23","days":3}'

Limits

• Free: 200 calls per day per client, reset at 00:00 Korea time.
• Paid keys with a higher daily limit are planned. Until they are on sale, the free tier is all there is.

What it does not do

• Holiday data covers 2024-2027 (KASI special-day data, last updated 2026-11-12). A temporary holiday announced after that date is missing until we add it. Other years return an error, not a guess.
• The business number check is the check-digit rule only. It does not ask the National Tax Service whether the business is open.
• Address splitting is rule-based. It does not look up the official road-name address database.

Privacy

Tool inputs are not stored or logged. For the daily limit we keep a salted hash of IP address and User-Agent, the tool name and a count per day. Nothing is sold or shared.

Made by The Quokka Studio · contact@thequokkacompany.com