Epoch / Unix Timestamp Converter MCP Server

Epoch / Unix Timestamp Converter

Translate between Unix time and calendar dates without calling any external service. The tool figures out whether you passed a numeric epoch value or a date string, normalizes seconds vs milliseconds vs nanoseconds, and returns both machine-friendly and human-friendly forms.

Capabilities

• Auto-detect direction: Digits parse as a timestamp; other text parses as a date (ISO 8601, YYYY-MM-DD, or YYYY-MM-DD HH:MM:SS, with optional Z for UTC).
• Epoch units: Values above typical second ranges are treated as milliseconds or nanoseconds using magnitude heuristics, then converted to exact UTC instants.
• Outputs: Unix seconds, Unix milliseconds, UTC ISO timestamp, a labeled wall-clock string using your timezone_offset (hours from UTC), weekday name, how the input was interpreted, and a short phrase for how far that instant is from now.
• Reference time: The response includes the current Unix timestamp so you can compare at a glance.

Gotchas

• Supported range: Instants must fall between 1970-01-01 UTC and 2100-12-31 UTC (inclusive window used for validation).
• timezone_offset: Only shifts the human_readable line; iso_8601 and day_of_week stay anchored to the interpreted UTC instant.
• Ambiguous numeric strings: A bare small number is treated as seconds since the epoch, not as a calendar year — use a full date string when you mean a civil date.