Tools / MCP Timestamp Tool

MCP Timestamp Tool

Name: Delx Agent Operations Protocol
Author: Delx

The timestamp tool converts between time formats: Unix epoch, ISO 8601, RFC 2822, and human-readable strings. It handles timezone conversions and relative time calculations. Agents use it for log timestamp normalization, scheduling, expiration checks, and cross-timezone coordination. It's stateless, free, and responds in under 5ms.

Endpoint

POST /api/v1/utils/timestamp

Parameters

Name	Type	Required	Description
input	string	No	Timestamp to convert. Accepts Unix epoch (seconds or milliseconds), ISO 8601, or natural language. Defaults to current time.
timezone	string	No	Target timezone (IANA format, e.g., America/New_York).
format	string	No	Output format: iso, unix, human, rfc2822.

Examples

Get current time in multiple formats

POST /api/v1/utils/timestamp {}

Returns current time in all formats when called with no arguments.

Convert Unix timestamp

POST /api/v1/utils/timestamp {"input": "1773687000", "timezone": "America/New_York"}

Converts a Unix timestamp to Eastern time with proper DST handling.

Use Cases

Log normalization: When aggregating logs from multiple sources with different timestamp formats, convert everything to ISO 8601 UTC for consistent sorting and querying.
Expiration checks: Convert token expiration timestamps to Unix and compare with current time. The tool handles format detection automatically.
Cross-timezone scheduling: When coordinating agents across timezones, use the timezone parameter to convert meeting times, cron schedules, and deadlines to each agent's local time.

Supported input formats

The tool auto-detects input format. Unix epoch in seconds (10 digits) and milliseconds (13 digits) are both supported. ISO 8601 with or without timezone offset. RFC 2822 email date format. Human-readable strings like 'March 14, 2026' or 'yesterday' or '2 hours ago'. If the format is ambiguous (like 03/04/2026), the tool assumes MM/DD/YYYY.

FAQ

Does it handle daylight saving time?

Yes. The tool uses the IANA timezone database and correctly handles DST transitions. Specify the IANA timezone name (e.g., America/New_York, not EST) for accurate results.

Can it parse relative times?

Yes. Inputs like '2 hours ago', 'yesterday', 'next Monday', and 'in 30 minutes' are supported. Relative times are calculated from the current server time.

Is it free?

Yes. Free utility tool, no API key required.

What is the epoch range?

The tool handles dates from 1970-01-01 to 2099-12-31. Dates outside this range return an error.

CLI usage?

delx utils timestamp "2026-03-14" --timezone Asia/Tokyo. Outputs the converted timestamp in all formats.