Live MCP endpoint: https://mcpclock.firasd.workers.dev/mcp
Works in Claude.ai, Claude iOS, Claude Code, OpenAI Codex, and any MCP-compatible client.
Returns current time in one or more time zones.
timezones
(optional)— Array of IANA zone names (e.g."America/New_York"
) plus the special literals"UTC"
and"Alphadec"
. Defaults to["UTC"]
. Max 15 zones.offsetSeconds
(optional)— Signed offset in seconds applied before formatting. E.g.-86400
for 24 h ago,+60
for one minute ahead.adec_canonical_only
(optional)— Pass"true"
to suppress the Alphadec unit explanation and return only the canonical string.
clock_get{}
clock_get{"timezones": ["Asia/Tokyo", "America/New_York"]}
clock_get{"timezones": ["Alphadec"], "adec_canonical_only": "true"}
Returns calendar information for a UTC date — weekday, days in month, day of year, year progress %, and ISO week number.
date
(optional)— Date inYYYY-MM-DD
format. Defaults to today (UTC).
clock_day_info{}
clock_day_info{"date": "2025-09-09"}
Converts a timestamp from one time zone to one or more target zones.
— IANA zone name orsource_zone
"UTC"
.— ISO-8601 string. If source isiso
"UTC"
, include theZ
suffix. If source is an IANA zone, omit the offset (wall-clock time).— Array of IANA zone names ortarget_zones
"UTC"
. Min 1, max 15.
clock_convert{
"source_zone": "America/Mexico_City",
"iso": "2025-10-28T07:30:00",
"target_zones": ["UTC", "Asia/Dubai"]
}
Converts between a UTC ISO timestamp and an Alphadec string.
—direction
"utc_to_alphadec"
(default) or"alphadec_to_utc"
.— UTC ISO string (e.g.value
"2025-06-09T16:30:00.000Z"
) or Alphadec string (e.g."2025_L3T5_000000"
).
clock_convert_alphadec{"direction": "utc_to_alphadec", "value": "2025-06-09T16:30:00.000Z"}
clock_convert_alphadec{"direction": "alphadec_to_utc", "value": "2025_L3T5_000000"}
Converts between a UTC ISO timestamp and a Unix timestamp (seconds since epoch).
—direction
"utc_to_unixtime"
(default) or"unixtime_to_utc"
.— UTC ISO string (e.g.value
"2025-06-15T12:00:00Z"
) or Unix timestamp string (e.g."1749988800"
).
clock_convert_unixtime{"direction": "utc_to_unixtime", "value": "2025-06-15T12:00:00Z"}
clock_convert_unixtime{"direction": "unixtime_to_utc", "value": "1749988800"}
Calculates the time difference between two UTC ISO timestamps. Omit either end to use the current time (i.e. "time since" or "time until").
start
(optional)— UTC ISO timestamp (e.g."2022-01-15T10:30:00Z"
). Defaults to now.end
(optional)— UTC ISO timestamp. Defaults to now. At least one ofstart
orend
is required.
Returns total_seconds
, a breakdown
(years/days/hours/minutes/seconds), and a readable
string. Negative if start is after end.
clock_delta_utc{"start": "2022-01-15T10:30:00Z"}
clock_delta_utc{"end": "2025-12-31T23:59:59Z"}
clock_delta_utc{"start": "2022-01-15T10:30:00Z", "end": "2025-08-31T14:45:30Z"}
Calculates the time difference between two 4-character Alphadec codes within the current year. Omit either end to use the current time.
alphadec_start
(optional)— 4-character Alphadec code (e.g."A2B3"
). Defaults to now.alphadec_end
(optional)— 4-character Alphadec code (e.g."Z8Y9"
). Defaults to now. At least one is required.
Returns both ISO time difference and Alphadec unit delta (periods/arcs/bars/beats).
clock_delta_alphadec{"alphadec_start": "A2B3"}
clock_delta_alphadec{"alphadec_end": "Z8Y9"}
clock_delta_alphadec{"alphadec_start": "A2B3", "alphadec_end": "C1Y9"}
Alphadec is a compact, human-readable timestamp format. A full canonical string looks like 2026_I2J9_382995
.
| Unit | Characters | Approx. Duration |
|---|---|---|
| Period | A–Z (1st char) | ~14.04 days (year ÷ 26) |
| Arc | 0–9 (2nd char) | ~33.7 hours (period ÷ 10) |
| Bar | A–Z (3rd char) | ~77.75 minutes (arc ÷ 26) |
| Beat | 0–9 (4th char) | ~7.78 minutes (bar ÷ 10) |
| Offset | 6-digit suffix | milliseconds within beat |
Alphadec strings are K-sortable — lexicographic order matches chronological order. Truncating to fewer characters creates natural time groupings (e.g. 2026_I2
covers the entire I2 arc).
Seasonal anchors (approximate): Period F = March equinox · Period M = June solstice · Period S = September equinox · Period Z = December solstice.