public_holidays $0.002 per call

Returns the list of public holidays for a given country and year using https://date.nager.at/api/v3/PublicHolidays/<year>/<countryCode>. Each holiday includes date, local name, English name and whether it is a fixed/global holiday.

For AI agents: call public_holidays
POST https://toll402.dev/v1/t/public_holidays
{
 "countryCode": "US",
 "year": 2024
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "countryCode": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country code, e.g. US, BR, DE"
  },
  "year": {
   "type": "integer",
   "description": "Four-digit year, e.g. 2024"
  }
 },
 "required": [
  "countryCode",
  "year"
 ],
 "additionalProperties": false
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI