Epoch Calculator

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Unix timestamps, DST-aware time zone conversion, durations, cron schedules, and holiday countdowns

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Epoch Calculator": {
      "url": "https://epochcalc.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• time_now read-only

  The current time: Unix epoch in seconds and milliseconds, ISO 8601, and the local wall-clock time in a given IANA time zone with its current UTC offset and DST status. Use this before any relative date reasoning.

  Parameters:

  • timezone — string — IANA time zone, e.g. "America/New_York". Defaults to UTC.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• convert_timestamp read-only

  Convert a Unix timestamp (seconds or milliseconds; auto-detected unless unit is given) to a human-readable date in a time zone, with ISO 8601, RFC 2822, UTC offset, DST flag, weekday, and a relative phrase like "3 days ago".

  Parameters:

  • timestamp (required) — number — Unix timestamp. Values >= 1e11 are treated as milliseconds unless unit is set.
  • unit — string — Interpretation of timestamp. Default auto.
  • timezone — string — IANA time zone, e.g. "America/New_York". Defaults to UTC.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parse_datetime read-only

  Parse a date/time string (ISO 8601, RFC 2822, HTTP date, SQL "YYYY-MM-DD HH:mm:ss", or a Unix timestamp) into a Unix timestamp and a normalized description. Strings without an offset are interpreted in the given time zone.

  Parameters:

  • input (required) — string — The date/time text to parse.
  • timezone — string — Zone to assume when the input carries no offset, and to report the result in. Defaults to UTC.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• convert_timezone read-only

  Convert a wall-clock date/time from one IANA time zone to another, correctly across daylight-saving transitions. Returns both sides with offsets, the hour difference at that instant, and whether either zone is on DST.

  Parameters:

  • datetime (required) — string — ISO 8601 date/time, e.g. "2026-09-06T09:30". If it has no offset it is read as wall time in from_timezone.
  • from_timezone (required) — string — Source IANA zone, e.g. "Asia/Tokyo".
  • to_timezone (required) — string — Target IANA zone, e.g. "Europe/London".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• date_duration read-only

  The exact duration between two dates or date-times: calendar years/months/days, plus total days, hours, minutes and seconds, and the number of weekdays (Mon-Fri). Handles leap years and DST via the IANA database.

  Parameters:

  • start (required) — string — Start date/time (ISO 8601 or Unix timestamp).
  • end (required) — string — End date/time (ISO 8601 or Unix timestamp).
  • timezone — string — IANA time zone, e.g. "America/New_York". Defaults to UTC.
  • include_end — boolean — Count the end date as a full day (adds one day). Default false.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• epoch_math read-only

  Add to or subtract from a Unix timestamp in calendar-aware units (years, months, weeks, days, hours, minutes, seconds) in a time zone, e.g. "now + 30 days" or "1748736543 - 3 months". Returns the resulting timestamp in every format.

  Parameters:

  • add — object — Units to add.
  • subtract — object — Units to subtract.
  • timezone — string — Zone in which calendar units (months, days across DST) are applied. Defaults to UTC.
  • timestamp — number — Base Unix timestamp (seconds or milliseconds, auto-detected). Omit for now.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• cron_next_runs read-only

  Explain a 5- or 6-field cron expression in plain English and list its next run times in a time zone (as ISO 8601 and Unix timestamps). Use to answer "when does this cron job run next?" or to validate an expression.

  Parameters:

  • expression (required) — string — Cron expression, e.g. "0 9 * * 1-5".
  • from — string — Start evaluating after this date/time (ISO 8601). Defaults to now.
  • count — integer — How many upcoming runs to return. Default 5.
  • timezone — string — Zone the schedule is evaluated in. Defaults to UTC.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• days_until read-only

  Countdown to a holiday or to a date: days, hours and minutes remaining, and the next occurrence date. Pass an event slug (e.g. "christmas", "thanksgiving", "easter", "super-bowl") or a date (YYYY-MM-DD). Call with no arguments to list the known events.

  Parameters:

  • date — string — A target date (YYYY-MM-DD) or date-time (ISO 8601) instead of an event.
  • event — string — Event slug from the known list, e.g. "christmas".
  • timezone — string — Zone whose midnight starts the target day. Defaults to UTC.

  Hints: read-only yes · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.