lookup-holiday
Real public holiday lookup for 206 countries via a rule-based calendar engine. Paid via x402.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~590Tokens (tool definitions)
~6.2 KBTypical response size
Minimal attention impact (0.46% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"lookup-holiday": {
"url": "https://lookup-holiday.encodari.workers.dev/mcp"
}
}
}Remote endpoints
https://lookup-holiday.encodari.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (1)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
⚪lookup_holiday(country, state, region, year, language, ...)
Looks up real public/bank/school holidays for a country (and optionally a state/region) and year from a real rule-based calendar engine covering 206 countries — moveable holidays like Easter are computed astronomically, not guessed. Costs $0.01 USDC (Base) per call.
Input Schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code (e.g. \"US\", \"FR\", \"JP\")."
},
"state": {
"description": "Optional subdivision code within the country (e.g. \"CA\" for California in \"US\").",
"type": "string"
},
"region": {
"description": "Optional sub-region code within the state. Requires `state` to also be set.",
"type": "string"
},
"year": {
"description": "Calendar year to look up. Defaults to the current UTC year. Between 1900 and 2200.",
"type": "integer",
"minimum": 1900,
"maximum": 2200
},
"language": {
"description": "Optional ISO 639-1 language code for holiday names (e.g. \"es\"). Falls back to the country default.",
"type": "string"
},
"types": {
"description": "Optional filter: only return holidays of these types (e.g. [\"public\"]). Default: all types.",
"type": "array",
"items": {
"type": "string",
"enum": [
"public",
"bank",
"school",
"optional",
"observance"
]
}
}
},
"required": [
"country"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"valid": {
"type": "boolean",
"description": "false if the input (country/state/region/year/type) was invalid."
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Error message if valid is false; null otherwise."
},
"country": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"year": {
"type": "number"
},
"holidays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date (YYYY-MM-DD) of the holiday."
},
"name": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"public",
"bank",
"school",
"optional",
"observance"
]
},
"substitute": {
"type": "boolean",
"description": "true if this entry is a substitute day for a holiday that fell on a weekend."
}
},
"required": [
"date",
"name",
"type",
"substitute"
],
"additionalProperties": false
},
"description": "Holidays for the requested year, sorted by date."
}
},
"required": [
"valid",
"error",
"country",
"state",
"region",
"year",
"holidays"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded1 tools
verifiedversion not recorded1 tools