Skip to main content
Glama

Update Destination Option

update_destination_option
Idempotent

Edit an existing accommodation, transport or getting-around option — correct a price, add a booking link, adjust check-in dates. Say which kind of option it is and pass the option key from get_trip. Only the fields you send are changed. On accommodation, 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>",
      "kind": "<kind>",
      "optionKey": "<optionKey>"
    },
    "name": "update_destination_option"
  }
}

Input Schema

NameRequiredDescriptionDefault
dataNoFields to change. Send only the fields that apply to this kind of option.
kindYesWhich kind of option is being edited.
tripIdYesId of the trip, as returned by list_trips or get_trip.
optionKeyYesKey of the accommodation / transport / getting-around option, from get_trip. Same value that select_destination_option calls optionId — the API names it inconsistently.
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. Changed1 schema field changed
    • addedInput schema / properties / data / properties / isBooked
      Added value: +{
      +  "description": "Whether this stay is actually booked. Set true only once the person has reserved it, not when it is just the favourite.",
      +  "type": "boolean"
      +}
  2. Changed2 schema fields changed
    • addedInput schema / properties / data / properties / photos
      Added value: +{
      +  "anyOf": [
      +    {
      +      "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"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / properties / data / properties / stayDetails
      Added value: +{
      +  "anyOf": [
      +    {
      +      "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. Only the properties you send change; pass null for a property to clear it, or null here to clear them all.",
      +      "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"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
  3. First observed

TDQS

A4.7/5.0
Behavior4/5

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

While annotations provide the read/write status, the description clarifies key operational behavior: 'Only the fields you send are changed.' This is an essential hint for an AI agent performing partial 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?

The definition is highly dense and prioritizes functional instructions over conversational fluff. It is concise but very heavy with operational constraints.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description effectively covers the complexities of the resource, particularly by guiding the agent on the specific business rules for filling out the stayDetails object which is key to this tool's correct usage.

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

Parameters5/5

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

Even with 100% schema coverage, the description is vital. It dictates the semantics of specific fields like stayDetails and name, telling the agent when a fact should or should not be placed in certain fields.

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?

The description clearly defines the action (Edit), the resource (destination option), and the scope (accommodation, transport, or getting-around). This distinguishes it from other sibling tools like update_trip or update_event.

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?

It provides strong usage guidelines by explicitly stating that the option key must be sourced from get_trip and defines critical constraints for using the stayDetails parameter to prevent hallucinations or generic data entry.

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.