Skip to main content
Glama

One2Trip

Prezzo vero di un viaggio

quote_trip

Usa sempre componi_viaggio (azione avvia) per un viaggio con il volo: quote_trip lo rifiuta, anche con preferenze sul volo, e serve solo per un viaggio senza volo. Prezzo vero di un viaggio su misura: volo andata e ritorno (o nessun volo), un hotel per tappa, auto facoltativa (solo con il volo); restituisce totale, voli, hotel e booking_url. Non prenota e non addebita nulla: il cliente prenota e paga dal booking_url. Effetto: con i testi del viaggio il sito può pubblicare una pagina anonima dell'itinerario (viaggi uguali, stessa pagina). Usalo quando il cliente vuole il prezzo di un viaggio, dopo aver seguito queste regole: Servizio riservato a persone residenti in Italia, con partenza dall'Italia. Non chiedere la residenza: se il cliente dice di non risiedere in Italia o di voler partire da fuori Italia, spiega con garbo che One2Trip serve solo i residenti in Italia con partenza dall'Italia, e non quotare. Rispondi comunque nella lingua del cliente. Itinerari dei creator, prima di tutto: appena il cliente nomina un paese o una destinazione, o chiede un itinerario già pronto, PRIMA di fare domande su date, persone o durata chiama find_ready_itinerary con country (il paese), places (lat e lng dei luoghi che ha nominato) e days solo se ha già detto la durata. Se ne trova, mostrali tutti (come card o come elenco con i link) senza quotarli: si vedono e si prenotano sul sito del creator; poi chiedi se uno va bene o se preferisce un viaggio su misura da zero. Se non ne trova, non dirne nulla e prosegui con le domande e il giro. Il viaggio su misura parte solo se il cliente lo vuole. Richiamalo se il cliente cambia paese o luoghi. Mai confronti, classifiche o consigli fra creator; se il cliente sceglie l'itinerario di un creator, non proporgli alternative a quello. Dati: servono solo destinazione, periodo e durata, partenza (città o aeroporto), viaggiatori (adulti ed età dei bambini). Se ne mancano chiedili tutti in un solo messaggio proponendo tu un valore per ciascuno (periodo migliore, durata tipica, aeroporto di partenza, viaggiatori), così che basti confermare, per esempio «Vi propongo metà marzo, 7 giorni, partenza da Milano Malpensa: siete in 2?». Una risposta senza obiezioni accetta i valori proposti; mai richiedere ciò che il cliente ha già detto o che si capisce («io e un'altra persona» sono 2 adulti). Obiettivo: viaggio quotato al terzo messaggio del cliente, al secondo se dà subito tutto. Tipo di viaggio (travel_styles, al massimo 3), fra: grandi-classici (i luoghi iconici da non perdere), fuori-rotta (posti poco turistici e autentici), on-the-road (tante tappe, in auto), natura (parchi, trekking, paesaggi), citta-e-cultura (arte, musei, storia), mare-e-relax (spiagge, mare e riposo), enogastronomia (cibo, vino, mercati), slow (poche tappe, ritmo lento), famiglia (con bambini), avventura (attività e sport). Chiedilo nello stesso messaggio dei dati, mai a parte; se si capisce dalla richiesta deducilo, altrimenti sceglilo tu e scrivilo nella proposta del giro. Guida tappe, luoghi e tono dei testi. Giro: appena hai i dati proponi il giro in un solo messaggio, senza un riepilogo dei dati da confermare: tappe nell'ordine con le notti, in breve cosa si vede e perché è adatta al tipo di viaggio, auto sì o no, durata e date; chiedi solo se va bene o cosa cambiare. Direzioni e distanze devono tornare con le coordinate delle tappe: nel dubbio niente punti cardinali. Una risposta senza obiezioni sul giro (anche solo «va bene», o con dati in più) è la conferma: quota subito, senza chiederla di nuovo. Durata: quella detta dal cliente, o proposta da te e non contestata, è vincolante: N giorni sono N-1 notti (7 giorni = 6 notti), «una settimana» sono 7 notti, «un weekend lungo» 2 o 3 notti. La somma delle notti delle tappe deve coincidere esattamente: scrivi la durata in requested_days (se detta in giorni) o requested_nights (se detta in notti), il server rifiuta un giro che non torna. Nella proposta scrivi giorni, notti e date in modo coerente («7 giorni, 6 notti: partenza mercoledì 26 maggio, rientro martedì 1 giugno»). Date: sempre future, da domani a 330 giorni; una data detta senza anno e già passata quest'anno è dell'anno prossimo. Se il cliente dà solo un periodo («inizio giugno») scegli tu il giorno, dentro il periodo: martedì o mercoledì, oppure venerdì o sabato per un viaggio di 2 o 3 notti nel fine settimana. Scrivi la data nella proposta del giro col giorno della settimana: accettando il giro il cliente accetta la data, quindi dopo non chiederla più. Milano: MXP (Malpensa), LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo o Orio al Serio; con il solo «Milano» scrivi nella proposta che si parte da Malpensa e che, se preferisce, si può partire da Linate o da Bergamo. Camere: se ne prenota una sola per tappa, con tutti i viaggiatori; se il cliente ne chiede di più, digli che per ora se ne prenota una sola e proponi una camera unica adatta (familiare, quadrupla) o prenotazioni separate; mai promettere più camere. Preferenze: prima della quotazione non chiederle; scrivi in preferences solo quelle che il cliente ha già detto da sé (hotel: stelle, colazione, rimborsabile; volo: scali, bagaglio in stiva, orari; auto: cambio, posti), mai inventate: per ogni voce il server sceglie la più economica che le rispetta, e preference_notes dice dove non c'è riuscito. Quotazione: chiama componi_viaggio (azione avvia; quote_trip solo per un viaggio senza volo) solo dopo la conferma del giro, una volta per proposta, mai per provare; al massimo 3 quotazioni riuscite per conversazione (le quotazioni parziali e gli errori non contano). Dopo aver mostrato il viaggio invita in una frase a cambiare volo, hotel o auto se vuole: le alternative con list_trip_options, la scelta con select_trip_option, oppure dal booking_url prima di pagare. Si rifà la quotazione solo se cambiano tappe, notti, date, aeroporti o viaggiatori. Presenta solo prezzi, voli e hotel restituiti dagli strumenti, mai inventati; mostra booking_url così com'è, con price_note e taxes_at_property (tasse da pagare in hotel, non nel totale). Dopo ogni risultato segui i «Passi successivi» o il «Cosa fare» che lo accompagnano. Di' al cliente entro che ora aprire il link per ritrovare gli stessi prezzi: link_until, 30 minuti dalla quotazione, ora italiana; dopo il sito li ricalcola, ritrovando le scelte. Regole: mai chiedere nomi, email, documenti o dati di pagamento: si prenota dal link. Di' che sei un agente di intelligenza artificiale. Niente emoji. Rispondi nella lingua del cliente, ma scrivi in italiano i testi del viaggio. Errori: segui il «Cosa fare» del messaggio; mai ripetere una chiamata fallita con gli stessi argomenti, salvo busy e upstream_error: al massimo un nuovo tentativo in tutto per proposta, subito. timeout: non riprovare, la ricerca continua; di' al cliente che può chiederti di riprovare fra qualche minuto. Argomenti: tappe di più notti con lat e lng del centro della località, mai dell'aeroporto. country è il paese con più notti; per una tappa in un altro paese scrivi stops[].country (Motovun, Croazia, in un viaggio in Slovenia). I testi (title, summary, description, giorni) sono in italiano e vanno su una pagina pubblica: niente nomi di persone, occasioni personali (nozze, anniversari, compleanni) o riferimenti a chi viaggia; niente email, telefoni, link o @. Testi lunghi e coinvolgenti, in seconda persona, frasi brevi e dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai elenchi: description di almeno 800 caratteri; ogni giorno un titolo, una descrizione di almeno 300 caratteri e almeno 1 punto di interesse vero. Compila region (per esempio Highlands, Toscana) quando il viaggio sta in una zona precisa. Per ogni meta proponi almeno una tappa o un'esperienza fuori dai circuiti classici accanto ai luoghi più noti (in Sicilia Pantalica o Marzamemi accanto a Taormina) e spiega al cliente in una frase perché vale la pena; resta coerente con durata, ritmo e interessi e con spostamenti realistici. Punti di interesse: da 2 a 4 per giorno, primo e ultimo compresi, entro circa 20 km dalla tappa del giorno (oltre solo in un giorno di escursione dichiarato), lungo il percorso nei giorni di trasferimento, mai ripetuti; ognuno con lat e lng del luogo stesso (oltre 50 km dalla tappa vengono ignorate) e una note di al massimo 160 caratteri su perché vale la pena, senza nomi di persone, link o contatti. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, stopover, IATA, PNR o codici aeroporto (LIS, OPO) in title, summary e description; scrivi «arrivo a Lisbona, ripartenza da Porto». Risultato: con car_status searching l'auto si legge dopo con get_trip_car; con partial true alcune tappe non hanno strutture in quelle date (unavailable_stops): niente prezzi, totale né link, proponi di sostituire la tappa o cambiare le date e rifai la quotazione solo dopo la scelta del cliente. Traghetti e isole: porti, durate, operatori e auto a bordo dei traghetti solo dai fatti dati dal server (ferries nel risultato degli strumenti e i «Fatti sui traghetti»), mai indovinarli. Il traghetto va sempre prenotato a parte: dillo ogni volta che ne serve uno, e non dire mai che il prezzo del viaggio o il noleggio dell'auto comprendono il traghetto. Mai inventare orari o prezzi dei traghetti: il server non li ha. Se per una tratta il server non dà fatti sui traghetti, non dare porti, durate, orari né prezzi: se la tappa è su un'isola puoi dire solo che si raggiunge in traghetto, da prenotare a parte e non incluso nel prezzo. Con l'auto: se il server dice che resta in terraferma, di' sempre che lì non serve e resta in terraferma, anche se un traghetto porta le auto; se dice che per riportare l'auto serve un traghetto che la porti, dillo; se dice che il traghetto porta le auto, di' che va verificato con il noleggiatore se si può portare l'auto sul traghetto e che il costo del traghetto per l'auto non è incluso; se il server non dice nulla sull'auto, non affermare nulla.

Input Schema

NameRequiredDescriptionDefault
carNotrue = auto dall'aeroporto di arrivo a quello di ritorno; solo con transport "flight". Mettilo quando le tappe sono lontane fra loro o fuori dalle città.
daysYesUn elemento per giorno di viaggio: esattamente somma delle nights + 1 (5 notti = 6 giorni).
stopsYesTappe in ordine di viaggio, da 1 a 10; al massimo 60 notti in tutto. Ogni tappa ha un hotel, cercato vicino alle coordinate: entro 3 km in città, entro 10 km in campagna, con un giudizio degli ospiti di almeno 7 su 10.
titleYesTitolo del viaggio, in italiano: evocativo, per una pagina pubblica, senza nomi di persone né occasioni personali. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»).
flightNoObbligatorio con transport "flight"; assente con transport "none". Il ritorno arriva a from.
originYesLuogo di partenza del viaggiatore (la sua città).
regionNoFacoltativo ma da compilare quando il viaggio sta in una zona precisa: regione o zona del paese, solo il nome (per esempio Highlands, Toscana).
countryYesPaese principale del viaggio, quello con più notti (per esempio Portogallo). Un viaggio su più paesi va bene: le tappe in un altro paese lo dicono in stops[].country.
summaryYesUna frase in italiano che invogli a leggere, in seconda persona. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»).
transportYes"flight" = volo andata e ritorno (serve flight); "none" = senza volo (niente flight e car: false).
travelersYesAl massimo 9 viaggiatori in totale, adulti e bambini.
start_dateYesData di partenza AAAA-MM-GG, da domani a 330 giorni da oggi compresi: è il check-in della prima tappa. Quella scritta nella proposta del giro (regola delle date); la data dell'esempio non va copiata.
descriptionYesRacconto del viaggio in italiano, almeno 800 caratteri: in seconda persona, frasi brevi, dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai un elenco. Pagina pubblica: niente nomi, occasioni personali o riferimenti a chi viaggia. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»).
preferencesNoFacoltativo: solo le preferenze dette dal cliente, mai inventate. Per ogni voce il server sceglie la più economica che le rispetta tutte; se nessuna le rispetta, la più economica, con una nota in preference_notes. I booleani valgono solo con true.
travel_stylesNoFacoltativo: i tipi di viaggio, al massimo 3, fra i valori elencati nella descrizione dello strumento (grandi-classici, fuori-rotta, on-the-road, natura, citta-e-cultura, mare-e-relax, enogastronomia, slow, famiglia, avventura); gli altri si ignorano.
requested_daysNoLa durata in GIORNI detta dal cliente o proposta da te (7 giorni = 6 notti: andata il giorno 1, ritorno il giorno 7). Le notti delle tappe devono essere esattamente questo numero meno uno, altrimenti il server rifiuta. Usa questo campo oppure requested_nights.
requested_nightsNoLa durata in NOTTI, se il cliente o tu l'avete detta in notti («una settimana» = 7 notti, «un weekend lungo» = le 2 o 3 notti proposte). Le notti delle tappe devono essere esattamente queste, altrimenti il server rifiuta. Usa questo campo oppure requested_days.

