A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON βΎ
Client Config & Setup
Choose your client or environment
Target File:
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
World Clock Pro MCP server
Give your AI agent a real clock. Public, read-only, no API key:
Models cannot reliably compute local times, DST transitions, or timezone math on their own. This server gives any MCP-capable assistant live answers from the IANA timezone database and a 224,000+ city registry, with the answer's source page cited in every response.
- Live endpoint:
https://worldclock.pro/mcp(Streamable HTTP, stateless, JSON-RPC 2.0) - How-to page: worldclock.pro/mcp
- Server card:
/.well-known/mcp/server-card.json - Registry name:
pro.worldclock/time(domain-verified)
Quick connect
Claude Code
Claude Desktop β Settings β Connectors β Add custom connector β paste the URL.
Cursor β paste into ~/.cursor/mcp.json (or use the button on worldclock.pro/mcp):
VS Code
ChatGPT β Settings β Apps & Connectors β Advanced settings β enable Developer mode β create a connector with the URL and No authentication. The server is read-only, so it works on plans where custom connectors are limited to read-only tools.
OpenClaw β add to openclaw.json:
MCP Inspector
Tools
| Tool | What it does | Try asking |
|---|---|---|
get_current_time | Current time in one or many places (up to 50 at once). | "What time is it in Tokyo, Paris, and UTC?" |
convert_time | Move one moment across time zones, DST-safe. | "If it's 9 AM Monday in New York, what time is it in Sydney?" |
time_by_coordinates | Time at any point on Earth, by latitude/longitude. | "What's the local time at 48.85, 2.35?" |
get_dst_transitions | DST observance and exact clock-change dates for any year. | "When do the clocks change in London this year?" |
search_cities | Multilingual city lookup β canonical slug, IANA zone, coordinates. | "Find cities called 'San Jose'." |
Every result includes a source_url linking the matching worldclock.pro page,
so answers can cite a live source.
Ways to describe a place
- City name or alias β
"Tokyo","new-york","nyc","ΠΠΎΡΠΊΠ²Π°","SΓ£o Paulo" - Timezone β IANA id (
"America/New_York") or abbreviation ("PST","ET","UTC") - Coordinates β latitude + longitude; the answer names the nearest city
Use as a Claude Code plugin
This repo is itself a plugin marketplace:
The plugin wires up the remote MCP server and installs the world-clock skill,
which teaches the assistant when to use which tool and the classic timezone traps
(EST vs ET, half-hour offsets, date-line weekday changes).
Use as an OpenClaw skill
The same skill follows the Agent Skills format:
Why trust it
- Read-only by design. Every tool declares
readOnlyHint: true. There are no write operations, no accounts, and nothing to sign in for. - No tracking. Queries are computed in memory and not stored. See the privacy policy.
- Live IANA data. DST rules come from the IANA timezone database, updated with the weekly data refresh, never hard-coded.
- Run by an established team. The people behind the World Clock Master (Apple Editor's Choice) and World Clock Pro apps.
- Domain-verified. The registry listing
pro.worldclock/timeis published with cryptographic proof of control of worldclock.pro.
Limits and errors
- Up to 50 locations per call (
search_citiesreturns up to 25 matches). - Per-IP rate limit: 60 calls per 10 seconds (HTTP 429 with
Retry-Afterbeyond that). - Invalid input returns structured errors (
LOCATION_NOT_FOUND,INVALID_TIMEZONE,AMBIGUOUS_INSTANT, ...) an agent can read and recover from.
Links
- Website: worldclock.pro
- Agent guide: worldclock.pro/llms.txt
- Support: support@worldclock.pro
MIT licensed. See SECURITY.md for the security posture.
Related MCP Servers
Reviews
No reviews yet β be the first to share how this listing worked for you.
Frequently Asked Questions about Time
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/time-5)HTML Embed
<a href="https://allmcps.com/mcp/time-5"><img src="https://allmcps.com/api/badge/time-5?style=directory" alt="Time on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
27Quality signal: Emerging Β· 27/100How this signal is calculated βΎ
Server availabilityNot measured
Not scored for repo-hosted servers β we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools11/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data β not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge β proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it β no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.