---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/public-holidays
---
# Public Holidays

Public holiday data for 100+ countries. Look up all holidays in a year, check if a date is a holiday, or find the next upcoming holiday. Useful for scheduling automation, calendar integrations, and holiday-aware workflows.

- **Version:** 0.03
- **Categories:** data

## Skills (4)

### List Holidays (`holidays`)

Get all public holidays for a country and year. Returns holiday names, dates, types, and whether they are fixed or variable dates. Supports 100+ countries by ISO 3166-1 alpha-2 code.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `country` | string | Yes | ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE') |
| `year` | number | No | Year to get holidays for (defaults to current year) |

**Returns:** List of public holidays with names, dates, types, and fixed/variable status

**Examples:**

*US holidays for 2026:*

```json
{
  "country": "US",
  "year": 2026
}
```

### Check Holiday (`is_holiday`)

Check if a specific date is a public holiday in a given country. Returns the holiday details if it is, or confirms it is a regular day.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `date` | string | Yes | Date to check in YYYY-MM-DD format |
| `country` | string | Yes | ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE') |

**Returns:** Whether the date is a holiday, with holiday details if applicable

**Examples:**

*Is Dec 25 2026 a holiday in the US?:*

```json
{
  "date": "2026-12-25",
  "country": "US"
}
```

### Next Holiday (`next_holiday`)

Find the next upcoming public holiday for a country from today or from a specified date. Useful for scheduling and planning around holidays.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `country` | string | Yes | ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE') |
| `from_date` | string | No | Start date in YYYY-MM-DD format (defaults to today) |

**Returns:** Next upcoming public holiday with date, name, and number of days away

**Examples:**

*Next US holiday:*

```json
{
  "country": "US"
}
```

### Supported Countries (`supported_countries`)

List all countries supported by the public holidays API with their ISO codes and names.

**Returns:** List of supported countries with ISO codes and names

**Examples:**

*List supported countries:*

```json
{}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call public-holidays holidays --country US --year 2026

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"public-holidays","skill":"holidays","input":{"country":"US","year":2026}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I get the full holiday calendar for one country and year?

Yes. Use `holidays` with an ISO 3166-1 alpha-2 country code like `US` or `GB`, plus the year you want.

### How do I check whether one date is a holiday?

Use `is_holiday` with the country code and date. It tells you whether the day is a public holiday and returns the holiday details if it is.

### How do I find the next upcoming holiday?

Use `next_holiday` from today or from any date you care about. It is the fastest way to plan around the next break in a market.

### What if I am not sure which country codes are supported?

Call `supported_countries` first. It returns the supported countries with their ISO codes so you can pick the right one quickly.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs