Crie AI Agents que Reservam Hotéis
Conecte seu AI agent a 2,5 milhões de hotéis e apartamentos em todo o mundo usando o Model Context Protocol (MCP). A busca é gratuita e não requer API key. Reserve com uma simples chamada REST.
2.5M+
Hotéis e Apartamentos
190+
Países
15
Ferramentas de API
Gratuito
API de Busca
Como Funciona
Três passos da busca à reserva confirmada. Seu AI agent gerencia todo o fluxo de forma programática.
Buscar Hotéis
Use search_location para encontrar um destino e hotel_search para verificar disponibilidade. Sem necessidade de autenticação. Filtre por preço, classificação por estrelas, comodidades e tipo de refeição. Obtenha detalhes do hotel, fotos e avaliações.
Autenticar
Chame guest_login com um endereço de e-mail para obter um token Bearer. Não é necessário senha para contas de convidado. Use o token para todas as operações de reserva. Os tokens são JWTs padrão válidos para chamadas autenticadas à API.
Reservar e Pagar
Chame prepare_booking com os dados do hóspede e finalize o pagamento via create_checkout (Revolut) ou confirm_booking (linha de crédito B2B). O hóspede recebe um e-mail de confirmação automaticamente.
Ferramentas Disponíveis
15 ferramentas que cobrem todo o ciclo de reserva de hotéis. Ferramentas públicas não requerem autenticação. Ferramentas autenticadas precisam de um token Bearer obtido via login ou guest_login.
Ferramentas Públicas (Sem Autenticação)
search_location
Busque cidades, regiões e hotéis por nome. Retorna IDs de localização e coordenadas para uso na busca de hotéis.
hotel_search
Inicie uma busca de disponibilidade de hotéis por ID de região ou coordenadas GPS. Especifique datas, quartos, nacionalidade do hóspede e moeda.
get_search_results
Obtenha resultados de busca paginados com filtros para faixa de preço, classificação por estrelas, comodidades e tipo de refeição. Ordene por preço ou avaliação.
get_hotel_rooms
Obtenha pacotes de quartos disponíveis para um hotel específico. Retorna preços, planos de refeição e IDs de cotação necessários para reserva.
check_cancellation_policy
Consulte prazos de cancelamento e taxas de penalidade para pacotes de quartos antes de reservar.
get_hotel_details
Obtenha informações completas do hotel: descrição, comodidades, avaliações, fotos, coordenadas e atrações próximas.
login
Autentique com e-mail e senha. Retorna um token Bearer para uso com ferramentas autenticadas.
guest_login
Registre-se ou faça login apenas com um endereço de e-mail. Sem necessidade de senha. Retorna um token Bearer para reservas.
Ferramentas Autenticadas (Token Bearer)
prepare_booking
Crie uma reserva com dados do hóspede e informações de contato. Retorna um ID de reserva para pagamento. As reservas expiram em aproximadamente 15 minutos.
confirm_booking
Confirme e pague usando linha de crédito B2B. Confirmação instantânea com número de referência da reserva. Apenas para parceiros B2B.
create_checkout
Gere um URL de pagamento Revolut. Redirecione o usuário final para pagar com cartão. A reserva é confirmada automaticamente via webhook.
get_payment_url
Gere um URL de checkout Stripe para pagamento com cartão. Alternativa ao Revolut para mercados onde o Stripe é preferido.
list_bookings
Liste reservas filtradas por status: próximas, concluídas, canceladas ou pendentes. Resultados paginados com informações de hotel e datas.
get_booking_details
Obtenha detalhes completos da reserva, incluindo informações do hotel, nomes dos hóspedes, status do pagamento e política de cancelamento.
cancel_booking
Cancele uma reserva. Retorna o valor do reembolso e eventuais taxas de cancelamento. Requer flag de confirmação explícita.
Opções de Integração
Escolha o protocolo que se adapta à sua stack. Todos os endpoints retornam os mesmos dados. Clientes MCP podem descobrir ferramentas automaticamente via endpoint de descoberta.
REST API
Chame ferramentas diretamente via HTTP POST. Cada ferramenta tem seu próprio caminho URL. Envie entrada JSON no corpo da requisição e receba saída JSON. Ferramentas públicas não precisam de headers. Ferramentas autenticadas requerem um header Authorization com token Bearer.
# 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 '{ ... }'Protocolo MCP
Use o Model Context Protocol para integração nativa com AI agents. As ferramentas são descobertas automaticamente via SSE ou JSON-RPC. Compatível com Claude Desktop, Cursor e qualquer cliente compatível com MCP. O endpoint de descoberta fornece capacidades do servidor e metadados das ferramentas.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Endpoints de Descoberta
Endpoints legíveis por máquina para descoberta automática de ferramentas. Use-os para integrar o LockTrip em frameworks de AI agents, API gateways ou registros de ferramentas LLM.
Opções de Pagamento
Múltiplos caminhos de pagamento para diferentes casos de uso. Agents B2C geram links de checkout para usuários finais. Parceiros B2B pagam instantaneamente via linha de crédito.
Checkout Revolut
Gere uma página de pagamento hospedada via a ferramenta create_checkout. O usuário final clica no link e paga com cartão. A reserva é confirmada automaticamente via webhook. Ideal para AI agents voltados ao consumidor.
Checkout Stripe
Pagamento alternativo com cartão via a ferramenta get_payment_url. Retorna um URL de checkout hospedado pelo Stripe. Útil para mercados ou moedas onde o Stripe é preferido ao Revolut.
Linha de Crédito B2B
Para parceiros de negócios com linha de crédito pré-financiada. Chame confirm_booking para pagar instantaneamente do seu saldo. Sem necessidade de redirecionamento. Ideal para agências de viagens e OTAs que constroem pipelines de reserva automatizados.
Limites de Taxa
Limites generosos tanto para uso anônimo quanto autenticado. Usuários autenticados obtêm cotas maiores em todos os endpoints.
| Nível | Ferramentas de Busca | Ferramentas de Reserva |
|---|---|---|
| Anônimo | 30 req/min | N/D (autenticação obrigatória) |
| Autenticado | 60 req/min | 20 req/min |
Pronto para Começar?
Comece a buscar hotéis agora mesmo sem API key. Leia a especificação OpenAPI ou conecte seu cliente MCP para descobrir automaticamente todas as 15 ferramentas. Para parcerias B2B e acesso à linha de crédito, entre em contato com nossa equipe comercial.