Time of Meeting
Fair meeting times across time zones: find the overlap, convert times, make calendar links.
| Endpoint | https://timeofmeeting.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.2.0 |
| Now | 15 tools · grade A (92) · pin ts_0206de82cea954b73c7539144562cb1f · protocol 2025-06-18 |
| First / last listed | 2026-10-26 00:55 UTC / 2026-10-26 00:55 UTC |
| Grade over time | 2026-10-26: A (92), 15 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: find_best_meeting_time convert_time current_time_in_cities search_cities get_dst_changes create_meeting_link get_holidays days_between working_days_between add_days next_occurrence week_number business_hours_overlap dst_check age_duration
find_best_meeting_time | Propose up to three fair meeting times while the slot is still being chosen. Ranking does not take a meeting length. A city's public holiday down-ranks that slot and is named in the reasons. Each slot city says whether that date is a holiday. Each slot has a score and the reasons. The result has one https://timeofmeeting.com link that opens the planner with those cities, and next_step, which says params: cities*, start_date, end_date |
convert_time | Convert one city's local time into one or more other cities. Each city says whether that local date is a public holiday. The result includes a https://timeofmeeting.com link for a 60-minute meeting. Choose a different length with create_meeting_link. params: from*, to*, time* |
current_time_in_cities | Show the current local time, offset, work-hour band, and public holiday, if that date is one, for each city. The result includes a https://timeofmeeting.com link that opens the planner for the first city. weeks is the ISO week and the US week of the UTC date. params: cities* |
search_cities | Find cities by name. Each city includes its id, time zone, and country. The query is not repeated. params: query* |
get_dst_changes | List clock changes for one city. Defaults to the next year. Each change includes the local time and the ISO week and US week of that local date. The range can be at most 366 days. dst_changes still calls this tool. params: city*, start_date, end_date |
create_meeting_link | Build the invitation for one chosen slot. duration_minutes is the meeting length, chosen now, with the same choices as the planner Duration control. title is an optional meeting name, e.g. Weekly sync. Each city says whether that date is a public holiday. The first item is always the planner link: open this meeting on timeofmeeting.com (see and adjust it in the planner). formats then adds text to params: cities*, start*, title, duration_minutes, formats |
get_holidays | List public holidays for a country, an optional ISO 3166-2 region, or a city. Pass one year, a list of years so 2026, 2027, and 2028 can come back together, or a date range. Each holiday has the date, the weekday, whether it falls on Saturday or Sunday, whether it creates a long weekend of three or more days with Saturday and Sunday, the local name, the English name, whether it is regional, the re params: country, region, city, year, years, start_date, end_date |
days_between | Count calendar days from start to end. Both are YYYY-MM-DD. include_start and include_end default to false, so the count is the dates strictly after start and strictly before end: 2024-02-28 to 2024-03-01 is 1 in a leap year (29 February) and 0 in a common year. Set both to true to count every date from start through end (3 in that leap-year span, 2 otherwise). The count is negative when end is be params: start*, end*, include_start, include_end |
working_days_between | Count working days from start to end for one country. A working day is Monday to Friday and not a national public holiday. Saturday and Sunday are weekends, the same rule as the planner. Regional holidays are not skipped. include_start and include_end work the same way as days_between and default to false. Holiday dates are the bundled vacanza/holidays list (MIT) for 2026, 2027, and 2028. A date o params: start*, end*, country*, include_start, include_end |
add_days | Add a whole number of days, weeks, or working_days to a date. amount may be negative. unit weeks is seven calendar days: 3 weeks from Friday 2026-10-23 is 2026-11-13. unit working_days skips Saturday, Sunday, and that country's national public holidays, and the start date is not counted: 10 working days from Friday 2026-10-23 is 2026-11-06 when none of those weekdays is a holiday. country is requi params: date*, amount*, unit*, country |
next_occurrence | Find the next date on or after start that is the first, second, third, fourth, fifth, or last given weekday of its month. weekday is Mon, Tue, Wed, Thu, Fri, Sat, or Sun. start defaults to today (UTC). Example: start 2026-10-23, weekday Fri, occurrence last is 2026-10-30, the last Friday of October. If that month's occurrence is before start, the answer is in a later month: the first Monday on or params: start, weekday*, occurrence* |
week_number | Return only iso_week and us_week for one YYYY-MM-DD date. The response has those two numbers and nothing else: no date, weekday, year, or link. ISO weeks start on Monday, and week 1 contains the year's first Thursday: 2026-12-31 and 2020-12-31 are iso_week 53. The US week starts on Sunday, and 1 January is week 1 of that calendar year, so 2022-01-01 is iso_week 52 and us_week 1. 2027-01-01 is iso_ params: date* |
business_hours_overlap | Work-hour overlap for two to eight cities on one date. Uses the same overlap as the planner and find_best_meeting_time: work is 9:00–17:00 local, early or late is 7:00–9:00 and 17:00–19:00, and other hours are night. The result is that day's fair slot, with label best, fairest, or a shifted least-bad window, each city's local start and end, and the score. A public holiday in a city is named and lo params: cities*, date* |
dst_check | Say when a city's clocks next change, and whether a planned local time falls in the spring gap or the autumn overlap. from and to bound the search, YYYY-MM-DD. Pass both or neither. When omitted, the window is today (UTC) through 365 days later. The next change is the first offset change in that window, the same list get_dst_changes uses. weeks is iso_week and us_week of that next change, or null params: city*, from, to, planned_time |
age_duration | Age from start to end as calendar years, months, and days. end defaults to today (UTC). A birthday on 29 February does not become a whole year on 28 February of a common year: 2020-02-29 to 2021-02-28 is 0 years, 11 months, and 30 days. 2020-02-29 to 2024-02-29 is 4 years. The parts are negative when end is before start. total_days is the signed number of calendar days from start to end. The resul params: start*, end |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.