Search / io.github.JowenDelaPena/date-math
Date Math
R0· no sign-inDate/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.
v1.5.0 · active · repository · website · descriptor JSON · versions
Search / io.github.JowenDelaPena/date-math
R0· no sign-inDate/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.
v1.5.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"date-math": {
"type": "http",
"url": "https://date-math.datemath.workers.dev/mcp"
}
}
}claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp[mcp_servers.date-math]
url = "https://date-math.datemath.workers.dev/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"date-math": {
"type": "remote",
"url": "https://date-math.datemath.workers.dev/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"date-math": {
"type": "http",
"url": "https://date-math.datemath.workers.dev/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=date-math&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZGF0ZS1tYXRoLmRhdGVtYXRoLndvcmtlcnMuZGV2L21jcCJ9"
}{
"servers": {
"date-math": {
"type": "http",
"url": "https://date-math.datemath.workers.dev/mcp"
}
}
}{
"mcpServers": {
"date-math": {
"httpUrl": "https://date-math.datemath.workers.dev/mcp"
}
}
}extensions:
"date-math":
enabled: true
name: "date-math"
type: streamable_http
uri: "https://date-math.datemath.workers.dev/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations13 of 13 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: date_add (destructiveHint); public_holidays (destructiveHint); parse_date_text (destructiveHint); …tools.token_costabout 3,639 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes, stability.rug_pulltool history recorded for 0 of the 7 days neededdeps.known_vulns, deps.mcp_sdk_version, deps.resolvabledependencies not resolved yetpay_datesaddedUpcoming 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).
business_dayaddedIs 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_deadlinechangeddescriptionSLA math in working hours: the deadline N business hours after a start time, or business time elapsed between two times. Custom hours and workdays, holidays, country public holidays, DST-aware. Costs $0.001 per call (x402).
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).
recurring_dateschangeddescriptionExpand an iCalendar RRULE ("every 2nd Tuesday", "Mon/Wed until June") into concrete dates and times in a time zone, DST-aware, with optional excluded dates. Costs $0.001 per call (x402).
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).
city_timechangeddescriptionFind the IANA time zone and current local time for up to 10 cities by name ("Cebu", "São Paulo", "Springfield" + country). 7,000+ cities. Costs $0.001 per call (x402).
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).
parse_date_textchangeddescriptionResolve natural-language dates like "next Friday at 3pm", "in 2 weeks" or "Dec 25 to Jan 2" to exact datetimes, relative to a reference time and time zone. Costs $0.001 per call (x402).
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).
cron_schedulechangeddescriptionExplain a cron expression in plain English and list its next run times in any time zone. Costs $0.001 per call (x402).
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).
working_hours_overlapchangeddescriptionFind when working hours overlap across time zones (meeting windows). Per-participant hours optional; skips weekends by default; up to 14 days. Costs $0.001 per call (x402).
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).
public_holidayschangeddescriptionPublic holidays for a country and year: 207 countries, 2000–2050. Lunar or government-proclaimed dates are rule-based estimates. Costs $0.001 per call (x402).
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).
date_infochangeddescriptionCalendar facts for a date: weekday, ISO week, quarter, day of year, leap year, weekend. Costs $0.001 per call (x402).
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).
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-0d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] npmnot resolved yet; dependencies are read once a day
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://date-math.datemath.workers.dev/mcp streamable-http | none | yes | 100% | 513 ms | 2025-11-25 | 2026-11-07 |
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
date-math-mcp | npm | 1.5.0 | – | DATE_MATH_PRIVATE_KEY |
business_dayread-only | 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_deadlineread-only | 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_timeread-only | 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_scheduleread-only | 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). |
date_addread-only | 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_diffread-only | 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_inforead-only | 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). |
parse_date_textread-only | 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_datesread-only | 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_holidaysread-only | 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_datesread-only | 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). |
timezone_convertread-only | 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_hours_overlapread-only | 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). |
Schemas: list_tools.
{
"name": "io.github.JowenDelaPena/date-math",
"title": "Date Math",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://date-math.datemath.workers.dev/mcp",
"type": "streamable-http"
}
],
"version": "1.5.0",
"packages": [
{
"version": "1.5.0",
"transport": {
"type": "stdio"
},
"identifier": "date-math-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "DATE_MATH_PRIVATE_KEY",
"isSecret": true,
"description": "Optional. Key of a wallet holding USDC on Base, to pay $0.001 per call after the 25 free daily calls."
},
{
"name": "DATE_MATH_MAX_PRICE",
"description": "Optional. The most to pay for one call (default $0.001)."
}
]
}
],
"repository": {
"url": "https://github.com/JowenDelaPena/date-math",
"source": "github"
},
"websiteUrl": "https://github.com/JowenDelaPena/date-math",
"description": "Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day."
}