Skip to main content
Glama

TradePilot Agent Commerce

Explicit-offset timestamp converter

tradepilot_service_timestamp_timezone_convert
Destructive

Convert an ISO timestamp with an explicit offset to UTC, Unix milliseconds and an IANA timezone display. Rejects ambiguous offset-free local times, invalid dates and leap seconds. Display uses runtime timezone data; years 1900–9999 only. Price: 0.01 USD. Payment requires explicit wallet authorization.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
inputYes
result_expiresNo
idempotency_keyNo
result_signatureNo
payment_signatureNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior5/5

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

The description goes well beyond the annotations by disclosing the paid nature (0.01 USD), the need for explicit wallet authorization, the runtime timezone data dependency, and the validation rejections. It aligns with destructiveHint by flagging the financial side effect and does not contradict any annotation.

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

Conciseness5/5

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

Five short sentences with no filler. The main purpose is front-loaded, and each sentence adds a distinct piece of information: conversion outputs, validation behavior, timezone data caveat, price, and payment requirement.

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

Completeness3/5

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

The core conversion behavior, return value types, validation rules, and cost are all covered, which is good given there is no output schema. However, the optional signed-result and payment parameters are left unexplained, and the description does not tell an agent how to provide the required wallet authorization. For a paid tool with 0% schema coverage, this is a meaningful gap.

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

Parameters2/5

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

Schema description coverage is 0%, and the description does not name or explain the five parameters. It does clarify the `iso` value (explicit offset, year range) and the `time_zone` output (IANA display), but it says nothing about `result_expires`, `idempotency_key`, `result_signature`, or `payment_signature` beyond a general payment-authorization note. This leaves important protocol fields undocumented.

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 uses a specific verb ('Convert') with a precise resource ('ISO timestamp with an explicit offset') and names three concrete outputs: UTC, Unix milliseconds, and an IANA timezone display. This clearly distinguishes it from the many content-generation sibling tools.

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?

The description gives clear eligibility constraints: explicit offset required, offset-free local times rejected, invalid dates and leap seconds rejected, and years limited to 1900–9999. It does not name alternative tools, but no sibling appears to be a timestamp converter, and the exclusions are sufficient for an agent to decide when to use it.

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