Skip to main content
Glama

Add Accommodation Option

add_accommodation_option

Propose somewhere to stay at a destination — hotel, hostel, apartment, house or camping. Add several options to the same destination so the user can compare them, then use select_destination_option once they pick one. Always include the total cost and currency, otherwise the trip budget will be wrong. Keep name a clean display name — price, town, dates and commentary belong in their own fields, not in name. Use stayDetails only for facts that help choose between this trip's options: never for what is equally true of all of them, and never for a guess.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "tripId": "<tripId>",
      "variantId": "<variantId>",
      "destinationKey": "<destinationKey>",
      "data": "<data>"
    },
    "name": "add_accommodation_option"
  }
}

Input Schema

NameRequiredDescriptionDefault
dataYesThe accommodation option to propose.
tripIdYesId of the trip, as returned by list_trips or get_trip.
variantIdYesId of the trip variant (an alternative version of the trip), from get_trip.
destinationKeyYesKey of the destination inside the variant, from get_trip (e.g. "destination-1").

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / data / properties / photos
      Added value: +{
      +  "description": "Photos of this stay, up to 12, as directly linkable http or https image URLs. Use only images the owner may use, such as their own photos or ones the property allows to be reused. Do not copy a gallery from a booking site or search results. Replaces the whole list. Pass null to clear.",
      +  "items": {
      +    "properties": {
      +      "credit": {
      +        "description": "Who to credit for the photo.",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "creditUrl": {
      +        "description": "Link to the credited person's page or the photo's source.",
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Directly linkable http or https image URL.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "url"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 12,
      +  "type": "array"
      +}
    • addedInput schema / properties / data / properties / stayDetails
      Added value: +{
      +  "description": "Optional facts that help the group choose between this trip's options. Add a property only when it separates this option from the others: never record what is equally true of all of them (if every option is central, say nothing about being central). Never invent or infer a fact; leave it out if it is unknown, and put anything still unverified in worthChecking. Say where a fact came from in sourceNote when that is not obvious. Keep prices out of these fields: they appear on share links even when prices are hidden. Empty properties stay hidden.",
      +  "properties": {
      +    "accessibility": {
      +      "anyOf": [
      +        {
      +          "description": "Step-free access, lifts and similar.",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "airConditioning": {
      +      "anyOf": [
      +        {
      +          "description": "Cooling, e.g. \"bedrooms only\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "author": {
      +      "anyOf": [
      +        {
      +          "description": "Who wrote these details. Agents should set \"agent\".",
      +          "enum": [
      +            "owner",
      +            "agent",
      +            "sonnet"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "bathrooms": {
      +      "anyOf": [
      +        {
      +          "description": "Number of bathrooms.",
      +          "maximum": 50,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "beach": {
      +      "anyOf": [
      +        {
      +          "description": "Beach access, e.g. \"private shingle beach below the house\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "bedLayout": {
      +      "anyOf": [
      +        {
      +          "description": "How the group would sleep, e.g. \"1 double + 2 bunks in one room\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "bedrooms": {
      +      "anyOf": [
      +        {
      +          "description": "Number of bedrooms.",
      +          "maximum": 100,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "bookability": {
      +      "anyOf": [
      +        {
      +          "description": "bookable: can be booked now. on_request: the owner must confirm first. price_unconfirmed: totalCost is an estimate.",
      +          "enum": [
      +            "bookable",
      +            "on_request",
      +            "price_unconfirmed"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "breakfast": {
      +      "anyOf": [
      +        {
      +          "description": "Whether breakfast is included, can be added, or is not offered.",
      +          "enum": [
      +            "included",
      +            "available",
      +            "none"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "dinner": {
      +      "anyOf": [
      +        {
      +          "description": "Dinner arrangements, e.g. \"half board\" or \"restaurant on site\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "highlight": {
      +      "anyOf": [
      +        {
      +          "description": "One line on what sets this stay apart from the other options.",
      +          "maxLength": 160,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "kidsFacilities": {
      +      "anyOf": [
      +        {
      +          "description": "Children's facilities, e.g. \"cot on request, playroom\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "kitchen": {
      +      "anyOf": [
      +        {
      +          "description": "Kitchen available to the group.",
      +          "enum": [
      +            "private",
      +            "shared",
      +            "none"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "laundry": {
      +      "anyOf": [
      +        {
      +          "description": "Laundry, e.g. \"washer in the flat, no dryer\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "mainLiftName": {
      +      "anyOf": [
      +        {
      +          "description": "Name of the lift this stay would mainly use. It corrects routing when the nearest lift on the map is the wrong one.",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "maxGuests": {
      +      "anyOf": [
      +        {
      +          "description": "Most guests the listing allows.",
      +          "maximum": 500,
      +          "minimum": 1,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "noise": {
      +      "anyOf": [
      +        {
      +          "description": "Noise reported at this stay, e.g. \"reviews mention bar noise until 2am\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "parking": {
      +      "anyOf": [
      +        {
      +          "description": "Parking arrangements, e.g. \"garage, must be booked ahead\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "pets": {
      +      "anyOf": [
      +        {
      +          "description": "Pet policy.",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "pool": {
      +      "anyOf": [
      +        {
      +          "description": "Pool details, e.g. \"heated indoor pool, 10 to 18 only\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "sizeInM2": {
      +      "anyOf": [
      +        {
      +          "description": "Size of the unit in square metres.",
      +          "maximum": 100000,
      +          "minimum": 1,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "skiBack": {
      +      "anyOf": [
      +        {
      +          "description": "Whether you can ski back to the door. Set only when the listing, the owner or a piste map confirms it; never infer it from distance.",
      +          "enum": [
      +            "yes",
      +            "partly",
      +            "no"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "skiBackNote": {
      +      "anyOf": [
      +        {
      +          "description": "What the ski-back answer depends on, e.g. \"only via the blue run, closes in March\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "skiStorage": {
      +      "anyOf": [
      +        {
      +          "description": "Ski and boot storage, e.g. \"heated boot room\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "sourceNote": {
      +      "anyOf": [
      +        {
      +          "description": "Where these facts came from when that is not obvious, e.g. \"Booking.com listing and two reviews, Oct 2026\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "view": {
      +      "anyOf": [
      +        {
      +          "description": "What you see from the stay, e.g. \"south-facing balcony over the valley\".",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "wellness": {
      +      "anyOf": [
      +        {
      +          "description": "Sauna, spa or similar.",
      +          "maxLength": 300,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "worthChecking": {
      +      "anyOf": [
      +        {
      +          "description": "Things to confirm before booking, one per entry. Replaces the whole list. Hidden on share links that hide notes.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "maxItems": 10,
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / data / properties / website
      Added value: +{
      +  "description": "The property's own official website, not a booking or listing site. Links to photos on it may be shown automatically, crediting the site. Leave it out when you cannot confirm the official site.",
      +  "type": "string"
      +}
  2. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare this is a non-read-only, non-idempotent, open-world mutation, so the safety profile is covered. The description adds real behavioral context beyond that: the mutation feeds the trip budget (wrong costs corrupt downstream state), repeated calls build a comparison set, and stayDetails must never contain guesses or facts common to all options. It stops short of saying what is returned (e.g. an option id needed for later updates).

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?

Five compact sentences, front-loaded with purpose then workflow, then the two data-quality constraints. Every sentence carries a rule. Minor redundancy where the name and stayDetails rules partially restate the schema's own wording, but nothing is padded or throat-clearing.

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?

For a deeply nested four-parameter mutation with no output schema, the description covers workflow, required cost data, field-placement discipline and anti-hallucination rules. The main omission is return/identity information — an agent is not told what comes back or how to reference the created option for update_destination_option later.

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 the baseline is 3, but the description adds meaning the schema does not: the consequence of omitting totalCost/currency (budget correctness), the negative rule that price, town, dates and commentary must not be folded into name, and a selection criterion for stayDetails (only facts that differentiate this option). That is useful semantic guidance layered on top of an already documented schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Propose somewhere to stay at a destination") and immediately enumerates the covered types — hotel, hostel, apartment, house, camping — which maps directly to the `type` enum. It is clearly distinguishable from siblings like add_destination or add_transport_option without opening a schema.

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

Usage Guidelines5/5

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

Explicitly prescribes the workflow: add several options to the same destination for comparison, then call select_destination_option once the user picks one, naming the alternative tool and the condition that selects it. It also states hard inclusion rules (always total cost and currency) and a field-placement rule for name vs. other fields.

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.