MCP server that wraps the Dagster GraphQL API — manage runs, assets, schedules, sensors, and backfills from any MCP client
Date Math is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Exact date and time math for AI agents, so they stop guessing at calendars. 20 deterministic tools plus a free current_time.
Business days: days between dates, add business days, is-it-a-business-day, payroll dates, with public holidays for 207 countries (2000-2050).Time zones: DST-aware conversion, city to time zone (7,000+ cities), working-hours overlap, free meeting slots, daylight-saving transitions.Deadlines: business-hours deadlines and live SLA countdowns that pause outside working hours and on holidays.Schedules: explain cron and list next runs, expand iCal RRULEs, parse "next Friday at 3pm", normalize mixed timestamps to UTC.Calendars: Schengen 90/180 stays, subscription renewals and proration, NYSE/Nasdaq, London and Tokyo market hours, early closes and settlement dates.
No account or API key. 25 free tool calls per day; after that $0.001 per call via the open x402 protocol (USDC on Base). Remote server: https://date-math.datemath.workers.dev/mcp
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user jowendelapena-date-math-mcp '--' npx -y date-math-mcp
# 2 — ask your agent for something these tools do
# date_diff, date_add, timezone_convert and 18 more
Date Math costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one can run either way — at an address its publisher runs, or as a process under your own user, with your files and your network — and this marketplace is in the path of neither.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user jowendelapena-date-math-mcp '--' npx -y date-math-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Its publisher also runs it at https://date-math.datemath.workers.dev/mcp: nothing to start on your machine, and this marketplace is not in the path.
claude mcp add --scope user --transport http jowendelapena-date-math-mcp https://date-math.datemath.workers.dev/mcpNothing is required, but it can take DATE_MATH_PRIVATE_KEY (Optional. Key of a wallet holding USDC on Base, to pay $0.001 per call after the 25 free daily calls.), DATE_MATH_MAX_PRICE (Optional. The most to pay for one call (default $0.001).) if you want to set them.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
21 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| to | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| holidays | array | no | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| workdays | array | no | 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 |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | yes | YYYY-MM-DD, or ISO 8601 datetime with Z or offset |
| years | integer | no | — |
| months | integer | no | — |
| weeks | integer | no | — |
| days | integer | no | — |
| business_days | integer | no | Applied after calendar units; skips rest days (see workdays) and holidays |
| hours | integer | no | — |
| minutes | integer | no | — |
| seconds | integer | no | — |
| holidays | array | no | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| workdays | array | no | 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 |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| datetime | string | no | ISO 8601 with offset, local YYYY-MM-DDTHH:MM[:SS] (needs from_timezone), or "now" (default) |
| from_timezone | string | no | — |
| to_timezone | string | yes | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | yes | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| year | integer | no | Defaults to the current year |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timezones | array | no | — |
| participants | array | no | — |
| date | string | no | YYYY-MM-DD in the first participant's zone; defaults to today |
| days | integer | no | Number of days to search (default 1) |
| work_start | string | no | — |
| work_end | string | no | — |
| skip_weekends | boolean | no | Default true |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| expression | string | yes | 5- or 6-field cron expression |
| timezone | string | no | Default UTC |
| count | integer | no | Default 5 |
| from | string | no | ISO 8601 datetime with offset; default now |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| text | string | yes | — |
| timezone | string | no | Default UTC |
| reference | string | no | ISO 8601 datetime the text is relative to; default now |
| forward_date | boolean | no | Prefer future dates for ambiguous text (default true) |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| city | string | no | — |
| cities | array | no | — |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| at | string | no | ISO 8601 instant to show local time for; default now |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| 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 | no | Default UTC |
| count | integer | no | Default 10 |
| exclude | array | no | Local dates (YYYY-MM-DD) to skip |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timezone | string | yes | IANA time zone, e.g. Asia/Manila |
| start | string | no | Local datetime in timezone or ISO 8601 with offset; default now |
| hours | number | no | — |
| minutes | number | no | — |
| end | string | no | Count business time from start to end (max 1 year) |
| work_start | string | no | — |
| work_end | string | no | — |
| workdays | array | no | 0 = Sunday; default [1,2,3,4,5] |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| holidays | array | no | — |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | yes | — |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| holidays | array | no | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| workdays | array | no | 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 |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schedule | string | yes | — |
| from | string | yes | — |
| count | integer | no | How many pay dates to return |
| days | array | no | monthly: 1 day, semi_monthly: 2 days of the month (1–31 or "last"; 31 clamps to month end). Defaults: ["last"] and [15, "last"] |
| anchor | string | no | — |
| adjust | string | no | Where to move a pay date that falls on a weekend or holiday |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| holidays | array | no | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| workdays | array | no | 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 |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trips | array | yes | Past and planned stays. Entry and exit days both count as days present. |
| date | string | no | — |
| entry | string | no | — |
| max_days | integer | no | — |
| window_days | integer | no | Length of the rolling window, counted back from each day (inclusive) |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| values | array | yes | Timestamps as strings or numbers. Pass very large integers (ns) as strings. |
| timezone | string | no | Zone for values without an offset and for the local output (default UTC) |
| numeric_format | string | no | — |
| date_order | string | no | How to read ambiguous slash dates like 03/04/2026 (default MDY, with the other reading in alternatives) |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timezone | string | yes | IANA time zone, e.g. Asia/Manila |
| datetime | string | no | Local wall time to check, without offset: YYYY-MM-DDTHH:MM[:SS] |
| year | integer | no | Year to list (default: the datetime's year, else the current year) |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start | string | yes | When the SLA clock started: ISO 8601 with offset, or local YYYY-MM-DDTHH:MM in timezone |
| now | string | no | Current time (default: now), same formats as start |
| sla_hours | number | no | SLA target in business hours (combine with sla_minutes) |
| sla_minutes | number | no | SLA target in business minutes |
| timezone | string | yes | IANA time zone of the support team's working hours |
| work_start | string | no | Start of working hours, default 09:00 |
| work_end | string | no | End of working hours, default 17:00 |
| workdays | array | no | 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 |
| country | string | no | ISO 3166-1 alpha-2 country code (207 countries); its public holidays (2000–2050) are excluded from business days |
| holidays | array | no | Extra dates excluded from business-day counts (rest days from workdays are always excluded) |
| pauses | array | no | Manual pauses (e.g. waiting on customer), up to 100 |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| participants | array | yes | — |
| duration_minutes | integer | yes | — |
| from | string | no | — |
| days | integer | no | — |
| timezone | string | no | Organizer's zone: defines the days searched and slot alignment (default: first participant's) |
| work_start | string | no | Default start of working hours, 09:00 |
| work_end | string | no | Default end of working hours, 17:00 |
| step_minutes | integer | no | Slot start alignment |
| buffer_minutes | integer | no | Free time kept around busy blocks |
| max_slots | integer | no | — |
| not_before | string | no | Earliest slot start: ISO 8601 with offset, or "now" |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start | string | yes | — |
| interval | string | no | — |
| interval_count | integer | no | e.g. 3 with month = quarterly |
| as_of | string | no | — |
| count | integer | no | Upcoming renewals to list |
| notice_days | integer | no | Cancellation notice period before renewal |
| trial_days | integer | no | Free trial length; billing starts after it |
| amount | number | no | Price of one billing period, for proration |
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).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchange | string | yes | XNYS or NYSE, XNAS or NASDAQ, XLON or LSE, XTKS or TSE/JPX |
| date | string | no | — |
| at | string | no | Instant for the open/closed status: ISO 8601 with offset (default: now) |
| list_year | integer | no | Also list that year's holidays and early closes |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| timezone | string | no | IANA time zone, e.g. Asia/Manila |
| timezones | array | no | Up to 10 IANA time zones (default UTC) |
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Date Math or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | minimal | capability blast radius (minimal) — client exposure if the model is manipulated | −0 |
| verification-discount | repo | publisher verification (public source) — no provenance, but the source is public and inspectable | −1 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
No tools were enumerated, so prompt-injection, capability and toxic-flow analysis had no tool surface to inspect. To grade a package’s real runtime tools, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| No per-tool rows for this release — see the note below. | ||
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 1.5.0. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Date Math can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.