# MCP Clock: live public hosted tool for Claude, Codex, any MCP Client

> Source: <https://github.com/firasd/mcpclock>
> Published: 2026-07-25 10:17:12+00:00

**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 in`YYYY-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 or`source_zone`

`"UTC"`

.— ISO-8601 string. If source is`iso`

`"UTC"`

, include the`Z`

suffix. If source is an IANA zone, omit the offset (wall-clock time).— Array of IANA zone names or`target_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 of`start`

or`end`

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.