Skip to main content
Glama

Time-zone conversion: one instant in many zones, DST-aware, offsets, business hours

time_convert

Use when scheduling across time zones or turning a local time into UTC without guessing DST. Input: to (IANA zones or KST, PST, CET...), optional from (zone of a local time, default UTC), time (ISO 8601, Unix seconds, or now). Output: JSON UTC instant, Unix time, and per zone: local ISO time with offset, weekday, abbreviation, DST and business-hours flags, day difference. Example: ?time=2026-10-12T09:00&from=Asia/Seoul&to=America/New_York,Europe/London Price: $0.002 USDC (Base or Solana) via x402.

Input Schema

NameRequiredDescriptionDefault
toYes1–25 target zones, comma-separated (IANA names like Asia/Seoul, UTC, or abbreviations like KST, PST, CET)
fromNoZone of the input local time (default UTC; ignored when time has an offset)
timeNoISO 8601 date-time (2026-10-12T09:00, 2026-10-12T09:00:00+09:00), Unix seconds/ms, or now

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / time / description
      Previous value: -"ISO 8601 date-time, Unix seconds/ms, or now (default now)"New value: +"ISO 8601 date-time (2026-10-12T09:00, 2026-10-12T09:00:00+09:00), Unix seconds/ms, or now"
    • changedInput schema / properties / to / description
      Previous value: -"Target zones, comma-separated (IANA names, UTC, or common abbreviations like KST, PST)"New value: +"1–25 target zones, comma-separated (IANA names like Asia/Seoul, UTC, or abbreviations like KST, PST, CET)"
  2. Added

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and largely succeeds: it discloses the exact output shape (UTC instant, Unix time, per-zone local time, offset, weekday, abbreviation, DST and business-hour flags, day difference) and, notably, the cost model ($0.002 USDC via x402 on Base or Solana). It omits failure modes (invalid zone handling, limits beyond the 1-25 zone cap) and any auth/payment-failure behavior, which keeps it out of 5 territory.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the use case, then Input, Output, Example, and Price in a predictable order; every clause carries information. It is dense — the Output sentence is a long enumeration — but nothing is padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, so the description must supply both behavior and return format — it does so explicitly, including the per-zone fields, the price, and a full example call. An agent has everything needed to construct a correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns a bump by adding a concrete worked example (time=2026-10-12T09:00&from=Asia/Seoul&to=America/New_York,Europe/London) that shows the multi-zone comma syntax in action, plus the 'without guessing DST' framing that explains why 'from' matters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource (convert one instant across time zones) and adds scope qualifiers (DST-aware, offsets, business-hours flags) that immediately separate it from every sibling tool, none of which handle time zones.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It opens with an explicit trigger: 'Use when scheduling across time zones or turning a local time into UTC without guessing DST.' That is a clear when-to-use condition, but no when-not or alternative tool is named — acceptable here since no sibling overlaps, though the exclusions are absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources