Quokka Korea Tools

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

Ask a model whether 2026-05-01 is a public holiday in Korea and it will usually say no. It is: Labor Day (노동절) and Constitution Day (제헌절, Jul 17) became public holidays in 2026. 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.

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.

한국어

에이전트가 한국 공휴일·영업일, 한글 금액(일금 …원정), 사업자등록번호 검증, 만 나이, 전화번호·주소·이름 정리, 개인정보 가리기를 추측하지 않고 계산하게 하는 원격 MCP 서버입니다. 위 주소 하나만 클라이언트에 넣으면 됩니다. 만든 곳: 더쿼카스튜디오.

Made by The Quokka Studio · contact@thequokkacompany.com