Skip to main content
Glama

One2Trip

Alternative del viaggio

list_trip_options
Read-only

Alternative già trovate da una quotazione di quote_trip: voli (type flight), hotel di una tappa (type hotel con stop_index, da 0 come stays[].stop_index) o auto (type car, solo dopo che get_trip_car l'ha trovata). Solo lettura: nessuna ricerca nuova, non consuma quotazioni. Tutte le alternative del tipo, a pagine di 40 righe (page da 1; total_options e pages dicono quante sono); la prima riga della pagina 1 è la scelta attuale (current), poi le altre dal prezzo più basso; i filtri valgono prima delle pagine. Hotel solo con una camera per tutti i viaggiatori. Voli: una riga per combinazione di voli con la tariffa meno cara; in other_fares le altre tariffe degli stessi voli (bagaglio, modifica, rimborso), ognuna con il suo option_id. delta_total è la differenza sul totale; per i voli delta_flight è quella del solo volo: con l'auto trovata, un volo con keeps_car false ha orari diversi e toglie l'auto dal totale (si ricalcola sul sito). Chiamalo quando il cliente chiede altri voli, hotel o auto per un viaggio già quotato, invece di rifare la quotazione, e senza aspettare dopo preference_notes o preference_note (con i filtri delle preferenze) o per controllare posti e bagagliaio dell'auto trovata. Proponi solo le righe più adatte a ciò che chiede, con prezzo e differenza sul totale, mai alternative inventate e senza codici (option_id resta per te). Restringi prima con i filtri: ogni pagina è una consultazione, al massimo 20 per quotazione. Per scegliere una riga: select_trip_option con il suo option_id.

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": {
      "quote_id": "<quote_id>",
      "type": "<type>"
    },
    "name": "list_trip_options"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNoPagina da 1 (predefinita), 40 righe per pagina (o limit): chiedi le successive solo se servono, dopo aver ristretto con i filtri.
typeYesflight = voli; hotel = hotel di una tappa (con stop_index); car = auto (solo con l'auto trovata).
limitNoFacoltativo: righe per pagina, da 1 a 40 (predefinito 40). Più basso = risposta più corta.
filtersNoFacoltativi, pochi e solo quelli del tipo; i booleani filtrano solo con true. La scelta attuale resta sempre la prima riga.
quote_idYesquote_id restituito da quote_trip.
stop_indexNoSolo con type hotel: la tappa, da 0 come stays[].stop_index.

Output Schema

NameRequiredDescriptionDefault
pageYesPagina restituita, da 1.
typeYesflight, hotel o car.
pagesYesPagine in tutto.
totalNoTotale attuale della quotazione in euro (con l'auto se trovata).
optionsYesLe righe di questa pagina: nella pagina 1 prima la scelta attuale (current), poi le altre dal prezzo più basso; voli: una riga per combinazione di voli, le altre tariffe in other_fares.
pick_upNo
airportsNo
car_noteNoVoli con l'auto trovata: come leggere keeps_car, delta_flight e delta_total.
currencyYes
drop_offNo
page_sizeNoRighe per pagina (limit, o il predefinito).
link_untilNoOrario entro cui aprire booking_url per ritrovare gli stessi prezzi: 30 minuti dalla quotazione, ora italiana (RFC 3339).
per_personNoTotale a persona in euro, al centesimo, come sul sito (1224.5 = € 1.224,50).
reads_leftNoConsultazioni ancora possibili per questa quotazione.
stop_indexNoSolo hotel: la tappa, da 0.
booking_urlYesLink della quotazione: lì il cliente sceglie davvero un'alternativa. Mostralo così com'è.
total_optionsYesRighe in tutte le pagine, con questi filtri.
per_person_textNoIl totale a persona già scritto come sul sito (per esempio «€ 1.224,50»): da dire così com'è.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Beyond the read-only annotations, the description explains that this performs no new search and does not consume quotations, and it details pagination, sorting, the current choice on page 1, the 20-consultation limit, fare grouping in other_fares, and car-related total recalculation. These are exactly the behavioral traits an agent needs to use the tool safely and correctly.

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 description is dense but front-loaded and every major sentence adds operational value. It would benefit from clearer sentence breaks, and the phrase preference_notes or preference_note is awkward, but it is not padded with filler.

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?

Given the complexity, the output schema, annotations, and detailed input schema, the description is complete enough: it covers invocation context, read-only behavior, pagination, ordering, fare structure, car interaction, selection handoff, and constraints on what to propose. Nothing essential for correct invocation 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?

Schema description coverage is 100%, and the schema already documents the six parameters, including nested filters and stop_index. The description still adds useful parameter-usage meaning by stating that filters apply before pagination and that pages contain 40 rows, which guides how to combine filters and page.

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 states a specific verb and resource: list alternatives already found by a quote_trip quotation, restricted to flight, hotel, or car. It clearly distinguishes this from quote_trip and from select_trip_option, so an agent can tell what the tool does without opening the 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?

It gives explicit when-to-use guidance: call when the customer asks for other flights, hotels, or cars for an already quoted trip instead of re-quoting, and do not wait after preference notes. It also states when not to use it and points to select_trip_option for choosing a row.

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