# time

A public MCP server that hands your agent the actual time, converts between zones and returns DST change dates. Useful when the model guesses the weekday wrong.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: worldclockpro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/worldclockpro/worldclock-mcp
- Updated: 2026-07-21
- HTML: https://affpapa.org/en/nevibecode/mcp/time

## What it does

Language models are bad at local time. Ask one what hour it is in Sydney during a DST shift and you get a confident wrong answer. The `time` server answers from the IANA timezone database and a city registry, and every response carries a `source_url` pointing at the matching page.

It runs at `https://worldclock.pro/mcp` over Streamable HTTP. No API key, no sign-in. Five tools sit behind it: `get_current_time` for one place or up to 50 at once, `convert_time` for moving a moment across zones, `time_by_coordinates` for a latitude and longitude pair, `get_dst_transitions` for clock-change dates in any year, and `search_cities` for looking up a city by name. A place can be a city name or alias, an IANA id, an abbreviation like `ET`, or coordinates.

Know the ceilings before you wire it in. One IP gets 60 calls per 10 seconds; past that the endpoint answers HTTP 429 with a `Retry-After` header, so a loop over many locations can stall. `search_cities` caps at 25 matches. Bad input comes back as structured errors such as `LOCATION_NOT_FOUND` or `INVALID_TIMEZONE`, which the agent can read and retry with a corrected argument.

## Requirements
- Remote server: `https://worldclock.pro/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http time https://worldclock.pro/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add time --url https://worldclock.pro/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "time": {
            "url": "https://worldclock.pro/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "time": {
            "type": "http",
            "url": "https://worldclock.pro/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http time https://worldclock.pro/mcp
```

## When to use it
- check the current hour in several cities at once
- shift a meeting time between zones without breaking on DST
- get local time from a latitude and longitude pair
- look up clock-change dates for a given year
- resolve a city name to its IANA zone and slug

## Example prompts
- What time is it in Tokyo, Paris and UTC right now?
- If it's 9 AM Monday in New York, what time is that in Sydney?

## Similar
- [time-mcp](https://affpapa.org/en/nevibecode/mcp/time-mcp.md) — MCP server · ★ 72
- [crontap-natural-language-schedules](https://affpapa.org/en/nevibecode/skills/crontap-natural-language-schedules.md) — skill · 880 installs
- [dtg-base](https://affpapa.org/en/nevibecode/skills/dtg-base.md) — skill · 327 installs
- [Weather MCP Server](https://affpapa.org/en/nevibecode/mcp/weather-mcp-server.md) — MCP server · ★ 60
- [dotnet-timezone](https://affpapa.org/en/nevibecode/skills/dotnet-timezone.md) — skill · 1600 installs
- [GEML — a plain-text document format built to be edited in place, one section at a time](https://affpapa.org/en/nevibecode/mcp/geml-a-plain-text-document-format-built-to-be-edited-in-place-one-section-at-a-t.md) — MCP server · ★ 29

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md