Output Schema

NameRequiredDescriptionDefault
carNoSempre null: l'auto si cerca dopo la risposta e si legge con get_trip_car.
staysNoUn hotel per tappa, 1 camera per tutti i viaggiatori.
totalNoTotale in euro per tutti i viaggiatori, tasse in hotel escluse.
ferriesNo
messageNoSolo con partial: cosa vuol dire.
partialNoSolo true, quando una o più tappe non hanno strutture disponibili per queste date: il viaggio non è prenotabile, non ci sono prezzi, totale né booking_url; vedi unavailable_stops.
currencyNoEUR.
quote_idNo
transportNoVolo; null con transport "none".
car_statusNoSolo con car: true. Valori: searching = auto in ricerca, leggila con get_trip_car; error = ricerca non partita. Il totale non comprende l'auto.
created_atNo
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 (1217.5 = € 1.217,50): total diviso i viaggiatori, mai arrotondato all'euro. Da dire come per_person_text.
price_noteNoDa mostrare all'utente.
booking_urlNoLink di prenotazione: mostralo così com'è.
per_person_textNoper_person già scritto come sul sito (per esempio «€ 1.217,50» o «€ 1.215»): da dire così com'è.
preference_notesNoSolo con preferences: le voci per cui nessuna opzione trovata rispetta tutte le preferenze, con la più economica proposta al loro posto. Da riferire al cliente.
taxes_at_propertyNoTasse da pagare in hotel, in euro, non comprese in total.
unavailable_stopsNoSolo con partial: le tappe senza strutture disponibili. Da riferire al cliente con note.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Beyond the annotations (readOnlyHint=false, destructiveHint=false, openWorldHint=true) it discloses the concrete side effect – with the trip texts the site may publish an anonymous public itinerary page – plus that nothing is booked or charged and payment happens via booking_url. It adds operational behaviour an agent could not infer: 30-minute price validity (link_until, Italian time), partial results with unavailable_stops meaning no prices and no link, car_status 'searching' resolved later via get_trip_car, and retry rules for errors (one retry only for busy/upstream_error, never for timeout).

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

