Best days to book
best_days_to_bookFind the days of annual leave to book around each public holiday (or cluster, such as Christmas and New Year) to get the most days off in a row: "book 4 days, get 10 off" options, cheapest first, with the exact dates. Use for "Which days should I book around Easter 2027 in Scotland?". Filter by holiday name (Easter, Christmas, Early May, Spring, Summer, St Patrick...). Past days are skipped. For parents in the UK, school: parent keeps leave inside the school holidays, using the council's published term dates when you pass council.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "best_days_to_book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of the date range, inclusive (yyyy-MM-dd). | |
| from | No | Start of a date range, instead of year (yyyy-MM-dd). | |
| year | No | Calendar year, e.g. 2027. Defaults to this year. | |
| region | No | Where the person works: england-and-wales, scotland or northern-ireland for UK bank holidays (from gov.uk); IE for Ireland; an Australian state or territory as AU-NSW, AU-VIC, AU-QLD, AU-WA, AU-SA, AU-TAS, AU-ACT or AU-NT (their public holidays differ a lot); US for US federal holidays; or a two-letter ISO 3166-1 country code such as DE or FR for other countries' public holidays (from Nager.Date). Defaults to england-and-wales, or to the council's nation when council is given. | |
| school | No | none (default); parent: children at school, so leave is only booked in the school holidays. UK only. School staff can't book leave in term: use plan_leave_year with school: staff. | none |
| council | No | With school: parent. The UK council whose term dates the school follows: its name ("Surrey", "Edinburgh"), its id ("surrey", "city-of-edinburgh") or the first half of a postcode ("GU1", "EH1"), looked up in Leave Hacker's own copy of the ONS list. Send only the first half of a postcode, not the full one. | |
| holiday | No | Only holidays whose name contains this, e.g. "Easter", "Christmas", "May". | |
| workdays | No | Days the person works, e.g. ["mon","tue","wed","thu"] for a four-day week. Defaults to Monday to Friday. | |
| us_holidays | No | US only: which holidays the person's employer gives. Private employers choose: common = the usual six (New Year's Day, Memorial Day, Independence Day, Labor Day, Thanksgiving, Christmas); federal = all 11 federal holidays; custom = the ones in us_holiday_ids. Default here: federal, to show every option. | federal |
| max_leave_days | No | Most days of leave for one break. Default 9. | |
| us_holiday_ids | No | US only, with us_holidays: custom. Any of: new-years-day, mlk-day, washingtons-birthday, memorial-day, juneteenth, independence-day, labor-day, columbus-day, veterans-day, thanksgiving, day-after-thanksgiving, christmas-day (day-after-thanksgiving isn't federal, but many employers give it). | |
| next_working_day_off | No | Ireland only: true if the person's employer gives the next working day off when a public holiday falls on a Saturday or Sunday (the civil service and banks do; Irish law doesn't require it, so the employer may give a day within a month, an extra day's leave or a day's pay instead). Adds those days, e.g. Mon 27 and Tue 28 Dec 2027. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| from | Yes | ||
| notes | Yes | ||
| region | Yes | ||
| school | Yes | ||
| source | Yes | ||
| council | Yes | The council whose published dates are used, or null for typical dates | |
| licence | Yes | ||
| workdays | Yes | ||
| sourceUrl | Yes | ||
| regionName | Yes | ||
| assumptions | Yes | ||
| attribution | Yes | Credit to show with the dates | |
| schoolYears | Yes | Where each school year's dates come from | |
| maxLeaveDays | Yes | ||
| trainingDays | Yes | The council's staff training (INSET) days: pupils are off, staff work | |
| opportunities | Yes |