Public Holiday Calendar (by Country and Year)

omnial/x402-holiday-calendar

Given an ISO 2-letter country code and a year, returns the country's public holidays for that year: each holiday's date, name, a type (public/bank/optional/school/observance), whether it applies nationwide or only in specific states/counties, and the total count.

activeper callv4

Price

$0.0325 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Nager.Date

Data from Nager.Date.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/x402-holiday-calendar" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/x402-holiday-calendar" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/x402-holiday-calendar", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/x402-holiday-calendar", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0325

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "country_code"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Year (default current year)"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Error code returned when the request cannot be fulfilled, e.g. an unrecognized country_code (observed: 'HTTP_400'). Present only on a rejected request, alongside `message`, in place of the holiday fields above."
    },
    "year": {
      "type": "number",
      "description": "The year requested, echoed back."
    },
    "message": {
      "type": "string",
      "description": "Human-readable explanation of the error, present only alongside `code`."
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "ISO 8601 date (YYYY-MM-DD)."
          },
          "name": {
            "type": "string",
            "description": "The holiday's public name, not a person's."
          },
          "type": {
            "type": "string",
            "description": "Observed values (US): 'Public', 'Bank', 'Optional', 'School', 'Observance'. Other countries may report additional values not seen here."
          },
          "fixed": {
            "type": "boolean",
            "description": "Whether the date is fixed on the calendar. Observed `false` on every one of the 17 entries captured -- `true` was never observed; treat as a genuine boolean, not a guaranteed-false sentinel."
          },
          "global": {
            "type": "boolean",
            "description": "Whether the holiday is observed nationwide (`true`) or only in specific states/counties (`false`, in which case `counties` lists them)."
          },
          "counties": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "State/county subdivision codes where a `global: false` holiday applies; observed `null` whenever `global` is `true`."
          },
          "local_name": {
            "type": "string",
            "description": "The holiday's name; observed identical to `name` on some entries and different on others (e.g. 'Presidents Day' vs. 'Washington's Birthday') -- not a person's identity, a naming variant of the holiday itself."
          }
        },
        "additionalProperties": true
      },
      "description": "e.g. 17 entries for US, 2026. A country/year with no holidays would presumably return an empty array, though that case was not observed."
    },
    "country_code": {
      "type": "string",
      "description": "The country code requested, echoed back."
    },
    "total_holidays": {
      "type": "number",
      "description": "Total number of entries in the holidays array."
    }
  },
  "description": "The holiday-calendar result. On a rejected request (e.g. an unrecognized country_code) the holiday fields are absent and only `code`/`message` are present.",
  "additionalProperties": true
}