Date Math
REMOTE · DATE-MATH.DATEMATH.WORKERS.DEV · 2 COMPONENTS
Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.
Available components
Last scanned (19 hours ago)
Scores higher than 45% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Productivity and Notes
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 1 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS enforcement could not be verified: the plaintext port answered with HTTP 405, which proves neither a plaintext path nor enforcement. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability55
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 5402 tokens (~225/item across 24 items; 24 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management47
- Stability observed for 14 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage92
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 73% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "pay_dates" implies "pay" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Fail
- An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (11)
- TLS certificate
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (2)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Authorization in Endpoint SecurityAuthorisation not fully verified: no authorisation is required to call this server, and 1 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
- HTTPS in Endpoint SecurityHTTPS enforcement could not be verified: the plaintext port answered with HTTP 405, which proves neither a plaintext path nor enforcement.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Nov 26 +1
- Tool “current_time” rewrote its description, which is the text the model reads security
- Schema quality: 196 → 225 ▼ functional
- Tool coverage: 67% → 73% ▲ functional
- Server version: 1.7.0 → 1.8.0 functional
- New tool “business_day_schedule” functional
- New tool “date_range” functional
- New tool “time_buckets” functional
- 8 Nov 26 +1
- Schema quality: 2493 → 4127 ▼ functional
- Stability: unverified → 0.03 ▲ functional
- Server version: 1.5.0 → 1.7.0 functional
- New tool “current_time” functional
- New tool “dst_check” functional
- New tool “find_free_slots” functional
- New tool “market_calendar” functional
- New tool “sla_countdown” functional
- New tool “stay_calculator” functional
- New tool “subscription_dates” functional
- New tool “timestamp_normalize” functional
- 7 Nov 26 54
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://date-math.datemath.workers.dev/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=datemath.workers.dev | CN=YE2,O=Let's Encrypt,C=US | 7 Nov 2026 | 5 Feb 2027 | ECDSA 256 | ECDSA-SHA384 | 5f6b2152957e72d1ca6292d15fa4f33a9b5 |
| SANs: *.datemath.workers.dev, datemath.workers.dev | ||||||
| CN=YE2,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 4df3b15dd6c0784c507cd37b58e6f115 |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of date-math.datemath.workers.dev. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| dev. | DS published | 60074 | 8 | Verified |
| workers.dev. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://date-math.datemath.workers.dev/mcp | Verified | 200 | |
| http (plaintext) | http://date-math.datemath.workers.dev/mcp | Inconclusive | 405 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
business_day Business-day check ~242
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).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| date | string | yes | – |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | – |
| holiday | string|null | yes | Holiday name if the date is a holiday |
| is_business_day | boolean | yes | – |
| month | object | yes | – |
| next_business_day | string | yes | – |
| previous_business_day | string | yes | – |
| reason | string|null | yes | Why it is not a business day; null if it is |
| weekday | string | yes | – |
No examples provided.
business_day_schedule Business-day job schedule ~497
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 call (x402).
| Name | Type | Req | Description |
|---|---|---|---|
| adjust | string | – | For weekend/holiday dates. modified_following: next, unless that is next month, then previous. following/preceding work |
| check_date | string | – | – |
| count | integer | – | Runs to return |
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| day | – | – | 1–31 (31 = month end in short months) or "last" |
| expression | string | – | Cron, 5 or 6 fields, max 96 runs a day |
| from | string | – | Runs at or after: date, local datetime or ISO 8601. Default now |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| months | array | – | Only these months, e.g. [1,4,7,10] |
| n | integer | – | 1 = first business day of the month, -1 = last, -2 = second to last |
| rule | string | yes | nth_business_day (n), day_of_month (day), weekly (weekdays), cron (expression). "last business day" and "first business day" work |
| time | string | – | Local HH:MM (not for cron) |
| timezone | string | – | IANA zone (default UTC) |
| weekdays | array | – | 0 = Sunday, e.g. [1] for Mondays |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| Name | Type | Req | Description |
|---|---|---|---|
| adjust | string | yes | – |
| check | object | yes | – |
| count | integer | yes | – |
| description | string | yes | – |
| from | string | yes | – |
| note | string | – | – |
| rule | string | yes | – |
| runs | array | yes | – |
| timezone | string | yes | – |
No examples provided.
business_hours_deadline Business-hours deadline / SLA ~241
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).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| end | string | – | Count business time from start to end (max 1 year) |
| holidays | array | – | – |
| hours | number | – | – |
| minutes | number | – | – |
| start | string | – | Local datetime in timezone or ISO 8601 with offset; default now |
| timezone | string | yes | IANA time zone, e.g. Asia/Manila |
| work_end | string | – | – |
| work_start | string | – | – |
| workdays | array | – | 0 = Sunday; default [1,2,3,4,5] |
| Name | Type | Req | Description |
|---|---|---|---|
| business_hours | number | – | – |
| business_minutes | number | yes | – |
| deadline | string | – | – |
| deadline_utc | string | – | – |
| end | string | – | – |
| mode | string | yes | – |
| start | string | yes | – |
| timezone | string | yes | – |
| weekday | string | – | – |
No examples provided.
city_time City time zone and local time ~159
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).
| Name | Type | Req | Description |
|---|---|---|---|
| at | string | – | ISO 8601 instant to show local time for; default now |
| cities | array | – | – |
| city | string | – | – |
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| Name | Type | Req | Description |
|---|---|---|---|
| at | string | yes | – |
| results | array | yes | – |
No examples provided.
cron_schedule Cron schedule ~111
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).
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | Default 5 |
| expression | string | yes | 5- or 6-field cron expression |
| from | string | – | ISO 8601 datetime with offset; default now |
| timezone | string | – | Default UTC |
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | yes | – |
| expression | string | yes | – |
| from | string | – | – |
| next_runs | array | yes | – |
| timezone | string | yes | – |
No examples provided.
current_time Current date and time (free) ~91
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.
| Name | Type | Req | Description |
|---|---|---|---|
| timezone | string | – | IANA time zone, e.g. Asia/Manila |
| timezones | array | – | Up to 10 IANA time zones (default UTC) |
| Name | Type | Req | Description |
|---|---|---|---|
| times | array | yes | – |
| unix_ms | integer | yes | – |
| unix_seconds | integer | yes | – |
| utc | string | yes | – |
No examples provided.
date_add Add to a date ~316
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).
| Name | Type | Req | Description |
|---|---|---|---|
| business_days | integer | – | Applied after calendar units; skips rest days (see workdays) and holidays |
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| date | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| days | integer | – | – |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| hours | integer | – | – |
| minutes | integer | – | – |
| months | integer | – | – |
| seconds | integer | – | – |
| weeks | integer | – | – |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| years | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| input | string | yes | – |
| is_business_day | boolean | yes | – |
| result | string | yes | YYYY-MM-DD, or ISO datetime (UTC) for datetime input |
| weekday | string | yes | – |
No examples provided.
date_diff Date difference ~268
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).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| from | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| to | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| Name | Type | Req | Description |
|---|---|---|---|
| business_days | integer | – | Weekdays in [from, to) minus holidays (date inputs only) |
| calendar | object | yes | – |
| direction | string | yes | – |
| from | string | yes | – |
| iso_duration | string | yes | – |
| to | string | yes | – |
| total_days | integer | yes | – |
| total_hours | integer | – | Datetime inputs only |
| total_minutes | integer | – | – |
| total_seconds | integer | – | – |
| total_weeks | integer | yes | – |
No examples provided.
date_info Date facts ~74
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).
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | – |
| day_of_year | integer | yes | – |
| days_in_month | integer | – | – |
| days_in_year | integer | – | – |
| days_remaining_in_year | integer | – | – |
| is_leap_year | boolean | yes | – |
| is_weekend | boolean | yes | – |
| iso_week | integer | yes | – |
| iso_year | integer | – | – |
| quarter | integer | yes | – |
| unix_seconds | integer | – | – |
| weekday | string | yes | – |
| weekday_number | integer | – | ISO: Monday=1 … Sunday=7 |
No examples provided.
date_range Reporting period to exact dates ~402
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. First 25 calls per day are free, then $0.001 per call (x402).
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Reference date or datetime. Default today |
| compare | string | – | Comparison range: previous_period (or to-date: same days into the previous unit), previous_year (weeks: 52 weeks back). yoy works |
| fiscal_year_start | integer | – | Fiscal year's first month (1-12). FY named by its end year: start 7, FY2027 = Jul 2026-Jun 2027 |
| include_today | boolean | – | End with today. Default true for *_to_date, false for last_N_* |
| period | string | yes | today, yesterday, this/last/next week|month|quarter|half|year, mtd, qtd, ytd, last_N_days|weeks|months, next_N_..., 2026, 2026-H1, 2026-Q3, 2026-03, 2026-W14, 2026-03-15. Fiscal (needs fiscal_year_st… |
| timezone | string | – | IANA time zone, e.g. America/New_York (default UTC) |
| week_start | string | – | Week start; monday = ISO weeks |
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | yes | – |
| comparison | object | – | – |
| days | integer | yes | – |
| end_date | string | yes | – |
| end_exclusive | string | yes | Exclusive end; filter >= start and < end_exclusive |
| end_exclusive_utc | string | yes | – |
| fiscal_year_start | string | – | – |
| label | string | yes | – |
| period | string | yes | – |
| start | string | yes | – |
| start_date | string | yes | – |
| start_utc | string | yes | – |
| timezone | string | yes | – |
| week_start | string | – | – |
No examples provided.
dst_check DST transitions and local-time check ~165
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).
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | – | Local wall time to check, without offset: YYYY-MM-DDTHH:MM[:SS] |
| timezone | string | yes | IANA time zone, e.g. Asia/Manila |
| year | integer | – | Year to list (default: the datetime's year, else the current year) |
| Name | Type | Req | Description |
|---|---|---|---|
| check | object|null | yes | – |
| dst_offset | string|null | yes | – |
| observes_dst | boolean | yes | – |
| standard_offset | string | yes | – |
| timezone | string | yes | – |
| transitions | array | yes | – |
| year | integer | yes | – |
No examples provided.
find_free_slots Find free meeting slots ~236
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).
| Name | Type | Req | Description |
|---|---|---|---|
| buffer_minutes | integer | – | Free time kept around busy blocks |
| days | integer | – | – |
| duration_minutes | integer | yes | – |
| from | string | – | – |
| max_slots | integer | – | – |
| not_before | string | – | Earliest slot start: ISO 8601 with offset, or "now" |
| participants | array | yes | – |
| step_minutes | integer | – | Slot start alignment |
| timezone | string | – | Organizer's zone: defines the days searched and slot alignment (default: first participant's) |
| work_end | string | – | Default end of working hours, 17:00 |
| work_start | string | – | Default start of working hours, 09:00 |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| duration_minutes | integer | yes | – |
| free_windows | array | yes | – |
| range | object | yes | – |
| slots | array | yes | – |
| timezone | string | yes | – |
No examples provided.
market_calendar Stock market hours and holidays ~182
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).
| Name | Type | Req | Description |
|---|---|---|---|
| at | string | – | Instant for the open/closed status: ISO 8601 with offset (default: now) |
| date | string | – | – |
| exchange | string | yes | XNYS or NYSE, XNAS or NASDAQ, XLON or LSE, XTKS or TSE/JPX |
| list_year | integer | – | Also list that year's holidays and early closes |
| Name | Type | Req | Description |
|---|---|---|---|
| calendar | array|null | yes | – |
| date | string | yes | – |
| early_close | string|null | yes | Reason for an early close, if any |
| exchange | string | yes | – |
| holiday | string|null | yes | – |
| is_trading_day | boolean | yes | – |
| name | string | yes | – |
| next_trading_day | string | yes | – |
| note | string | yes | – |
| previous_trading_day | string | yes | – |
| reason | string|null | yes | – |
| session | object|null | yes | – |
| settlement | object|null | yes | – |
| status | object | yes | – |
| timezone | string | yes | – |
| weekday | string | yes | – |
No examples provided.
parse_date_text Parse natural-language dates ~144
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).
| Name | Type | Req | Description |
|---|---|---|---|
| forward_date | boolean | – | Prefer future dates for ambiguous text (default true) |
| reference | string | – | ISO 8601 datetime the text is relative to; default now |
| text | string | yes | – |
| timezone | string | – | Default UTC |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| reference | string | – | – |
| results | array | yes | – |
| text | string | yes | – |
| timezone | string | yes | – |
No examples provided.
pay_dates Payroll and billing dates ~320
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).
| Name | Type | Req | Description |
|---|---|---|---|
| adjust | string | – | Where to move a pay date that falls on a weekend or holiday |
| anchor | string | – | – |
| count | integer | – | How many pay dates to return |
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| days | array | – | monthly: 1 day, semi_monthly: 2 days of the month (1–31 or "last"; 31 clamps to month end). Defaults: ["last"] and [15, "last"] |
| from | string | yes | – |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| schedule | string | yes | – |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| Name | Type | Req | Description |
|---|---|---|---|
| adjust | string | yes | – |
| count | integer | yes | – |
| pay_dates | array | yes | – |
| schedule | string | yes | – |
No examples provided.
public_holidays Public holidays ~132
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).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| year | integer | – | Defaults to the current year |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| country | string | yes | – |
| country_name | string | – | – |
| holidays | array | yes | – |
| source | string | – | Data attribution |
| type | string | – | – |
| year | integer | yes | – |
No examples provided.
recurring_dates Expand recurring events (RRULE) ~162
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).
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | Default 10 |
| exclude | array | – | Local dates (YYYY-MM-DD) to skip |
| rrule | string | yes | iCalendar RRULE (no DTSTART/TZID inside) |
| start | string | yes | Local start date or datetime in timezone, e.g. 2026-01-01T10:00 |
| timezone | string | – | Default UTC |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| description | string | – | – |
| occurrences | array | yes | – |
| rrule | string | yes | – |
| start | string | – | – |
| timezone | string | yes | – |
No examples provided.
sla_countdown SLA countdown (business hours) ~382
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).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| holidays | array | – | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| now | string | – | Current time (default: now), same formats as start |
| pauses | array | – | Manual pauses (e.g. waiting on customer), up to 100 |
| sla_hours | number | – | SLA target in business hours (combine with sla_minutes) |
| sla_minutes | number | – | SLA target in business minutes |
| start | string | yes | When the SLA clock started: ISO 8601 with offset, or local YYYY-MM-DDTHH:MM in timezone |
| timezone | string | yes | IANA time zone of the support team's working hours |
| work_end | string | – | End of working hours, default 17:00 |
| work_start | string | – | Start of working hours, default 09:00 |
| workdays | array | – | Working days of the week, 0 = Sunday. Default [1,2,3,4,5] (Mon–Fri); e.g. [0,1,2,3,4] for Sun–Thu or [1,2,3,4,5,6] for Mon–Sat |
| Name | Type | Req | Description |
|---|---|---|---|
| breached | boolean | yes | – |
| breached_by_business_minutes | integer | yes | – |
| deadline | string | yes | – |
| deadline_utc | string | yes | – |
| deadline_weekday | string | yes | – |
| elapsed_business_minutes | integer | yes | – |
| now | string | yes | – |
| percent_used | number | yes | – |
| remaining_business_minutes | integer | yes | – |
| resumes_at | string|null | yes | When the clock restarts, if paused by working hours |
| sla_minutes | integer | yes | – |
| start | string | yes | – |
| status | string | yes | – |
| timezone | string | yes | – |
No examples provided.
stay_calculator Visa stay calculator (Schengen 90/180) ~171
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).
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | – | – |
| entry | string | – | – |
| max_days | integer | – | – |
| trips | array | yes | Past and planned stays. Entry and exit days both count as days present. |
| window_days | integer | – | Length of the rolling window, counted back from each day (inclusive) |
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | – |
| days_remaining | integer | yes | – |
| days_used | integer | yes | Days present in the window ending on date |
| first_overstay | string|null | yes | First day any trip broke the rule, or null |
| in_compliance | boolean | yes | – |
| max_stay | object|null | yes | Present when entry was given |
| next_full_stay_date | string|null | yes | Earliest date after date from which a full max_days stay is allowed |
| note | string | yes | – |
| overstay_days | integer | yes | – |
| rule | object | yes | – |
No examples provided.
subscription_dates Subscription renewal and proration ~197
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).
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | – | Price of one billing period, for proration |
| as_of | string | – | – |
| count | integer | – | Upcoming renewals to list |
| interval | string | – | – |
| interval_count | integer | – | e.g. 3 with month = quarterly |
| notice_days | integer | – | Cancellation notice period before renewal |
| start | string | yes | – |
| trial_days | integer | – | Free trial length; billing starts after it |
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | yes | – |
| billing_start | string | yes | – |
| cancel_by | string|null | yes | Last day to cancel before the next renewal, given notice_days |
| cancel_by_passed | boolean|null | yes | – |
| current_period | object|null | yes | – |
| interval | string | yes | – |
| interval_count | integer | yes | – |
| next_renewal | string | yes | – |
| next_renewal_weekday | string | yes | – |
| note | string | yes | – |
| proration | object|null | yes | – |
| start | string | yes | – |
| status | string | yes | – |
| upcoming_renewals | array | yes | – |
No examples provided.
time_buckets Time buckets for charts ~380
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 periods in dashboards. First 25 calls per day are free, then $0.001 per call (x402).
| Name | Type | Req | Description |
|---|---|---|---|
| bucket | string | – | Plurals and daily/weekly/monthly also work |
| clip | boolean | – | Clip the first and last buckets to [from, to) instead of returning whole buckets flagged partial |
| fiscal_year_start | integer | – | Month the fiscal year starts (1 = January). Quarters, halves and years follow it; fiscal years are named by the calendar year they end in (start 7: FY2027 = July 2026 – June 2027) |
| from | string | yes | Range start: YYYY-MM-DD (local midnight), local YYYY-MM-DDTHH:MM, or ISO 8601 with offset. Years 1000–9999 |
| size | integer | – | minute: 1,2,3,4,5,6,10,12,15,20,30; hour: 1,2,3,4,6,8,12. Other buckets: 1 |
| timezone | string | – | IANA time zone, e.g. America/New_York (default UTC) |
| to | string | yes | Range end, exclusive (same formats) |
| week_start | string | – | First day of the week. monday = ISO weeks (labels like 2026-W46) |
| Name | Type | Req | Description |
|---|---|---|---|
| bucket | string | yes | – |
| buckets | array | yes | – |
| count | integer | yes | – |
| fiscal_year_start | string | – | – |
| from | string | yes | – |
| size | integer | yes | – |
| timezone | string | yes | – |
| to | string | yes | – |
| week_start | string | – | – |
No examples provided.
timestamp_normalize Normalize timestamps ~206
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).
| Name | Type | Req | Description |
|---|---|---|---|
| date_order | string | – | How to read ambiguous slash dates like 03/04/2026 (default MDY, with the other reading in alternatives) |
| numeric_format | string | – | – |
| timezone | string | – | Zone for values without an offset and for the local output (default UTC) |
| values | array | yes | Timestamps as strings or numbers. Pass very large integers (ns) as strings. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | yes | – |
| ok | integer | yes | How many values were understood |
| results | array | yes | – |
| timezone | string | yes | – |
No examples provided.
timezone_convert Convert time zones ~125
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).
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | – | ISO 8601 with offset, local YYYY-MM-DDTHH:MM[:SS] (needs from_timezone), or "now" (default) |
| from_timezone | string | – | – |
| to_timezone | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| from | object | yes | – |
| to | object | yes | – |
| unix_seconds | integer | yes | – |
| utc | string | yes | – |
No examples provided.
working_hours_overlap Working-hours overlap ~144
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).
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | – | YYYY-MM-DD in the first participant's zone; defaults to today |
| days | integer | – | Number of days to search (default 1) |
| participants | array | – | – |
| skip_weekends | boolean | – | Default true |
| timezones | array | – | – |
| work_end | string | – | – |
| work_start | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | – | – |
| participants | array | – | – |
| reference_timezone | string | yes | – |
| to | string | – | – |
| total_overlap_minutes | number | yes | – |
| windows | array | yes | – |
No examples provided.
How do I install the Date Math MCP server?
Date Math is a hosted endpoint at https://date-math.datemath.workers.dev/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · date-math.datemath.workers.dev
claude mcp add --transport http jowendelapena-date-math 'https://date-math.datemath.workers.dev/mcp'
What is the Date Math MCP server?
Date Math is an MCP server listed in the public MCP registry as io.github.JowenDelaPena/date-math. Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day. This page covers its hosted endpoint (https://date-math.datemath.workers.dev/mcp).
Is the Date Math MCP server safe to use?
Date Math scores 61 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Date Math MCP server expose?
Date Math exposes 24 tools: date_diff, date_add, timezone_convert, date_info, public_holidays, and 19 more. Their descriptions and schemas cost roughly 5,347 tokens of context every time the server is loaded.
Does the Date Math MCP server require authentication?
No. We connected to Date Math without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Date Math MCP server still maintained?
Date Math is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the Date Math MCP server?
VerifyMCP ran 11 checks on Date Math, covering TLS certificate, HSTS header, DNSSEC, Transport and 7 more. 2 items could not be completed, a gap on our side rather than a finding about Date Math: Authorization and HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.