Skip to main content
Glama

Current time in a time zone

time_now

Use when an agent must stamp or schedule something in a particular place and needs every form at once: ISO with offset, 24-hour, 12-hour, weekday, unix timestamp and UTC. It also says whether daylight saving is active right now and what the zone's standard offset is, so a shifted clock can be told apart from a permanent one. $0.005 per call, paid over x402 (USDC).

Input Schema

NameRequiredDescriptionDefault
zoneYesIANA time zone, e.g. "Asia/Tokyo" or "UTC". Required.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.9/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 does well: it discloses the returned fields (including DST-active flag and standard offset to distinguish a shifted clock from a permanent one) and, unusually, the cost and payment mechanism ($0.005/call over x402 USDC). It omits error behavior for invalid zone strings and any latency expectation.

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?

Three sentences, front-loaded with the 'Use when' trigger, and the output enumeration is informative rather than filler. The pricing sentence sits slightly apart from the functional narrative but still earns its place.

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

Completeness4/5

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

With no output schema, the description must — and does — enumerate the return values, including DST state and standard offset. Combined with the cost disclosure, an agent knows what it gets and what it pays; only failure modes for bad zone input are unaddressed.

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

Parameters3/5

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

There is a single parameter with 100% schema description coverage that already specifies IANA format and requiredness. The description says 'in a particular place' but adds no format, casing, or rejection guidance beyond the schema, so the baseline 3 applies.

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

Purpose4/5

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

The description makes clear this returns the current time in a place, and enumerates the exact output forms (ISO with offset, 24-hour, 12-hour, weekday, unix, UTC) plus DST status and standard offset. It never names the obvious siblings time_convert or time_zones, so the boundary between this and those is left to inference.

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?

'Use when an agent must stamp or schedule something in a particular place and needs every form at once' gives a concrete triggering condition. However, there is no explicit when-not or pointer to time_convert/time_zones for agents that only need one format or a cross-zone conversion.

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