{"id":"io.github.JowenDelaPena/date-math","slug":"io-github-jowendelapena-date-math","title":"Date Math","description":"Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.","version":"1.8.0","publisher":{"kind":"github","id":"JowenDelaPena","label":"@JowenDelaPena on GitHub","url":"https://github.com/JowenDelaPena"},"website":"https://github.com/JowenDelaPena/date-math","repository":"https://github.com/JowenDelaPena/date-math","remotes":[{"type":"streamable-http","url":"https://date-math.datemath.workers.dev/mcp"}],"packages":[{"registryType":"npm","identifier":"date-math-mcp","version":"1.5.0","transport":{"type":"stdio"},"environmentVariables":[{"description":"Optional. Key of a wallet holding USDC on Base, to pay $0.001 per call after the 25 free daily calls.","isSecret":true,"name":"DATE_MATH_PRIVATE_KEY"},{"description":"Optional. The most to pay for one call (default $0.001).","name":"DATE_MATH_MAX_PRICE"}]}],"published":"2026-11-10","updated":"2026-11-10","status":"online","auth":"","latency_ms":1043,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"date_diff","title":"Date difference","description":"How many days, weeks, months or business days between two dates or datetimes: calendar (Y/M/D), totals, and business days (weekdays in [from, to) minus holidays; pass country to exclude its public holidays). Use for age, tenure, countdowns, notice periods and working days until a deadline. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"date_add","title":"Add to a date","description":"Add or subtract years/months/weeks/days/business days/hours/minutes/seconds from a date. Month-end clamping; business days skip weekends, given holidays, and the public holidays of an optional country. Use for due dates, deadlines, delivery estimates, expiry and \"N working days from today\". First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"timezone_convert","title":"Convert time zones","description":"Convert a time between time zones (IANA names like Asia/Manila, America/New_York), DST-aware. Use for \"what time is 3pm Manila in New York\", scheduling across zones and UTC offsets. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"date_info","title":"Date facts","description":"Calendar facts for a date: day of the week, ISO week number, quarter, day of year, leap year, weekend. Use for \"what day is\", week numbers and fiscal quarters. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"public_holidays","title":"Public holidays","description":"List public holidays (bank holidays, national holidays) for a country and year: 207 countries, 2000–2050. Use for holiday calendars, office closures and checking if a date is a holiday. Lunar or government-proclaimed dates are rule-based estimates. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"working_hours_overlap","title":"Working-hours overlap","description":"Find when working hours overlap across time zones: the best meeting times for a distributed or remote team. Per-participant hours optional; skips weekends by default; up to 14 days. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"cron_schedule","title":"Cron schedule","description":"Explain a cron expression in plain English and list its next run times in any time zone. Use to check or debug crontab and scheduled-job schedules. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"parse_date_text","title":"Parse natural-language dates","description":"Parse natural-language dates and relative times like \"next Friday at 3pm\", \"in 2 weeks\", \"tomorrow morning\" or \"Dec 25 to Jan 2\" into exact ISO datetimes, relative to a reference time and time zone. Use before acting on any date a user typed. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"city_time","title":"City time zone and local time","description":"Find the time zone and current local time in up to 10 cities by name (\"Cebu\", \"São Paulo\", \"Springfield\" + country). 7,000+ cities. Use for \"what time is it in\" questions and to get the IANA zone the other tools need. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"recurring_dates","title":"Expand recurring events (RRULE)","description":"Expand a recurring event or iCalendar RRULE (\"every 2nd Tuesday\", \"Mon/Wed until June\") into concrete dates and times in a time zone, DST-aware, with optional excluded dates. Use for repeating meetings, calendar invites and schedules. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"business_hours_deadline","title":"Business-hours deadline / SLA","description":"SLA math in working hours: the deadline N business hours after a start time, or business time elapsed between two times. Use for support-ticket SLAs, response-time targets and office-hours deadlines. Custom hours and workdays, holidays, country public holidays, DST-aware. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"business_day","title":"Business-day check","description":"Is a date a business day? If not, why (weekend, or which public holiday). Also the next and previous business day, and the month's business-day count, first and last business day. Use for office-open checks, shipping cut-offs, settlement dates. Country holidays, custom holidays and custom workweeks (e.g. Sun–Thu, Mon–Sat). First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"pay_dates","title":"Payroll and billing dates","description":"Upcoming pay or billing dates for monthly, semi-monthly (e.g. 15th and last day), biweekly or weekly schedules, moved off weekends and public holidays (to the previous, next or nearest business day). Use for payroll calendars, invoice due dates and recurring billing. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"stay_calculator","title":"Visa stay calculator (Schengen 90/180)","description":"Rolling stay-limit math such as the Schengen 90/180 rule: days used in the window, days left, overstay check, the longest stay allowed from a planned entry date, and the next date a full stay is possible. Entry and exit days both count. Custom rules via max_days/window_days. Use for travel planning, visa-free stays and \"can I enter on\". First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"timestamp_normalize","title":"Normalize timestamps","description":"Detect and convert up to 100 mixed timestamps to UTC ISO 8601: Unix seconds/ms/µs/ns, Excel serial dates, Windows FILETIME, ISO 8601, RFC 2822, YYYY/MM/DD, month-name dates. Flags ambiguous values (03/04/2026: March 4 or 3 April? 45000: Excel date or Unix seconds?) with alternatives. Use for cleaning CSV, log and spreadsheet data. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"dst_check","title":"DST transitions and local-time check","description":"Daylight saving time for a time zone: does it observe DST, the year's exact clock changes (UTC instant, local before/after), and whether a local time is valid, skipped (spring-forward gap, e.g. 02:30) or repeated (fall-back, happens twice). Use before scheduling jobs, alarms or meetings near clock changes. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"sla_countdown","title":"SLA countdown (business hours)","description":"Live SLA clock for a support ticket: business minutes elapsed and remaining, breached or not, and the deadline. The clock pauses outside working hours, on weekends and holidays, and during manual pauses (e.g. waiting on customer). Custom hours, workdays, country holidays, DST-aware. Use for support-agent SLA tracking and escalation. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"find_free_slots","title":"Find free meeting slots","description":"Find meeting times when everyone is free: intersects each participant's working hours (own time zone, workdays, country holidays) minus their busy blocks, then lists slots of the requested length. Up to 10 people, 14 days, optional buffer between meetings. Use for scheduling across calendars and time zones. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"subscription_dates","title":"Subscription renewal and proration","description":"Subscription and contract date math: current billing period, next renewal, upcoming renewals, cancel-by date for a notice period, free-trial start, and day-based proration of a price. Month-end anchors stay at month end (Jan 31, Feb 28, Mar 31). Use for SaaS billing, renewals, cancellation deadlines and refunds. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"market_calendar","title":"Stock market hours and holidays","description":"Stock exchange calendar for NYSE/Nasdaq, London (LSE) and Tokyo (JPX): is the market open now, today's session (early closes, lunch break), next open and close, holidays, previous/next trading day, and the trade settlement date (T+1/T+2). Use for trading agents, order timing and settlement. First 25 calls per day are free, then $0.001 per call (x402).","read_only":true},{"name":"date_range","title":"Reporting period to exact dates","description":"Turn a reporting period into exact start and end dates and times in a time zone: \"last month\", \"this quarter\", \"YTD\", \"MTD\", \"last 7 days\", \"next 2 weeks\", \"2026-Q3\", \"2026-W14\". Optional comparison period (previous period, or same period last year), fiscal years starting in any month, and Monday, Sunday or Saturday week starts. Use for analytics queries, SQL date filters, reports and dashboards. ","read_only":true},{"name":"business_day_schedule","title":"Business-day job schedule","description":"Job schedules that skip weekends and public holidays, which cron cannot express: \"3rd business day of the month at 09:00\", \"last business day\", \"every Monday, or the next business day if it is a holiday\", or any cron with a holiday rule. Returns the next runs and whether it runs today. DST-aware. Use for payroll, billing, reports and batch jobs. First 25 calls per day are free, then $0.001 per cal","read_only":true},{"name":"time_buckets","title":"Time buckets for charts","description":"Split a time range into minute, hour, day, week, month, quarter or year buckets with exact start and end times in a time zone. DST-aware (23- and 25-hour days, repeated and skipped hours), ISO or Sunday/Saturday weeks, fiscal quarters, partial first and last buckets flagged or clipped. Up to 1,000 buckets (500 for weeks and longer). Use for chart axes, time-series grouping and filling empty period","read_only":true},{"name":"current_time","title":"Current date and time (free)","description":"Free: the current date, time, weekday and UTC offset in up to 10 time zones, plus UTC and Unix time. Use when today's date or the current time is needed. Does not use the daily free calls.","read_only":true}],"server_info":{"name":"date-math","title":"Date Math","version":"1.8.0"},"category":"agents","tags":["productivity"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-07","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-jowendelapena-date-math/"}