Crea agenti IA che prenotano hotel
Collega il tuo agente IA a 2,5 milioni di hotel e appartamenti in tutto il mondo tramite il Model Context Protocol (MCP). La ricerca e gratuita e non richiede chiave API. Prenota con una semplice chiamata REST.
2.5M+
Hotel e appartamenti
190+
Paesi
15
Strumenti API
Gratuito
API di ricerca
Come funziona
Tre passaggi dalla ricerca alla prenotazione confermata. Il tuo agente IA gestisce l'intero flusso in modo programmatico.
Cerca hotel
Usa search_location per trovare una destinazione, poi hotel_search per verificare la disponibilita. Nessuna autenticazione necessaria. Filtra per prezzo, classificazione a stelle, servizi e tipo di pasto. Ottieni dettagli dell'hotel, foto e recensioni.
Autenticati
Chiama guest_login con un indirizzo e-mail per ottenere un Bearer token. Nessuna password richiesta per gli account ospite. Usa il token per tutte le operazioni di prenotazione. I token sono JWT standard validi per le chiamate API autenticate.
Prenota e paga
Chiama prepare_booking con i dati dell'ospite, poi completa il pagamento tramite create_checkout (Revolut) o confirm_booking (linea di credito B2B). L'ospite riceve automaticamente un'e-mail di conferma.
Strumenti disponibili
15 strumenti che coprono l'intero ciclo di prenotazione alberghiera. Gli strumenti pubblici non richiedono autenticazione. Gli strumenti autenticati necessitano di un Bearer token da login o guest_login.
Strumenti pubblici (nessuna autenticazione richiesta)
search_location
Cerca citta, regioni e hotel per nome. Restituisce ID di localizzazione e coordinate per la ricerca hotel.
hotel_search
Avvia una ricerca di disponibilita alberghiera per ID regione o coordinate GPS. Specifica date, camere, nazionalita degli ospiti e valuta.
get_search_results
Recupera risultati di ricerca paginati con filtri per fascia di prezzo, stelle, servizi e tipo di pasto. Ordinamento per prezzo o valutazione.
get_hotel_rooms
Ottieni i pacchetti camera disponibili per un hotel specifico. Restituisce prezzi, piani pasto e ID preventivo necessari per la prenotazione.
check_cancellation_policy
Visualizza scadenze di cancellazione e penali per i pacchetti camera prima della prenotazione.
get_hotel_details
Ottieni informazioni complete sull'hotel: descrizione, servizi, recensioni, foto, coordinate e attrazioni nelle vicinanze.
login
Autenticati con e-mail e password. Restituisce un Bearer token da utilizzare con gli strumenti autenticati.
guest_login
Registrati o accedi con un semplice indirizzo e-mail. Nessuna password richiesta. Restituisce un Bearer token per la prenotazione.
Strumenti autenticati (Bearer token)
prepare_booking
Crea una prenotazione con i dati dell'ospite e le informazioni di contatto. Restituisce un ID prenotazione per il pagamento. Le prenotazioni scadono dopo circa 15 minuti.
confirm_booking
Conferma e paga tramite la linea di credito B2B. Conferma istantanea con numero di riferimento della prenotazione. Solo per partner B2B.
create_checkout
Genera un URL di pagamento Revolut. Reindirizza l'utente finale alla pagina di pagamento con carta. La prenotazione viene confermata automaticamente tramite webhook.
get_payment_url
Genera un URL di pagamento Stripe. Alternativa a Revolut per i mercati dove Stripe e preferito.
list_bookings
Elenca le prenotazioni filtrate per stato: in arrivo, completate, cancellate o in attesa. Risultati paginati con informazioni su hotel e date.
get_booking_details
Recupera i dettagli completi della prenotazione, incluse informazioni hotel, nomi degli ospiti, stato del pagamento e politica di cancellazione.
cancel_booking
Cancella una prenotazione. Restituisce l'importo del rimborso e le eventuali penali di cancellazione. Richiede un flag di conferma esplicito.
Opzioni di integrazione
Scegli il protocollo adatto alla tua infrastruttura. Tutti gli endpoint restituiscono gli stessi dati. I client MCP possono scoprire automaticamente gli strumenti tramite l'endpoint di discovery.
REST API
Chiama gli strumenti direttamente tramite HTTP POST. Ogni strumento ha il proprio percorso URL. Invia dati JSON nel corpo della richiesta e ricevi una risposta JSON. Gli strumenti pubblici non necessitano di header. Gli strumenti autenticati richiedono un header Authorization con un Bearer token.
# Search hotels in Paris (no auth)
curl -X POST \
https://locktrip.com/mcp/tools/search_location \
-H "Content-Type: application/json" \
-d '{"query": "Paris"}'
# Book with auth token
curl -X POST \
https://locktrip.com/mcp/tools/prepare_booking \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{ ... }'Protocollo MCP
Usa il Model Context Protocol per l'integrazione nativa di agenti IA. Gli strumenti vengono scoperti automaticamente tramite SSE o JSON-RPC. Compatibile con Claude Desktop, Cursor e qualsiasi client compatibile MCP. L'endpoint di discovery fornisce le capacita del server e i metadati degli strumenti.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Endpoint di discovery
Endpoint leggibili dalla macchina per la scoperta automatica degli strumenti. Usali per integrare LockTrip in framework di agenti IA, gateway API o registri di strumenti LLM.
Opzioni di pagamento
Molteplici modalita di pagamento per diversi casi d'uso. Gli agenti B2C generano link di pagamento per gli utenti finali. I partner B2B pagano istantaneamente tramite linea di credito.
Revolut Checkout
Genera una pagina di pagamento ospitata tramite lo strumento create_checkout. L'utente finale clicca il link e paga con carta. La prenotazione viene confermata automaticamente tramite webhook. Ideale per agenti IA rivolti ai consumatori.
Stripe Checkout
Pagamento con carta alternativo tramite lo strumento get_payment_url. Restituisce un URL di checkout ospitato da Stripe. Utile per mercati o valute dove Stripe e preferito rispetto a Revolut.
Linea di credito B2B
Per partner commerciali con linea di credito prefinanziata. Chiama confirm_booking per pagare istantaneamente dal tuo saldo. Nessun reindirizzamento necessario. Ideale per agenzie di viaggio e OTA che costruiscono pipeline di prenotazione automatizzate.
Limiti di frequenza
Limiti generosi per utilizzo anonimo e autenticato. Gli utenti autenticati ottengono quote piu elevate su tutti gli endpoint.
| Livello | Strumenti di ricerca | Strumenti di prenotazione |
|---|---|---|
| Anonimo | 30 rich./min | Non disponibile (autenticazione richiesta) |
| Autenticato | 60 rich./min | 20 rich./min |
Pronto a sviluppare?
Cerca hotel subito senza chiave API. Consulta la specifica OpenAPI o collega il tuo client MCP per scoprire automaticamente tutti i 15 strumenti. Per partnership B2B e accesso alla linea di credito, contatta il nostro team commerciale.