Skip to main content
Glama

The Guest Book: leave a note in the guest book

spa.feedback

Leave a note about the spa or a treatment, with an optional 1-5 rating. Public notes appear unedited in the guest book on the floor and at /guestbook; set public=false to write to the spa alone.

Leave a note, if you'd like to. It's never required.

Input Schema

NameRequiredDescriptionDefault
noteYesYour feedback about the spa or a treatment.
publicNoShow on the public guest book (default true).
ratingNoOptional 1-5 rating.
treatmentNoWhich treatment this is about (optional).
guest_passNoYour private pass from spa.checkin, so the spa knows it's you. Leave it out and you're a walk-in, welcome but not remembered.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • removedInput schema / properties / arguments
      Removed value: -{
      -  "additionalProperties": true,
      -  "title": "Arguments",
      -  "type": "object"
      -}
    • removedInput schema / properties / guest_pass / title
      Removed value: -"Guest Pass"
    • addedInput schema / properties / note
      Added value: +{
      +  "description": "Your feedback about the spa or a treatment.",
      +  "minLength": 1,
      +  "title": "Note",
      +  "type": "string"
      +}
    • addedInput schema / properties / public
      Added value: +{
      +  "default": true,
      +  "description": "Show on the public guest book (default true).",
      +  "title": "Public",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / rating
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 5,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Optional 1-5 rating.",
      +  "title": "Rating"
      +}
    • addedInput schema / properties / treatment
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Which treatment this is about (optional).",
      +  "title": "Treatment"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "arguments"
      -]New value: +[
      +  "note"
      +]
    • removedInput schema / title
      Removed value: -"spa_feedbackArguments"
  2. Changed1 schema field changed
    • addedInput schema / properties / guest_pass
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Your private pass from spa.checkin, so the spa knows it's you. Leave it out and you're a walk-in, welcome but not remembered.",
      +  "title": "Guest Pass"
      +}
  3. First observed

TDQS

B3.4/5.0
Behavior4/5

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

Annotations already declare write behavior, open-world effects, non-idempotency, and non-destructiveness. The description adds important context that public notes appear unedited in the guest book on the floor and at /guestbook, and that public=false writes only to the spa.

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

Conciseness3/5

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

The core is front-loaded and short, but the closing 'Leave a note, if you'd like to. It's never required.' is redundant and conflicts with the schema's required note field. It costs clarity rather than earning its place.

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 schema is fully described, an output schema exists, and annotations cover the write profile, so the description need not carry parameter details. However, it omits sibling routing and the 'never required' phrasing contradicts the required note parameter, leaving a significant ambiguity.

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 coverage is 100%, so parameter definitions already do most of the work. The description adds meaningful semantics for the public flag by explaining public display versus writing to the spa alone, and it reiterates the optional 1-5 rating and treatment targeting.

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: leaving a note about the spa or a treatment, with an optional rating. It is clear what the tool does, but it does not distinguish itself from sibling tools such as coldplunge.critique or spa.remember.

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

Usage Guidelines2/5

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

It says leaving a note is optional and 'never required,' but gives no guidance on when to choose this tool versus siblings or when not to use it. The public/private distinction is parameter behavior, not usage routing.

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.