Business-day and public-holiday math for 29 countries: add business days, days between, holidays.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. 'Bearer <key>' for higher limits. Works without a key.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add (or, with a negative number, subtract) business days to a date, skipping weekends and public holidays of the country (and region). Returns the result date and the holidays skipped. Read-only. Same engine, cache and limits as GET /v1/add.
Start date, YYYY-MM-DD (2020-2035).
Business days to add; negative counts backwards.
ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries.
Optional holiday types that close business days: comma list of public, bank (default: public; "all" = public,bank).
Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY).
Optional weekend days, comma list of day names like "sat,sun" (default) or "fri,sat", or "none".
Add (or, with a negative number, subtract) business days to a date, skipping weekends and public holidays of the country (and region). Returns the result date and the holidays skipped. Read-only. Same engine, cache and limits as GET /v1/add.
| Argument | Type | Description |
|---|---|---|
| date* | string | Start date, YYYY-MM-DD (2020-2035). |
| days* | integer | Business days to add; negative counts backwards. |
| types | string | Optional holiday types that close business days: comma list of public, bank (default: public; "all" = public,bank). |
| region | string | Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY). |
| country* | string | ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries. |
| weekend | string | Optional weekend days, comma list of day names like "sat,sun" (default) or "fri,sat", or "none". |
{
"type": "object",
"required": [
"country",
"date",
"days"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"description": "Start date, YYYY-MM-DD (2020-2035)."
},
"days": {
"type": "integer",
"maximum": 2500,
"minimum": -2500,
"description": "Business days to add; negative counts backwards."
},
"types": {
"type": "string",
"maxLength": 40,
"description": "Optional holiday types that close business days: comma list of public, bank (default: public; \"all\" = public,bank)."
},
"region": {
"type": "string",
"maxLength": 10,
"description": "Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries."
},
"weekend": {
"type": "string",
"maxLength": 40,
"description": "Optional weekend days, comma list of day names like \"sat,sun\" (default) or \"fri,sat\", or \"none\"."
}
},
"additionalProperties": false
}Count business days between two dates in a country (and region), excluding weekends and public holidays. The end date is excluded unless inclusive is true. Returns business, weekend and holiday day counts and the holidays in the range. Read-only. Same engine, cache and limits as GET /v1/between.
| Argument | Type | Description |
|---|---|---|
| to* | string | End date, YYYY-MM-DD (2020-2035). |
| from* | string | Start date, YYYY-MM-DD (2020-2035). |
| types | string | Optional holiday types that close business days: comma list of public, bank (default: public; "all" = public,bank). |
| region | string | Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY). |
| country* | string | ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries. |
| weekend | string | Optional weekend days, comma list of day names like "sat,sun" (default) or "fri,sat", or "none". |
| inclusive | boolean | Count the end date too (default false). |
List the public (and optionally bank/observance) holidays for one country (and region) in one year, 2020-2035, with local names, types and official source links. Read-only. Same data, cache and limits as GET /v1/holidays.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Year, 2020-2035. |
| types | string | Optional comma list of public, bank, observance, or "all" (default: all). |
| region | string | Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY). |
| country* | string | ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries. |
{
"type": "object",
"required": [
"country",
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2035,
"minimum": 2020,
"description": "Year, 2020-2035."
},
"types": {
"type": "string",
"maxLength": 40,
"description": "Optional comma list of public, bank, observance, or \"all\" (default: all)."
},
"region": {
"type": "string",
"maxLength": 10,
"description": "Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries."
}
},
"additionalProperties": false
}Check whether a date is a business day in a country (and region), considering weekends and public holidays. Returns the reason (weekend or holiday name) plus the previous and next business days. Read-only. Same engine, cache and limits as GET /v1/is-business-day.
| Argument | Type | Description |
|---|---|---|
| date* | string | Date to check, YYYY-MM-DD (2020-2035). |
| types | string | Optional holiday types that close business days: comma list of public, bank (default: public; "all" = public,bank). |
| region | string | Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY). |
| country* | string | ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries. |
| weekend | string | Optional weekend days, comma list of day names like "sat,sun" (default) or "fri,sat", or "none". |
{
"type": "object",
"required": [
"country",
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"description": "Date to check, YYYY-MM-DD (2020-2035)."
},
"types": {
"type": "string",
"maxLength": 40,
"description": "Optional holiday types that close business days: comma list of public, bank (default: public; \"all\" = public,bank)."
},
"region": {
"type": "string",
"maxLength": 10,
"description": "Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries."
},
"weekend": {
"type": "string",
"maxLength": 40,
"description": "Optional weekend days, comma list of day names like \"sat,sun\" (default) or \"fri,sat\", or \"none\"."
}
},
"additionalProperties": false
}List the supported countries (ISO codes), their regions and the supported year range. Read-only. Same data and limits as GET /v1/countries.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"country",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"description": "End date, YYYY-MM-DD (2020-2035)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"maxLength": 10,
"description": "Start date, YYYY-MM-DD (2020-2035)."
},
"types": {
"type": "string",
"maxLength": 40,
"description": "Optional holiday types that close business days: comma list of public, bank (default: public; \"all\" = public,bank)."
},
"region": {
"type": "string",
"maxLength": 10,
"description": "Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries."
},
"weekend": {
"type": "string",
"maxLength": 40,
"description": "Optional weekend days, comma list of day names like \"sat,sun\" (default) or \"fri,sat\", or \"none\"."
},
"inclusive": {
"type": "boolean",
"default": false,
"description": "Count the end date too (default false)."
}
},
"additionalProperties": false
}