GitHub - firasd/mcpclock · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
firasd
mcpclock
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>35 Commits<br>35 Commits
src
src
.gitignore
.gitignore
README.md
README.md
biome.json
biome.json
package-lock.json.bak
package-lock.json.bak
package.json
package.json
tsconfig.json
tsconfig.json
worker-configuration.d.ts
worker-configuration.d.ts
wrangler.jsonc
wrangler.jsonc
View all files
Repository files navigation
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{}<br>clock_get{"timezones": ["Asia/Tokyo", "America/New_York"]}<br>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{}<br>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{<br>"source_zone": "America/Mexico_City",<br>"iso": "2025-10-28T07:30:00",<br>"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"}<br>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"}<br>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"}<br>clock_delta_utc{"end": "2025-12-31T23:59:59Z"}<br>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":...