{"uid":"cap_DcA1mh2xKEA19ZeqW29nD","slug":"tanod-utilpeek-public-holidays-8e69e7ac","name":"Tanod utilpeek Public Holidays","description":"One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.","url":"https://tanod.dev/v1/holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"year":{"type":"integer","maximum":2100,"minimum":1990,"description":"Year (1990-2100)."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","maxLength":2,"minLength":2,"description":"ISO 3166-1 alpha-2 country code (e.g. US, GB, DE, PH, JP)."},"language":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2,3}(_[A-Za-z]{2,4})?$","maxLength":10,"minLength":2},{"type":"null"}],"default":null,"description":"Optional holiday-name language supported for that country (e.g. en_US); default en_US when supported."},"subdivision":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"default":null,"description":"Optional subdivision code or name for that country (e.g. CA or California for US)."}}},"responseSchema":{"type":"json","example":{"note":"Rules-based computation (no official calendar is consulted): public holidays as modelled by the library, including observed/substitute days. Lunar, religious and one-off holidays can be estimates or missing for some years; confirm with an official source for legal or payroll use.","year":2026,"count":12,"source":{"url":"https://github.com/vacanza/holidays","library":"python-holidays 0.106","license":"MIT"},"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","weekday":"Thursday"},{"date":"2026-01-19","name":"Martin Luther King Jr. Day","weekday":"Monday"},{"date":"2026-02-16","name":"Washington's Birthday","weekday":"Monday"}],"language":"en_US","subdivision":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C4BHgTexm4GFffgLLlQB7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official public holidays for a given country (and optional subdivision) for a specified year, covering 250 countries using python-holidays rules.","exampleAgentPrompt":"Can you pull up all the official public holidays in Germany for 2025, including any specific to Bavaria? I need the names in German if possible.","exampleUseCases":[{"title":"HR payroll calendar for a country","prompt":"List all the public holidays in the Philippines for 2025 so I can set up our payroll schedule correctly."},{"title":"Travel planning around local holidays","prompt":"What are the public holidays in Japan in April 2025? I want to know which days to avoid traveling so I can dodge crowds."},{"title":"App localization holiday schedule","prompt":"Give me all public holidays for France in 2026, in French, so I can build them into our scheduling app's calendar."}],"resultDescription":"A list of public holiday records for the requested country (and optional subdivision) and year, including each holiday's date and name (in the requested language where supported), computed from python-holidays rules across 250 countries.","failureModes":["Unsupported country code returns an error or empty result","Unsupported subdivision for a given country returns an error","Requested year outside 1990–2100 range is rejected","Unsupported language for the specified country falls back to default (en_US) or returns an error","Malformed country code (not 2-letter alpha) fails schema validation"],"whenToPreferThis":"Choose this endpoint when you need a programmatic, rules-based list of official public holidays for any of 250 countries, optionally filtered to a specific regional subdivision, for any year from 1990 to 2100. It is ideal for calendar applications, payroll systems, scheduling tools, and travel planners that need authoritative holiday data without maintaining their own country-specific rules.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:39:48.234Z","isFirstParty":false,"canonicalSlug":"tanod-utilpeek-public-holidays-8e69e7ac"}