Date Math MCP Server

by jowendelapena Your server? Claim it

answering

Date Math is answering right now. Last checked 5 min ago. It exposes 21 tools. Last commit 8 Nov 2026.

Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.

Uptime history 13 hours of history

13 hours agonow

100.0%

Uptime 24h

47 of 47 checks

Tools

read from the server

431 ms

Response time

average over 24h

Stars

last commit 8 Nov 2026

What changed 6

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 8 November 2026. No other catalogue keeps this.

8 Nov 5 tools appeared current_time, find_free_slots, market_calendar and 2 more

8 Nov a tool changed version

Nothing serious here today

Today is the operative word: we check Date Math every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add date-math --transport http https://date-math.datemath.workers.dev/mcp

Settings → Connectors → Add custom connector, then paste this address

https://date-math.datemath.workers.dev/mcp

~/.codex/config.toml

[mcp_servers.date-math]
url = "https://date-math.datemath.workers.dev/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "date-math": {
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "date-math": {
      "type": "http",
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

Available tools 21

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

date

date_add

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).

date_diff

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).

date_info

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).

business

business_day

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).

business_hours_deadline

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).

city

city_time

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).

cron

cron_schedule

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).

current

current_time

Free: the current date, time, weekday and UTC offset in up to 10 time zones, plus UTC and Unix time. Call this first whenever you need today's date; models do not know it. Does not use the daily free calls.

dst

dst_check

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).

free

find_free_slots

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).

market

market_calendar

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).

parse

parse_date_text

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).

pay

pay_dates

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).

public

public_holidays

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).

recurring

recurring_dates

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).

sla

sla_countdown

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).

stay

stay_calculator

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).

subscription

subscription_dates

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).

timestamp

timestamp_normalize

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).

timezone

timezone_convert

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).

working

working_hours_overlap

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).

Endpoints

URL	Transport	State	Latency	Checked
https://date-math.datemath.workers.dev/mcp	streamable-http	answering	239 ms	5 min ago

Alternatives to Date Math

same job, measured the same way

MCP Time

by infoinlet-marketplace

Time & date for AI agents — timezones, conversion, date math, diffs, cron, business days.

41 installs/wk local only

Plumbkit

by plumbkit

Exact utilities for agents: time zones, date math, business days, calculator, units, validation.

16 tools answering

Dropcoin Utility

by freshfos

Utility data for AI agents: IBAN, EU holidays, VAT rates, time zones, ECB FX. Pay per call.

5 tools answering

CalKit

by olsols4

Public holidays for 150+ countries, business-day maths and timezone lookup

answering

Bizdays

by qinisolabs

Verified business-day math for AI agents: holidays + per-country weekends, not guesses.

57 installs/wk local only

Australia Business Calendar MCP

by donniertf-hub

Australian business days and holiday-aware due dates for your AI agent.

3 tools answering

Everyday agent tools

by fourzerotwo

Time zones and world business days, VAT rates and maths, currency conversion, UK business days…

18 tools answering

Workday Calendar

by workers-regnotes-workday-calendar

Public holidays and business-day math (T+N, counts) for many countries; pay per call via x402

4 tools answering

Date Math — questions

Answers built from our own checks of this server.

What can Date Math do?

It exposes 21 tools, read directly from the server on our last check. Among them: business_day, business_hours_deadline, city_time, cron_schedule, current_time, date_add and 15 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Date Math mostly used for?

Its tools cluster around date and business. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Date Math working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 47 of 47 checks got a reply (100.0%), average response time 431 ms. The bar chart above shows every period we have measured.

How do I connect Date Math?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Date Math need an API key?

No. Date Math completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 21 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Date Math?

It answers our handshake in 431 ms on average, which is faster than 29% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Date Math open source?

The code is open source: it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The licence covers the code in the repository, not the hosted service at date-math.datemath.workers.dev, which runs on its operator's own terms.