mcpField
W
World Business Calendar

World Business Calendar

Local
okagent.krProductivity0Updated 6d ago
RepositoryVisit website

About World Business Calendar

World Business Calendar is an MCP server for checking public holidays and business-day dates across more than 200 countries and regions. It accounts for local weekends and observed holidays, and works offline without API keys.

Key features

  1. 01List country and regional holidays
  2. 02Check business-day status
  3. 03Add or subtract business days
  4. 04Find shared business days across countries
  5. 05Support local weekends and observed holidays

Use cases

  1. 01Check whether a date is a working day in another country
  2. 02Calculate a deadline several business days away
  3. 03Find a date suitable for cross-border meetings or settlements

MCP support

Exposes tools for holiday lookup and business-day calculations to MCP clients. It can run locally or be accessed through a hosted Streamable HTTP endpoint.

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-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
Run commandnpx -y @appmonster/mcp-world-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-world-calendar0.1.0

Tools

5

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
yearintegerYes
typesarrayNo
regionstringNoOptional state/region code, e.g. CA (California) for US, BY (Bavaria) for DE. Regional holidays differ.
countrystringYesISO 3166-1 alpha-2 country code, e.g. US, GB, DE, JP, IN, AE

Details

From the project README

World Business Calendar MCP

Agents get dates wrong. This server answers "is it a working day there?" and "what date is 5 business days from now?" for 200+ countries and their states/regions, with local weekends (Friday–Saturday in Saudi Arabia, Israel, Egypt; Friday in Iran) and observed/substitute holidays. Offline, no API keys.

npx -y @appmonster/mcp-world-calendar

Hosted (no install): https://okagent.kr/api/mcp (Streamable HTTP) — or REST https://okagent.kr/api/tools.

ToolWhat it does
world_list_holidaysHolidays of a country/region for a year (English + local names, public/bank/optional)
world_is_business_dayWorking day or not, next/previous working day (default: today in that country)
world_add_business_daysAdd/subtract N working days, or count working days between two dates
world_common_business_daysDates that are working days in all of several countries (cross-border meetings, settlements)
world_list_countriesSupported country and region codes

Claude Desktop config:

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

Data: date-holidays (ISC code, holiday data CC-BY-3.0, © commenthol and contributors). Korea uses the K-MCP Korean engine (includes 2026 changes). Part of K-MCP. MIT.

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.