Japan & World Public Holidays MCP Server

by omikuji Your server? Claim it

answering

Japan & World Public Holidays is answering right now. Last checked 5 min ago. It exposes 4 tools.

Public holidays, business days and long weekends for Japan (Cabinet Office) and 245 other countries.

Uptime history 23 hours of history

23 hours agonow

100.0%

Uptime 24h

83 of 83 checks

Tools

read from the server

123 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check Japan & World Public Holidays every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add holiday --transport http https://holiday.omikuji.dev/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "holiday": {
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.holiday]
url = "https://holiday.omikuji.dev/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "holiday": {
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "holiday": {
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}

Available tools 4

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

business

business_days

Count business days between start and end (inclusive), or find the date that is N business days after start (add=N; negative N goes backward; start itself is not counted). Business day = weekday that is not a national holiday. Set year_end_closed to also skip 12/29-1/3. With country, uses that country's weekend days, holidays and make-up workdays.

dates

check_dates

For each date, tell whether it is a Japanese national holiday (with name and kind: 祝日 / 振替休日 / 国民の休日), a weekend, and a business day. Also returns today in Japan time. With country, the same for that country (holiday names, status, make-up workdays such as China's 调休).

holidays

list_holidays

List Japanese national holidays for a year, or between from and to. With no arguments, lists the next 10 holidays from today (Japan time). With country, lists that country's public holidays (and make-up workdays, if any).

long

find_long_weekends

Find 連休 (3+ consecutive days off made of weekends and national holidays), e.g. Golden Week, Silver Week. Give a year, or from (default today) to list upcoming ones. With country, the same for that country.

Endpoints

URL	Transport	State	Latency	Checked
https://holiday.omikuji.dev/mcp	streamable-http	answering	88 ms	5 min ago

Alternatives to Japan & World Public Holidays

same job, measured the same way

WorkdayAPI

by workers-mike-tusa-workdayapi

Business-day and public-holiday math for 29 countries: add business days, days between, holidays.

5 tools answering

CalKit

by olsols4

Public holidays for 150+ countries, business-day maths and timezone lookup

answering

Business Days

by profitpather-tools

Public holidays and working-day maths for 200+ countries, cross-checked across three providers.

4 tools answering

Business Days and Holidays

by openkrill

Count working days between two dates, add business days to a date, or list public holidays.

5 tools answering

Africa Compliance Data

by africacompliancedata

Public holidays, business days, VAT, withholding tax and tax-ID checks for 54 African countries

answering

PlugRail Japanese Calendar

by plugrail

Japanese holiday and business-day calculations using official Japan Cabinet Office data.

4 tools answering

Ja Normalize

by kojimahyui01

Holidays/business days for 200+ countries; Japanese address, name, bank and company normalization.

35 installs/wk local only

Japan Business Day

by rira365

Japan business days & holidays (official Cabinet Office data). Free tool + x402 USDC paid tools.

11 tools answering

Japan & World Public Holidays — questions

Answers built from our own checks of this server.

What can Japan & World Public Holidays do?

It exposes 4 tools, read directly from the server on our last check. Among them: business_days, check_dates, find_long_weekends, list_holidays. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Japan & World Public Holidays working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 83 of 83 checks got a reply (100.0%), average response time 123 ms. The bar chart above shows every period we have measured.

How do I connect Japan & World Public Holidays?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Japan & World Public Holidays need an API key?

No. Japan & World Public Holidays completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 4 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Japan & World Public Holidays?

It answers our handshake in 123 ms on average, which is faster than 80% of all working MCP servers we measure. That puts it in the quick quarter of the ecosystem. The comparison comes from our own checks across the whole registry, every 15 minutes.