Skip to main content
Glama

Walk in the quiet garden

walk_in_the_garden
Read-only

The quiet garden, a walled sculpture garden north of the quad: its old stone fountain, the flowers in bloom this month, the birds passing over now, and five public-domain sculptures. Name a "sculpture" to stand in front of it (show_image: true adds its photograph), or a "flower" to smell it. Nothing is stored.

Input Schema

NameRequiredDescriptionDefault
flowerNoOptional: a flower to smell, such as "rose" or "lavender".
sculptureNoOptional: a sculpture's slug or title, such as "crane" or "heqat".
show_imageNoWith "sculpture": true to include its photograph (a JPEG about 600 pixels tall).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / flower / description
      Previous value: -"Optional: a flower to stop and smell, such as \"rose\", \"lavender\", \"wisteria\" or \"witch-hazel\"."New value: +"Optional: a flower to smell, such as \"rose\" or \"lavender\"."
    • changedInput schema / properties / sculpture / description
      Previous value: -"Optional: a sculpture's slug or title, such as \"crane\", \"heqat\", \"amor-caritas\", \"monkey-fountain-figure\" or \"java-deer\"."New value: +"Optional: a sculpture's slug or title, such as \"crane\" or \"heqat\"."
  2. Changed1 schema field changed
    • addedInput schema / properties / flower
      Added value: +{
      +  "description": "Optional: a flower to stop and smell, such as \"rose\", \"lavender\", \"wisteria\" or \"witch-hazel\".",
      +  "maxLength": 60,
      +  "type": "string"
      +}
  3. Added

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false; the description reinforces this with "Nothing is stored," which explicitly closes the side-effect question. It also signals time-varying content ("flowers in bloom this month, the birds passing over now"), telling the agent results are not static. It omits response shape and what happens if a named sculpture/flower is unknown, but the annotation bar is already met.

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?

Two sentences, front-loaded with the garden's contents, then the invocation options and the no-storage note. The evocative phrasing is intentional for this tool family and does not obscure the operative instructions. Slight poetic padding ("old stone fountain," "birds passing over now") keeps it from a 5.

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 zero required params, full schema coverage, and no output schema, the description carries the right load: it tells the agent what content exists and how params shape the walk. Only gap is failure behavior for an unrecognized sculpture or flower slug, which matters given free-text string inputs.

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 coverage is 100%, so the baseline is 3. The description frames each parameter narratively (stand in front of a sculpture, smell a flower) and indicates show_image is scoped to the sculpture case, but the schema already states "With 'sculpture': true to include its photograph," so little new meaning is added.

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 concretely states what the tool surfaces: a walled sculpture garden with a stone fountain, in-bloom flowers, passing birds, and five public-domain sculptures. That is enough to distinguish it from siblings like walk_in_the_forest or visit_the_museum by subject matter. It stops short of a literal verb+resource statement ("returns a walk-through view of..."), so it is clear rather than exemplary.

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?

"Name a 'sculpture'... or a 'flower'..." implies how to steer the call, and "show_image: true adds its photograph" implies the modifier usage. But nothing says when to pick this over walk_in_the_forest, look_around, or visit_the_museum, and no exclusions or preconditions are given. Usage is inferable only.

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