Skip to main content
Glama

IYT Test

Question of the day

question_of_the_day
Read-only

Today's question, the same one the Telegram bot @iyt_test_bot sends: one text question per day (UTC), for one level when a level is given, without the answer.

Input Schema

NameRequiredDescriptionDefault
langNoLanguage of the text: en (default) or ru. What is not translated yet comes in English.
levelNoLevel id, e.g. bareboat-skipper.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / level / description
      Previous value: -"Level id from list_levels, e.g. bareboat-skipper."New value: +"Level id, e.g. bareboat-skipper."
  2. First observed

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds genuinely useful behavior: the content is deterministic per UTC day, mirrors what @iyt_test_bot sends, and deliberately omits the answer. It does not describe the response shape or the empty-day case, so it adds context without fully characterizing the call.

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?

A single front-loaded sentence that leads with the resource and packs the scoping rules into clauses. The bot reference is slightly chatty but functional; no filler sentences.

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 correctly states what comes back (one text question, no answer) and the per-UTC-day cadence, which is the key context for a zero-required-parameter read tool. The only real gap is the behavior when today's question is unavailable or when level is omitted.

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?

Schema description coverage is 100%, with both lang (enum plus fallback note) and level documented, so the baseline is 3. The description clarifies that level narrows output to one level, but adds nothing on the lang fallback or on what an omitted level produces beyond that implication.

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 names a specific resource (today's question, one text question per day, UTC) and scopes it (a single level when provided, answer excluded). That implicitly separates it from get_questions (plural listing) and check_answer (returns the answer), though it never names those siblings explicitly.

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

Usage Guidelines3/5

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

Usage is implied by the daily/UTC framing and the bot-parity note, so an agent can infer 'call this for today's item'. There is no explicit when-to-use versus get_questions/search_questions guidance and no statement of what happens if no question exists for the current day.

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.