# TimeAndCalendars.com for AI agents

TimeAndCalendars.com provides public, read-only tools for time, date, time-zone, weather, and calendar questions.

## Available capabilities

- **Current time by city:** use the City Search page for the current local time, date, IANA time zone, weather, map location, and Wikipedia city information.
- **World clock:** compare current times for multiple cities.
- **Time-zone conversion:** convert a time between named time zones while accounting for daylight-saving rules.
- **City weather:** retrieve current weather conditions for a city.
- **Date and time calculations:** calculate date differences and convert between time units.
- **City distance:** compare straight-line and driving distances between two locations.

## Agent guidance

1. Ask for a city and country when a name could be ambiguous.
2. Treat current time and weather as time-sensitive; obtain a fresh result rather than relying on a cached answer.
3. Use IANA time-zone names when precision matters, such as `America/Chicago` or `Europe/London`.
4. Do not infer weather from time-zone data. Weather is a separate live data source.
5. The public tools do not require authentication. Administrative and account-related endpoints are not public agent services.

## Human-facing pages

- [City Search](/city-search)
- [World Clock](/world-clock)
- [World Time Converter](/world-time-converter)
- [City Distance Calculator](/city-distance-calculator)
- [Time and Date Calculators](/calculators)

## Public API documentation

The machine-readable API catalog is available at [/.well-known/api-catalog](/.well-known/api-catalog), and the OpenAPI document is available at [/docs/agents/openapi.json](/docs/agents/openapi.json).

## Browser-agent tools

Compatible browsers can discover these read-only WebMCP tools directly from the site:

- `timeandcalendars_search_city` finds cities and places.
- `timeandcalendars_get_city_time` returns the current local time and time zone for a city.
- `timeandcalendars_get_city_weather` returns current city weather.

WebMCP is a progressive enhancement. The site remains fully usable in browsers that do not implement the experimental API.

## Attribution

City information and article previews may include content from Wikipedia. Weather data is provided by the site’s weather provider. Results should be presented as current estimates and linked back to the relevant human-facing page when appropriate.