Public holidays by country (and is this date one?) ($0.001)
public_holidaysRead-onlyIdempotent
PAID ($0.001 USDC via x402). Every holiday Nager.Date lists for a country and year (nationwide and regional, with its types), and for one date (default today, UTC): isHoliday (a nationwide Public holiday only), the other nationwide and regional holidays that day, and the next nationwide public holiday that year. Coverage depends on the source: ~200 countries, not e.g. Saudi Arabia, the UAE or India (404); regional and observance coverage varies. A country or year it does not cover is 404, an outage 502 - not charged. Without payment this returns the 402 challenge; the fiatdock-mcp npm package pays automatically. Any answer the tool cannot produce is >= 400 and is NOT charged.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | A date (YYYY-MM-DD) to check: is it a holiday, and which is the next one after it. Default: today (UTC) when the year is the current one | |
| year | No | Year, 1976-2076 (default: the year of `date`, else the current UTC year) | |
| country | No | Country, ISO 3166-1 alpha-2 (US, DE, GB, BR, JP …). The covered list is https://date.nager.at/api/v3/AvailableCountries. An empty body answers for DE | |
| payment | No | Base64 of a single x402 v2 PaymentPayload (EIP-3009 transferWithAuthorization on Base USDC). OMIT it on the first call: the 402 you get back carries `howToPay.payloadTemplate` — the exact envelope to fill in — plus the price and the EIP-712 domain. Send it on the second call to complete the purchase; it is forwarded as the PAYMENT-SIGNATURE header, never as body data. Nothing is charged for the 402 itself, and a call that fails after payment settles nothing. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | ISO time the source was read (answers are cached up to 12 h) | |
| note | Yes | How isHoliday is decided, and what the source does and does not cover | |
| year | Yes | The year listed | |
| count | Yes | Holidays listed for the year | |
| source | Yes | Where the calendar came from | |
| country | Yes | ISO 3166-1 alpha-2 code | |
| holidays | Yes | Every holiday the source lists for the country and year, by date — nationwide and regional, all types | |
| defaulted | No | Present only when the body was empty: which subject the answer is for, and why | |
| isHoliday | Yes | True only when a NATIONWIDE holiday of type Public falls on dateChecked; null when no date was checked | |
| dateChecked | Yes | The date asked about (default today, UTC); null when another year was asked without a date | |
| nextHoliday | Yes | The first nationwide Public holiday after dateChecked in the same year; null when none remains that year (ask for the next year) or no date was checked | |
| holidaysOnDate | Yes | Nationwide holidays on dateChecked, of any type (a Bank-only or School-only day is here but does not set isHoliday) | |
| regionalHolidaysOnDate | Yes | Holidays on dateChecked that apply only in some regions |