MCP Clock

Live MCP endpoint: https://mcpclock.firasd.workers.dev/mcp

Works in Claude.ai, Claude iOS, Claude Code, OpenAI Codex, and any MCP-compatible client.

Tools

clock_get

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"}

clock_day_info

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"}

clock_convert

Converts a timestamp from one time zone to one or more target zones.

• source_zone — IANA zone name or "UTC".

• iso — ISO-8601 string. If source is "UTC", include the Z suffix. If source is an IANA zone, omit the offset (wall-clock time).

• target_zones — Array of IANA zone names or "UTC". Min 1, max 15.

clock_convert{
  "source_zone": "America/Mexico_City",
  "iso": "2025-10-28T07:30:00",
  "target_zones": ["UTC", "Asia/Dubai"]
}

clock_convert_alphadec

Converts between a UTC ISO timestamp and an Alphadec string.

• direction — "utc_to_alphadec" (default) or "alphadec_to_utc".

• value — UTC ISO string (e.g. "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"}

clock_convert_unixtime

Converts between a UTC ISO timestamp and a Unix timestamp (seconds since epoch).

• direction — "utc_to_unixtime" (default) or "unixtime_to_utc".

• value — UTC ISO string (e.g. "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"}

clock_delta_utc

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"}

clock_delta_alphadec

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"}

Related MCP server: Remote MCP Server (Authless)

Alphadec

Alphadec is a compact, human-readable timestamp format. A full canonical string looks like 2026_I2J9_382995.

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.