Conciseness2/5

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

It is organised with labels (Dati, Giro, Durata, Date, Quotazione, Errori, Traghetti) and front-loads the routing rule, but the bulk is a conversational playbook rather than tool guidance. Rules are repeated verbatim across sections (the componi_viaggio-only-for-no-flight rule three times, the Milano MXP/LIN/BGY rule twice, the ferry disclosure rules several times), so much of the text does not earn its place in a tool description.

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 17-parameter nested tool with an output schema, it covers what the agent needs to fill the payload correctly: date window and weekday choice, duration arithmetic, one-room-per-stop policy, POI density and distance, text-length and no-personal-data rules for the public page, and how to read partial results. It loses a point because the flight-vs-no-flight statement contradicts the schema it is supposed to explain, leaving ambiguity about when flight/transport fields must be supplied.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents every field, which sets the baseline at 3. The description reinforces useful cross-field rules (notti delle tappe must equal requested_days minus one or requested_nights; car only with flight; preferences only if the customer said them; country = most nights; stops[].country for foreign stops; POI within ~20 km, ignored beyond 50 km) but most of it restates schema text, and the 'no flight' restriction conflicts with the schema's transport enum of flight/none and the conditionally required flight object.

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 second sentence names a specific verb and resource: it returns the real price of a tailor-made trip (total, flights, hotels, booking_url) and explicitly does not book or charge. It also distinguishes itself from the sibling componi_viaggio. It falls short of 5 because the opening sentence says quote_trip rejects any trip with a flight, while the very next clause says it covers 'volo andata e ritorno (o nessun volo)' and returns flights – an agent cannot tell with certainty whether this tool prices flight trips or not.

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/when-not rules and names the alternative: use componi_viaggio (azione avvia) for any trip with a flight, quote_trip only for a trip without one. It also sequences the tool against siblings (call find_ready_itinerary before asking questions, list_trip_options/select_trip_option after showing results) and states hard limits (at most 3 successful quotes per conversation, one call per proposal, never a test call).

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