Skip to main content
Glama

get_public_holidays

Read-onlyIdempotent

utilpeek: public holidays of a country for a year. To count working days use count_or_add_business_days. An unsupported country, subdivision, language or year is a 422 naming the supported values (not charged). Typically under 0.1 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day. Computed from the python-holidays rules (MIT), not an official calendar: lunar, religious and one-off holidays can be estimates or missing for some years; confirm with an official source for legal or payroll use. Docs: https://tanod.dev/learn/public-holidays-api.html

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "country": "<country>",
      "year": "<year>"
    },
    "name": "get_public_holidays"
  }
}

Input Schema

NameRequiredDescriptionDefault
yearYesYear.
countryYesISO 3166-1 alpha-2 country code (e.g. US, GB, PH).
languageNoHoliday-name language (e.g. en_US).
subdivisionNoSubdivision code or name (e.g. CA).

Output Schema

NameRequiredDescriptionDefault
noteNo
yearNo
countNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
sourceNo
countryNo
holidaysNo
languageNo
subdivisionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • removedInput schema / properties / country / title
      Removed value: -"Country"
    • removedInput schema / properties / language / default
      Removed value: -null
    • changedInput schema / properties / language / description
      Previous value: -"Optional holiday-name language (e.g. en_US)."New value: +"Holiday-name language (e.g. en_US)."
    • removedInput schema / properties / language / title
      Removed value: -"Language"
    • removedInput schema / properties / subdivision / default
      Removed value: -null
    • changedInput schema / properties / subdivision / description
      Previous value: -"Optional subdivision code or name (e.g. CA)."New value: +"Subdivision code or name (e.g. CA)."
    • removedInput schema / properties / subdivision / title
      Removed value: -"Subdivision"
    • changedInput schema / properties / year / description
      Previous value: -"Year (1990-2100)."New value: +"Year."
    • removedInput schema / properties / year / title
      Removed value: -"Year"
    • removedInput schema / title
      Removed value: -"get_public_holidaysArguments"
    • removedOutput schema / properties / holidays / items
      Removed value: -{
      -  "properties": {
      -    "date": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "weekday": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / source / properties
      Removed value: -{
      -  "library": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "license": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "url": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "count": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "country": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "holidays": {
      +      "items": {
      +        "properties": {
      +          "date": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "weekday": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "language": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "note": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source": {
      +      "properties": {
      +        "library": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "subdivision": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "year": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources