{
  "markdown": "# World Clock Pro MCP server\n\n**Give your AI agent a real clock.** Public, read-only, no API key:\n\n```\nhttps://worldclock.pro/mcp\n```\n\nModels cannot reliably compute local times, DST transitions, or timezone math on\ntheir own. This server gives any MCP-capable assistant live answers from the IANA\ntimezone database and a 224,000+ city registry, with the answer's source page cited\nin every response.\n\n- **Live endpoint:** `https://worldclock.pro/mcp` (Streamable HTTP, stateless, JSON-RPC 2.0)\n- **How-to page:** [worldclock.pro/mcp](https://worldclock.pro/mcp)\n- **Server card:** [`/.well-known/mcp/server-card.json`](https://worldclock.pro/.well-known/mcp/server-card.json)\n- **Registry name:** `pro.worldclock/time` (domain-verified)\n\n## Quick connect\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http worldclockpro-time https://worldclock.pro/mcp\n```\n\n**Claude Desktop** — Settings → Connectors → *Add custom connector* → paste the URL.\n\n**Cursor** — paste into `~/.cursor/mcp.json` (or use the button on [worldclock.pro/mcp](https://worldclock.pro/mcp)):\n\n```json\n{ \"mcpServers\": { \"worldclockpro-time\": { \"url\": \"https://worldclock.pro/mcp\" } } }\n```\n\n**VS Code**\n\n```bash\ncode --add-mcp '{\"name\":\"worldclockpro-time\",\"type\":\"http\",\"url\":\"https://worldclock.pro/mcp\"}'\n```\n\n**ChatGPT** — Settings → *Apps & Connectors* → Advanced settings → enable *Developer\nmode* → create a connector with the URL and **No authentication**. The server is\nread-only, so it works on plans where custom connectors are limited to read-only tools.\n\n**OpenClaw** — add to `openclaw.json`:\n\n```json\n{ \"mcp\": { \"servers\": { \"worldclockpro-time\": { \"url\": \"https://worldclock.pro/mcp\", \"transport\": \"streamable-http\" } } } }\n```\n\n**MCP Inspector**\n\n```bash\nnpx @modelcontextprotocol/inspector\n# Transport: \"Streamable HTTP\" → URL: https://worldclock.pro/mcp\n```\n\n## Tools\n\n| Tool | What it does | Try asking |\n|------|--------------|------------|\n| `get_current_time` | Current time in one or many places (up to 50 at once). | *\"What time is it in Tokyo, Paris, and UTC?\"* |\n| `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?\"* |\n| `time_by_coordinates` | Time at any point on Earth, by latitude/longitude. | *\"What's the local time at 48.85, 2.35?\"* |\n| `get_dst_transitions` | DST observance and exact clock-change dates for any year. | *\"When do the clocks change in London this year?\"* |\n| `search_cities` | Multilingual city lookup → canonical slug, IANA zone, coordinates. | *\"Find cities called 'San Jose'.\"* |\n\nEvery result includes a `source_url` linking the matching worldclock.pro page,\nso answers can cite a live source.\n\n### Ways to describe a place\n\n- **City name or alias** — `\"Tokyo\"`, `\"new-york\"`, `\"nyc\"`, `\"Москва\"`, `\"São Paulo\"`\n- **Timezone** — IANA id (`\"America/New_York\"`) or abbreviation (`\"PST\"`, `\"ET\"`, `\"UTC\"`)\n- **Coordinates** — latitude + longitude; the answer names the nearest city\n\n## Use as a Claude Code plugin\n\nThis repo is itself a plugin marketplace:\n\n```\n/plugin marketplace add worldclockpro/worldclock-mcp\n/plugin install world-clock@worldclockpro\n```\n\nThe plugin wires up the remote MCP server and installs the `world-clock` skill,\nwhich teaches the assistant when to use which tool and the classic timezone traps\n(EST vs ET, half-hour offsets, date-line weekday changes).\n\n## Use as an OpenClaw skill\n\nThe same skill follows the [Agent Skills](https://agentskills.io) format:\n\n```bash\nnpx clawhub@latest install world-clock   # once published on ClawHub\n# or copy skills/world-clock/ into your skills directory\n```\n\n## Why trust it\n\n- **Read-only by design.** Every tool declares `readOnlyHint: true`. There are no\n  write operations, no accounts, and nothing to sign in for.\n- **No tracking.** Queries are computed in memory and not stored. See the\n  [privacy policy](https://worldclock.pro/privacy).\n- **Live IANA data.** DST rules come from the IANA timezone database, updated with\n  the weekly data refresh, never hard-coded.\n- **Run by an established team.** The people behind the\n  [World Clock Master](https://worldclock.pro/world-clock-master) (Apple Editor's\n  Choice) and [World Clock Pro](https://worldclock.pro/mac) apps.\n- **Domain-verified.** The registry listing `pro.worldclock/time` is published with\n  cryptographic proof of control of worldclock.pro.\n\n## Limits and errors\n\n- Up to **50 locations per call** (`search_cities` returns up to 25 matches).\n- Per-IP rate limit: 60 calls per 10 seconds (HTTP 429 with `Retry-After` beyond that).\n- Invalid input returns structured errors (`LOCATION_NOT_FOUND`, `INVALID_TIMEZONE`,\n  `AMBIGUOUS_INSTANT`, ...) an agent can read and recover from.\n\n## Links\n\n- Website: [worldclock.pro](https://worldclock.pro)\n- Agent guide: [worldclock.pro/llms.txt](https://worldclock.pro/llms.txt)\n- Support: support@worldclock.pro\n\nMIT licensed. See [SECURITY.md](SECURITY.md) for the security posture.\n",
  "bytes": 4966,
  "sha": "f31146297eb48ead907097c2d50289676844e5091ff711d13629a44e9cc83cb5",
  "repo_slug": "worldclockpro/worldclock-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_pro_worldclock_time_02e45db2/readme"
}