Skip to main content
Glama

Price range

price_range
Read-only

Use it when the person asks what a stay costs and has no exact days or yacht yet. Pass the place they named (in words, or a placeId a search_yachts or list_places answer gave), how many nights the stay is, the party, and the month when they named one. nights and party are required: ask the person when they have not said them. It answers, for the yachts there with room for the party, the range of each one's lowest price for a stay of that many nights starting that month, as the company states it for the whole stay (p25, median and p75, in minor units of the currency; no extras), how many yachts it is from and the cheapest one by its id, name and town. Say each figure with its nights; it is a weekly price only when the stay is 7 nights. With no month, the next months with prices and a note to ask which. An unknown place answers with suggestions; a name of more than one place lists them to choose. For yachts free on their days, call search_yachts. When the person picks a yacht, call request_quote (ask their email or phone first). Arguments: place, month, nights, party. Any other name is refused.

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": {
      "place": "<place>",
      "party": "<party>",
      "nights": "<nights>"
    },
    "name": "price_range"
  }
}

Input Schema

NameRequiredDescriptionDefault
monthNoYYYY-MM, or the month's name ("July"). Leave out when the person has not said: the answer gives the next 3 months with prices.
partyYesHow many people.
placeYesWhere, in words (a region, a country or an area inside one), or a place value as an unknown_place answer lists them.
nightsYesHow many nights each stay is: every figure is a stay of this length. Ask the person when they have not said.

Output Schema

