Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TIME_SERVER_MIN_SOURCES | No | Minimum number of sources required (1 to 10) | 3 |
| TIME_SERVER_NTP_SERVERS | No | NTP Servers (comma-separated) | time.cloudflare.com,time.google.com,time.apple.com |
| TIME_SERVER_NTP_TIMEOUT | No | NTP timeout in seconds (0.5 to 10.0) | 2.0 |
| TIME_SERVER_MAX_DISAGREEMENT_MS | No | Maximum disagreement before warning in milliseconds (10.0 to 5000.0) | 250.0 |
| TIME_SERVER_FAST_MODE_SERVER_COUNT | No | Number of servers to query in fast mode (2 to 10) | 4 |
| TIME_SERVER_MAX_OUTLIER_DEVIATION_MS | No | Maximum outlier deviation in milliseconds (100.0 to 60000.0) | 5000.0 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_time_utc | Get current UTC time with high accuracy using NTP consensus. Queries multiple NTP servers, removes outliers, and computes a consensus time
that is independent of the system clock. Returns detailed information about
all sources, consensus method, and estimated error.
By default, the returned timestamp is compensated for the time it took to
query NTP servers and compute consensus. This means the timestamp represents
the time when the response is returned, not when NTP servers were queried.
Args:
mode: Accuracy mode - "fast" uses 3-4 servers, "accurate" uses 7 servers
compensate_latency: If True, add query duration to timestamp (default: True)
Returns:
TimeResponse with consensus time and metadata |
| get_time_for_timezone | Get current time for a specific timezone with high accuracy. Queries multiple NTP servers for accurate UTC time, then converts to the
requested timezone. Includes all consensus metadata and source details.
Args:
timezone_name: IANA timezone name (e.g., "America/New_York")
mode: Accuracy mode - "fast" or "accurate"
compensate_latency: If True, add query duration to timestamp (default: True)
Returns:
TimezoneResponse with time in specified timezone |
| compare_system_clock | Compare system clock against trusted NTP time sources. Useful for detecting system clock drift or misconfiguration. Queries NTP
servers and reports the difference between system time and consensus time.
Args:
mode: Accuracy mode - "fast" or "accurate"
Returns:
ClockComparisonResponse with comparison data |
| get_local_time | Get current time for a specific IANA timezone with high accuracy. Uses NTP consensus for accurate UTC time, then converts to the requested
timezone using IANA tzdata. This provides authoritative local time independent
of system clock accuracy.
Args:
timezone: IANA timezone identifier (e.g., "America/New_York", "Europe/London")
mode: Accuracy mode - "fast" or "accurate"
compensate_latency: If True, add query duration to timestamp (default: True)
Returns:
LocalTimeResponse with local time and timezone metadata |
| convert_time | Convert a datetime from one timezone to another using IANA rules. Performs timezone conversion independent of system clock. Uses IANA tzdata
to handle all DST transitions, historical changes, and political boundaries.
Args:
datetime_str: ISO 8601 datetime string (naive, will be interpreted in from_timezone)
from_timezone: Source IANA timezone identifier
to_timezone: Target IANA timezone identifier
Returns:
TimezoneConversionResponse with conversion details and explanation |
| list_timezones | List available IANA timezones with optional filtering. Returns all valid IANA timezone identifiers. Helps discover correct timezone
names and prevents hallucination of invalid timezones.
Args:
country_code: Optional ISO 3166 country code filter (e.g., "US", "GB", "FR")
search: Optional substring search filter (case-insensitive)
Returns:
ListTimezonesResponse with list of timezones and metadata |
| get_timezone_info | Get detailed information about a timezone including upcoming transitions. Provides comprehensive timezone metadata including current offset, DST status,
and upcoming transitions (e.g., DST changes). Useful for planning and
understanding timezone behavior.
Args:
timezone: IANA timezone identifier
mode: Accuracy mode for getting current time - "fast" or "accurate"
Returns:
TimezoneDetailResponse with current info and transition schedule |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |