epochcalc
cmunkres/epochcalc# Epoch Calculator Time and date math that language models get wrong on their own: Unix timestamps, daylight-saving offsets, calendar arithmetic, and cron schedules. Every calculation uses the IANA time zone database, the same engine behind [epochcalc.com](https://epochcalc.com). No API key, no signup, no state. Read-only. ## Tools | Tool | What it does | |---|---| | `time_now` | Current time in any zone, with epoch seconds, ISO 8601, RFC 2822, and DST flag | | `convert_timestamp` | Unix timestamp (seconds or milliseconds, auto-detected) to a full date breakdown | | `parse_datetime` | Natural or ISO date string to timestamp and zone-aware fields | | `convert_timezone` | Same instant in two zones, with the hour difference and DST status of each | | `date_duration` | Days, weekdays, weeks, and calendar breakdown between two dates | | `epoch_math` | Add or subtract years, months, weeks, days, hours, minutes, or seconds | | `cron_next_runs` | Plain-English explanation of a cron expression plus its next N run times | | `days_until` | Countdown to a named holiday or event, or list the supported events | ## Notes - Time zones are IANA names such as `America/New_York` or `Europe/Berlin`. Abbreviations like `EST` are ambiguous and rejected. - Endpoint: `https://epochcalc.com/mcp` (Streamable HTTP, stateless). A plain JSON API for the same tools is at `https://epochcalc.com/api/v1`. - Documentation: [epochcalc.com/api](https://epochcalc.com/api)
Score: 100/100
Handshake verified by our own probe.
Tools · 8
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 dat…
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 p…
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 i…
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 eithe…
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 IA…
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 resu…
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 …
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-D…
How to use
Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://epochcalc.com/mcp
Cursor or Cline: add to your MCP config:
{
"mcpServers": {
"epochcalc": {
"url": "https://epochcalc.com/mcp",
"transport": "http"
}
}
}