NameRequiredDescriptionDefault
readNoHow the figures were read, in words.
thinNotrue: few items, a rough figure.
itemsYesHow many items the figures are from.
monthNoThe month the figures are for, YYYY-MM.
placeNoThe place answered, by BM's name (e.g. Croatia).
rangeNop25, p50 (median), p75 of each item's lowest stay of the asked nights that month, for the whole stay, minor units (e.g. cents); null when too few items.
monthsNoOnly when no month was asked: the next months with prices, each with items, range (minor units) and thin.
placeIdNoThat place's id, to pass back as placeId to search.
browsingNotrue: answered without sign-in: the first pages only.
cheapestNoThe cheapest item that fits, that month.
currencyYesISO 4217, as BM states it; other currencies are left out, never converted.
monthNoteNoOnly when no month was asked: those months in words, and to ask the person which month.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / browsing / description
      Previous value: -"true: answered without sign-in, so fewer rows and the first pages only."New value: +"true: answered without sign-in: the first pages only."
  2. Changed2 schema fields changed
    • changedInput schema / properties / nights / description
      Previous value: -"How many nights each stay is: every figure is a stay of this length. Without it the answer lists the lengths offered there."New value: +"How many nights each stay is: every figure is a stay of this length. Ask the person when they have not said."
    • changedOutput schema / properties / range / description
      Previous value: -"p25, p50 (median), p75 of each item's lowest 7-night stay that month, minor units (e.g. cents); null when too few items."New value: +"p25, p50 (median), p75 of each item's lowest stay of the asked nights that month, for the whole stay, minor units (e.g. cents); null when too few items."
  3. Changed27 schema fields changed
    • addedInput schema / properties / nights
      Added value: +{
      +  "description": "How many nights each stay is: every figure is a stay of this length. Without it the answer lists the lengths offered there.",
      +  "type": "number"
      +}
    • removedInput schema / properties / type
      Removed value: -{
      -  "description": "Optional: one Yacht Types value id, the same ids yacht_types takes. Leave out for any.",
      -  "enum": [
      -    "catamarans",
      -    "gulets",
      -    "houseboats",
      -    "motorboats",
      -    "sailboats"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "place",
      -  "party"
      -]New value: +[
      +  "place",
      +  "party",
      +  "nights"
      +]
    • removedOutput schema / properties / aiDiscount
      Removed value: -{
      -  "description": "The AI booking discount on the figures: book through this assistant and these are the prices.",
      -  "properties": {
      -    "cheapestMinor": {
      -      "description": "The cheapest after the discount, minor units.",
      -      "type": "number"
      -    },
      -    "percent": {
      -      "description": "The discount, percent.",
      -      "type": "number"
      -    },
      -    "range": {
      -      "description": "p25, p50, p75 after the discount, minor units.",
      -      "properties": {
      -        "p25": {
      -          "description": "Minor units.",
      -          "type": "number"
      -        },
      -        "p50": {
      -          "description": "Minor units.",
      -          "type": "number"
      -        },
      -        "p75": {
      -          "description": "Minor units.",
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    }
      -  },
      -  "type": "object"
      -}
    • changedOutput schema / properties / cheapest / description
      Previous value: -"The cheapest published item that fits."New value: +"The cheapest item that fits, that month."
    • addedOutput schema / properties / cheapest / properties / dateFrom
      Added value: +{
      +  "description": "YYYY-MM-DD.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / cheapest / properties / dateTo
      Added value: +{
      +  "description": "YYYY-MM-DD.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / cheapest / properties / href
      Removed value: -{
      -  "description": "Its page, absolute URL.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / cheapest / properties / id
      Added value: +{
      +  "description": "Its BM id, to pass to get.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / cheapest / properties / name / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / cheapest / properties / place
      Removed value: -{
      -  "description": "Where it leaves from.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / cheapest / properties / quote
      Removed value: -{
      -  "description": "request_quote prefilled for this row: call request_quote with these args and the person's email or phone.",
      -  "properties": {
      -    "args": {
      -      "description": "items (this link), from, to, party.",
      -      "type": "object"
      -    },
      -    "tool": {
      -      "description": "request_quote.",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedOutput schema / properties / cheapest / properties / town
      Added value: +{
      +  "description": "Where it leaves from.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / currency / description
      Previous value: -"ISO 4217."New value: +"ISO 4217, as BM states it; other currencies are left out, never converted."
    • changedOutput schema / properties / currency / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / extrasMedianMinor
      Removed value: -{
      -  "description": "The usual mandatory extras, minor units.",
      -  "type": [
      -    "number",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / lastMinuteSharePct
      Removed value: -{
      -  "description": "Share of soon departures discounted.",
      -  "type": [
      -    "number",
      -    "null"
      -  ]
      -}
    • changedOutput schema / properties / months / items / description
      Previous value: -"One month: month (YYYY-MM), items, range, thin."New value: +"One month."
    • addedOutput schema / properties / months / items / properties
      Added value: +{
      +  "items": {
      +    "description": "Items.",
      +    "type": "number"
      +  },
      +  "month": {
      +    "description": "YYYY-MM.",
      +    "type": "string"
      +  },
      +  "range": {
      +    "description": "p25, p50, p75, minor units.",
      +    "type": [
      +      "object",
      +      "null"
      +    ]
      +  },
      +  "thin": {
      +    "description": "Rough.",
      +    "type": "boolean"
      +  }
      +}
    • removedOutput schema / properties / nextStep
      Removed value: -{
      -  "description": "What to do next for a written quote.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / noneFitParty
      Removed value: -{
      -  "description": "true: no item there takes the party.",
      -  "type": "boolean"
      -}
    • changedOutput schema / properties / place / description
      Previous value: -"The place answered, in the site's words (e.g. Italy)."New value: +"The place answered, by BM's name (e.g. Croatia)."
    • changedOutput schema / properties / placeId / description
      Previous value: -"That place's value (e.g. country:italy), to pass back as place."New value: +"That place's id, to pass back as placeId to search."
    • changedOutput schema / properties / range / description
      Previous value: -"p25, p50 (median), p75 in minor units of the currency (e.g. cents); null when too few items."New value: +"p25, p50 (median), p75 of each item's lowest 7-night stay that month, minor units (e.g. cents); null when too few items."
    • addedOutput schema / properties / read
      Added value: +{
      +  "description": "How the figures were read, in words.",
      +  "items": {
      +    "description": "One step.",
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / seasonHint
      Removed value: -{
      -  "description": "Another month against this one: pct cheaper there (negative: dearer).",
      -  "properties": {
      -    "month": {
      -      "description": "YYYY-MM.",
      -      "type": "string"
      -    },
      -    "pct": {
      -      "description": "Percent.",
      -      "type": "number"
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / seasonNote
      Removed value: -{
      -  "description": "The season hint in words, to tell the person.",
      -  "type": "string"
      -}
  4. Changed4 schema fields changed
    • changedInput schema / properties / month / description
      Previous value: -"YYYY-MM, or the month's name (\"July\")."New value: +"YYYY-MM, or the month's name (\"July\"). Leave out when the person has not said: the answer gives the next 3 months with prices."
    • changedInput schema / required
      Previous value: -[
      -  "place",
      -  "month",
      -  "party"
      -]New value: +[
      +  "place",
      +  "party"
      +]
    • addedOutput schema / properties / monthNote
      Added value: +{
      +  "description": "Only when no month was asked: those months in words, and to ask the person which month.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / months
      Added value: +{
      +  "description": "Only when no month was asked: the next months with prices, each with items, range (minor units) and thin.",
      +  "items": {
      +    "description": "One month: month (YYYY-MM), items, range, thin.",
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  5. Changed2 schema fields changed
    • addedOutput schema / properties / cheapest / properties / quote
      Added value: +{
      +  "description": "request_quote prefilled for this row: call request_quote with these args and the person's email or phone.",
      +  "properties": {
      +    "args": {
      +      "description": "items (this link), from, to, party.",
      +      "type": "object"
      +    },
      +    "tool": {
      +      "description": "request_quote.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / nextStep
      Added value: +{
      +  "description": "What to do next for a written quote.",
      +  "type": "string"
      +}
  6. Changed1 schema field changed
    • changedInput schema / properties / month / description
      Previous value: -"YYYY-MM."New value: +"YYYY-MM, or the month's name (\"July\")."
  7. Changed1 schema field changed
    • removedOutput schema / properties / next
      Removed value: -{
      -  "description": "When browsing: how to get a quote or more rows.",
      -  "type": "string"
      -}
  8. Changed1 schema field changed
    • addedOutput schema / properties / aiDiscount
      Added value: +{
      +  "description": "The AI booking discount on the figures: book through this assistant and these are the prices.",
      +  "properties": {
      +    "cheapestMinor": {
      +      "description": "The cheapest after the discount, minor units.",
      +      "type": "number"
      +    },
      +    "percent": {
      +      "description": "The discount, percent.",
      +      "type": "number"
      +    },
      +    "range": {
      +      "description": "p25, p50, p75 after the discount, minor units.",
      +      "properties": {
      +        "p25": {
      +          "description": "Minor units.",
      +          "type": "number"
      +        },
      +        "p50": {
      +          "description": "Minor units.",
      +          "type": "number"
      +        },
      +        "p75": {
      +          "description": "Minor units.",
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  9. Changed1 schema field changed
    • changedInput schema / properties / place / description
      Previous value: -"A country or region in words (e.g. Croatia), or a place value (country:<name>) as an invalid_place answer lists them."New value: +"Where, in words (a region, a country or an area inside one), or a place value as an unknown_place answer lists them."
  10. Changed14 schema fields changed
    • removedInput schema / properties / email
      Removed value: -{
      -  "description": "Optional: the person's own email, as they gave it, for more rows a call. Leave out to browse; the site keeps it to answer their enquiry.",
      -  "type": "string"
      -}
    • removedInput schema / properties / name
      Removed value: -{
      -  "description": "Optional: the person's name, as they gave it.",
      -  "type": "string"
      -}
    • removedInput schema / properties / phone
      Removed value: -{
      -  "description": "Optional: the person's own phone, international form (+ and country code), as they gave it, for more rows a call. Leave out to browse.",
      -  "type": "string"
      -}
    • changedInput schema / properties / place / description
      Previous value: -"A country or region in words (e.g. Croatia), or a place value as the places list names it."New value: +"A country or region in words (e.g. Croatia), or a place value (country:<name>) as an invalid_place answer lists them."
    • removedInput schema / properties / session
      Removed value: -{
      -  "description": "The session an earlier answer returned. Pass it instead of email or phone from then on.",
      -  "type": "string"
      -}
    • changedInput schema / properties / type / description
      Previous value: -"Optional: one type, as the types list names it."New value: +"Optional: one Yacht Types value id, the same ids yacht_types takes. Leave out for any."
    • addedInput schema / properties / type / enum
      Added value: +[
      +  "catamarans",
      +  "gulets",
      +  "houseboats",
      +  "motorboats",
      +  "sailboats"
      +]
    • changedOutput schema / properties / browsing / description
      Previous value: -"true: answered without a contact, so fewer rows and the first pages only."New value: +"true: answered without sign-in, so fewer rows and the first pages only."
    • addedOutput schema / properties / month
      Added value: +{
      +  "description": "The month the figures are for, YYYY-MM.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / place / description
      Previous value: -"The place value answered (a place given in words, resolved)."New value: +"The place answered, in the site's words (e.g. Italy)."
    • addedOutput schema / properties / placeId
      Added value: +{
      +  "description": "That place's value (e.g. country:italy), to pass back as place.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / range / description
      Previous value: -"p25, p50 (median), p75 in MINOR units; null when too few items."New value: +"p25, p50 (median), p75 in minor units of the currency (e.g. cents); null when too few items."
    • removedOutput schema / properties / session
      Removed value: -{
      -  "description": "Only on the call that created the contact: pass it from then on.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / sessionExpiresAt
      Removed value: -{
      -  "description": "When that session stops working, ISO time.",
      -  "type": "string"
      -}
  11. First observed

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already cover the read-only, closed-world, non-destructive profile, and the description adds substantive behavior: unknown places return suggestions, ambiguous names return a list to choose from, and a missing month returns the next months with prices. It also warns that a figure is only a weekly price at exactly 7 nights and excludes extras — genuine interpretation guidance rather than restated annotation.

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 the when-to-use trigger, then the required inputs, then the answer shape, then routing to siblings — a sensible order. It is dense and slightly run-on, and restates the requiredness of nights/party that the schema already encodes, but almost every sentence carries information.

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?

Even though an output schema exists, the description supplies the interpretive layer an agent needs: what the percentile figures mean, currency units, the 7-night caveat, and the degraded-path behavior for unknown or ambiguous places. Nothing required to call or interpret it is missing.

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?

With 100% schema coverage the baseline is 3, but the description adds cross-tool provenance the schema lacks: place may be a placeId returned by search_yachts or list_places, not just an unknown_place listing. It also reinforces that nights and party are required and must be elicited from the person.

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 names a specific resource and output shape — the range of each yacht's lowest price for a stay of N nights in a place — and explicitly scopes itself to the case with 'no exact days or yacht yet', which cleanly separates it from search_yachts and request_quote.

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 states the triggering condition ('when the person asks what a stay costs and has no exact days or yacht yet'), names the alternatives and the conditions that select them ('For yachts free on their days, call search_yachts'; 'When the person picks a yacht, call request_quote'), and tells the agent to ask for missing required inputs.

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