Skip to main content
Glama

Explain the weather

explain_weather
Read-onlyIdempotent

Explains weather in plain terms for conversation: why it feels colder than the temperature, whether rain will matter on a hike, whether wind matters, whether the trail will be muddy, humidity, fog, frost, pressure. It separates what the forecast says (facts, each labelled forecast or formula) from what we are reasoning (inferences, each with its basis and how sure we are) and lists what we cannot see (unknowns). Pass the question as asked, or a topic. If it cannot tell what was asked it says so and gives the general picture.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
topicNoThe topic, if you know it. Otherwise it is read from the question.
unitsNoimperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere.
activityNoWhat the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running.
latitudeNoLatitude in degrees. Use with longitude instead of location.
locationNoA place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places.
questionNoThe question as the person asked it, for example "Why does it feel colder than the temperature?".
longitudeNoLongitude in degrees, west negative. Use with latitude instead of location.
start_timeNoThe time the question is about. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed.
duration_hoursNoHow many hours to look at. Default 6.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior5/5

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

Annotations already cover the read-only, idempotent, open-world safety profile, so the description's value is in the behavior it adds: it discloses the response structure (facts labelled forecast or formula, inferences each with basis and confidence, an explicit list of unknowns) and failure behavior ('if it cannot tell what was asked it says so and gives the general picture'). That is substantive disclosure beyond the structured fields, and none of it contradicts the annotations.

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?

The purpose is front-loaded in the opening clause and every sentence carries information about capability, output shape, or fallback. It runs long for a tool description, but the length is earned by the breadth of topics covered; there is little filler.

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 9 optional parameters, no output schema, and full schema coverage, the description supplies the missing return-value semantics (facts vs inferences vs unknowns) and the ambiguity fallback, which an agent needs to interpret results. Minor gaps remain, such as how it resolves location vs latitude/longitude conflicts, but those are documented in the schema.

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%, so the schema already documents every parameter including enums, units defaults, and time formats. The description only adds 'pass the question as asked, or a topic' and the topic list, so the baseline of 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 states a specific verb and resource — explaining weather in plain conversation terms — and enumerates the kinds of questions it answers (feels-like, rain impact on a hike, mud, frost, pressure). This clearly separates it from data-fetching siblings like get_weather or get_forecast, which the description never names but implicitly contrasts by emphasizing reasoning over raw values.

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 rather than stated: the conversational framing ('for conversation', 'pass the question as asked, or a topic') signals when this tool fits, but there is no explicit when-to-use/when-not guidance and no named alternatives (get_weather, get_trail_weather, clothing_recommendation) that an agent should prefer for simple lookups.

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