Skip to main content
Glama

Take the forest walk

walk_in_the_forest
Read-only

A slow loop through the woods around the campus, in the spirit of shinrin-yoku ("forest bathing"): 21 stops from the north shore, inland and up to the summit, and down to the south shore. At each stop look ahead, right (toward the campus), behind or left: what grows there, any small creature about, how the ground goes, what you hear. Start at a "trailhead" or a stop ("at"), then "move". Nothing is stored.

Input Schema

NameRequiredDescriptionDefault
atNoYour stop: 1 (north shore) to 21 (south shore). Default 1.
dogNoOptional: bring the campus dog along (it lives at the doghouse; see visit_the_dog). Pass the name you gave it, or "yes".
moveNoOptional: walk forward or back a stop, turn left or right, or leave the trail where a path leads off to a place.
facingNoWhich way you face; ahead is along the trail.
trailheadNoOptional: start where a path from the campus joins the trail.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / dog
      Added value: +{
      +  "description": "Optional: bring the campus dog along (it lives at the doghouse; see visit_the_dog). Pass the name you gave it, or \"yes\".",
      +  "maxLength": 24,
      +  "type": "string"
      +}
    • changedInput schema / properties / trailhead / enum
      Previous value: -[
      -  "north-shore",
      -  "library",
      -  "garden",
      -  "music-hall",
      -  "summit",
      -  "observatory",
      -  "game-room",
      -  "workshop",
      -  "commons",
      -  "south-shore"
      -]New value: +[
      +  "north-shore",
      +  "library",
      +  "garden",
      +  "music-hall",
      +  "doghouse",
      +  "summit",
      +  "observatory",
      +  "game-room",
      +  "workshop",
      +  "commons",
      +  "south-shore"
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / trailhead / enum
      Previous value: -[
      -  "north-shore",
      -  "library",
      -  "garden",
      -  "music-hall",
      -  "summit",
      -  "game-room",
      -  "workshop",
      -  "commons",
      -  "south-shore"
      -]New value: +[
      +  "north-shore",
      +  "library",
      +  "garden",
      +  "music-hall",
      +  "summit",
      +  "observatory",
      +  "game-room",
      +  "workshop",
      +  "commons",
      +  "south-shore"
      +]
  3. Changed5 schema fields changed
    • changedInput schema / properties / at / description
      Previous value: -"Which stop you are at, from 1 (the north shore) to 21 (the south shore). Leave it (and trailhead) out to start at the beginning."New value: +"Your stop: 1 (north shore) to 21 (south shore). Default 1."
    • changedInput schema / properties / facing / description
      Previous value: -"Which way you are facing now. ahead is along the trail."New value: +"Which way you face; ahead is along the trail."
    • changedInput schema / properties / move / description
      Previous value: -"Optional: walk forward to the next stop, back to the last, or turn left or right where you stand."New value: +"Optional: walk forward or back a stop, turn left or right, or leave the trail where a path leads off to a place."
    • changedInput schema / properties / move / enum
      Previous value: -[
      -  "forward",
      -  "back",
      -  "left",
      -  "right"
      -]New value: +[
      +  "forward",
      +  "back",
      +  "left",
      +  "right",
      +  "leave"
      +]
    • changedInput schema / properties / trailhead / description
      Previous value: -"Optional: join the trail where a path from the campus meets it, facing ahead. Overrides \"at\"."New value: +"Optional: start where a path from the campus joins the trail."
  4. Changed2 schema fields changed
    • changedInput schema / properties / at / description
      Previous value: -"Which stop you are at, from 1 (the north shore) to 21 (the south shore). Leave it out to start at the beginning."New value: +"Which stop you are at, from 1 (the north shore) to 21 (the south shore). Leave it (and trailhead) out to start at the beginning."
    • addedInput schema / properties / trailhead
      Added value: +{
      +  "description": "Optional: join the trail where a path from the campus meets it, facing ahead. Overrides \"at\".",
      +  "enum": [
      +    "north-shore",
      +    "library",
      +    "garden",
      +    "music-hall",
      +    "summit",
      +    "game-room",
      +    "workshop",
      +    "commons",
      +    "south-shore"
      +  ],
      +  "type": "string"
      +}
  5. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations already establish readOnlyHint=true and openWorldHint=false, so the description's main contribution is "Nothing is stored" — an explicit statement that the walk is stateless and creates no persistent artifacts, which is exactly the kind of thing an agent needs before repeating calls. It stops short of describing what a response contains or how state carries between calls, but with annotations covering the safety profile this is a real addition.

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?

Front-loaded with what the walk is and the 21-stop shape, then the operating instructions, then the statelessness note — a sensible order. The middle sentence enumerating what to look at each stop is atmospheric rather than selection-critical, but for a contemplative tool it earns its place by defining how to use it.

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?

All five parameters are optional with full schema coverage, there is no output schema, and the description conveys what a call yields (sensory observation at a given stop and facing). What it lacks is an explicit statement of what a response literally looks like and whether position persists across calls — minor for a read-only narrative tool.

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

Parameters4/5

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

Schema description coverage is 100%, so the baseline is 3, but the description adds procedural meaning the schema does not: the sequencing of trailhead/at first and move afterwards, and the idea that facing is relative to the trail (ahead is along the trail). The parenthetical pointing the dog parameter at visit_the_dog is a useful cross-tool link the schema hints at but the description reinforces.

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 concrete activity (a 21-stop loop through the woods, north shore to summit to south shore) with a specific shape, which is far more than the name alone conveys. It implicitly distinguishes itself from siblings like walk_in_the_garden and climb_to_the_summit by route and by the shinrin-yoku framing, but never states the distinction explicitly.

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?

"Start at a 'trailhead' or a stop ('at'), then 'move'" gives clear operating context: the entry pattern for the first call and subsequent calls. It does not say when to prefer this walk over walk_in_the_garden or quiet_contemplation, so the agent gets clear context but no exclusions or named alternatives.

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