mcpField
K
Korea Business Calendar

Korea Business Calendar

Local
appmonster.co.krProductivity0Updated 6d ago
RepositoryVisit website

About Korea Business Calendar

Korea Business Calendar is an MCP server for Korean public holidays, business-day calculations, and tax and payroll deadlines. It serves businesses and agents that need date planning based on entity type and employee status, with holiday adjustments applied to scheduled deadlines.

Key features

  1. 01List holidays, substitute holidays, and election days
  2. 02Add or count business days
  3. 03Find next or previous business day
  4. 04Filter tax deadlines by business profile
  5. 05Explain individual calendar rules

Use cases

  1. 01Review a company's filings due this month
  2. 02Calculate a delivery date after business days
  3. 03Check adjusted tax deadlines around holidays

MCP support

Provides MCP clients with tools for Korean holiday listings, business-day calculations, and tax-calendar queries.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "groove79-mcp-kr-biz-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kr-biz-calendar"
      ]
    }
  }
}
Run commandnpx -y @appmonster/mcp-kr-biz-calendar

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@appmonster/mcp-kr-biz-calendar0.1.1

Tools

5

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
yearintegerYes
extraHolidaysarrayNoAdditional holidays (e.g. from kr_holidays of the public-data server, or company days off)

Details

From the project README

@appmonster/mcp-kr-biz-calendar

MCP server for Korean business dates — no keys, no network. An agent gets:

  • Public holidays with computed 대체공휴일 and election days (2025–2028 lunar table built in)
  • Business-day math: "3 영업일 후", count business days between dates, next/previous business day
  • Tax & payroll calendar per business profile: 부가세 확정·예정, 종합소득세, 법인세, 원천세·4대보험 매월 10일, 지급명세서, 연말정산 — each moved to the next business day when it lands on a holiday (국세기본법 §5)

한국 사업자용 세무·노무 일정과 영업일 계산. 키 없이 바로 동작.

Tools

ToolWhat it does
kr_list_holidays연도별 공휴일 (대체공휴일·선거일 포함)
kr_is_business_day영업일 여부 + 다음/이전 영업일
kr_add_business_days영업일 더하기/빼기, 두 날짜 사이 영업일 수
kr_tax_calendar사업자 유형(개인·간이·법인·면세)·고용 여부별 신고 일정, 월/다가오는 N일 필터
kr_tax_rule일정 항목 설명 (무엇을, 누가, 언제)

Setup

{ "mcpServers": { "kr-biz-calendar": { "command": "npx", "args": ["-y", "@appmonster/mcp-kr-biz-calendar"] } } }

Examples

  • "이번 달 우리 회사가 신고할 거 뭐 있어?" → kr_tax_calendar {entity: "corporation", employees: true, month: 10}
  • "오늘 발송하면 영업일 3일 뒤 도착 — 언제?" → kr_add_business_days {days: 3}
  • "1/25가 일요일인데 부가세 언제까지?" → calendar already returns 2026-01-26 (shifted)

Coverage & accuracy

  • Lunar holidays (설날·추석·부처님오신날) are tabled for 2025–2028. For other years pass extraHolidays from the public-data server's kr_holidays (official KASI data); the tools say so in note.
  • Substitute-holiday rules follow the 2023 amendment (all holidays except 신정·현충일; overlaps count).
  • Deadlines encode standard rules for a 12월 결산 법인 and calendar-year individuals. Special regimes (성실신고확인, 반기납부, 수정신고) are noted in what, not computed. Always confirm with 홈택스 notices; this is a scheduling aid, not tax advice.

Development

pnpm --filter @appmonster/mcp-kr-biz-calendar test

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.