Date Math
Deterministic date, time-zone, holiday and schedule calculations for AI agents
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 1.8.0
- Listing updated
- today
Similar MCP servers
About Date Math
Date Math is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
Models often get business-day counts, daylight-saving shifts and holiday calendars wrong. This server hands those calculations to code, offering 23 paid-per-call tools over MCP plus a free current-time tool.
Coverage goes beyond basic date arithmetic: public holidays for 207 countries from 2000 to 2050, a database of over 7,000 cities, market calendars for NYSE/Nasdaq, London and Tokyo, SLA clocks that pause outside working hours, Schengen-style 90/180 stay limits, subscription renewal dates and time buckets that handle 23- and 25-hour days.
The first 25 tool calls each day are free with no signup or key. After that each call costs $0.001 in USDC on Base through x402, paid automatically when a wallet key is set for the local npm package. It runs as a hosted Streamable HTTP endpoint or locally over stdio.
Install
Run in a terminal
claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://date-math.datemath.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"date-math": {
"url": "https://date-math.datemath.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"date-math": {
"type": "http",
"url": "https://date-math.datemath.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"date-math": {
"serverUrl": "https://date-math.datemath.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"date-math": {
"type": "http",
"url": "https://date-math.datemath.workers.dev/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
DATE_MATH_PRIVATE_KEYOptional. Key of a wallet holding USDC on Base, to pay $0.001 per call after the 25 free daily calls.DATE_MATH_MAX_PRICEOptional. The most to pay for one call (default $0.001).
Tools this server provides (24)
Taken from the project documentation; the running server may differ.
- date_diff
- Days, weeks, months and business days between two dates.
- date_add
- Adds days, weeks, months or business days to a date.
- timezone_convert
- Converts a time between IANA time zones.
- date_info
- Weekday, ISO week, quarter, day of year, leap year.
- public_holidays
- Public holidays for 207 countries.
- working_hours_overlap
- Finds overlapping working hours across zones.
- cron_schedule
- Explains a cron expression and lists next runs.
- parse_date_text
- Turns date phrases into ISO datetimes.
- city_time
- City name to time zone and local time.
- recurring_dates
- Expands an iCal RRULE into dates.
- business_hours_deadline
- SLA deadline N working hours ahead.
- business_day
- Checks whether a date is a business day.
- pay_dates
- Payroll and billing dates moved off weekends and holidays.
- stay_calculator
- Schengen-style 90/180 stay limits.
- timestamp_normalize
- Converts mixed timestamps to UTC.
- dst_check
- Daylight-saving changes and local time validity.
- sla_countdown
- Live SLA clock for support tickets.
- find_free_slots
- Meeting slots when everyone is free.
- subscription_dates
- Billing period, renewal and cancel-by dates.
- market_calendar
- Market sessions, holidays and settlement dates.
- date_range
- Phrases like last month to exact start and end.
- business_day_schedule
- Holiday-aware job schedules.
- time_buckets
- Time-series buckets that are DST-aware.
- current_time
- Current time in up to 10 zones, free.
What it does
- Business-day math
- Adds, subtracts and counts business days, skipping weekends and country holidays.
- Time-zone conversion
- Converts between IANA zones and handles daylight-saving gaps and repeats.
- Schedules and recurrence
- Explains cron, expands RRULEs and builds holiday-aware job schedules.
- SLA and business hours
- Computes deadlines and live countdowns that pause outside working time.
- Market calendars
- Reports open status, sessions, holidays and settlement dates for three exchanges.
- Natural-language dates
- Turns phrases like next Friday at 3pm or 2026-Q3 into exact ranges.
- Timestamp normalising
- Converts up to 100 mixed formats to UTC and flags ambiguous ones.
Good for
- Compute a support ticket's SLA deadline in working hours
- Find meeting slots that fit people in different time zones
- Check how many days are left in a 90/180 travel stay
- Schedule payroll dates that avoid weekends and holidays
- Normalise a column of mixed timestamps before analysis
Pricing
Freemium
25 free calls a day, then $0.001 per call in USDC on Base
Date Math FAQ
Is it free?
25 tool calls per day are free with no key; beyond that each call is $0.001 in USDC on Base.
Do I need an account?
No. The README says there is no signup and no API key.
How do I install it?
Use the hosted URL as a remote MCP server, or run the npm package date-math-mcp over stdio.
How many holiday calendars?
Public holidays for 207 countries, 2000 to 2050.
Is Date Math free?
Date Math has a free plan, with paid plans for more usage or features.
How do I add Date Math to Claude Code?
Run this command in your terminal: claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp
What are the best alternatives to Date Math?
The closest alternatives to Date Math are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


