Build AI Agents That Book Hotels
Connect your AI agent to 2.5 million hotels and apartments worldwide using the Model Context Protocol (MCP). Search is free and requires no API key. Book with a simple REST call.
2.5M+
Hotels & Apartments
190+
Countries
15
API Tools
Free
Search API
How It Works
Three steps from search to confirmed booking. Your AI agent handles the entire flow programmatically.
Search Hotels
Use search_location to find a destination, then hotel_search to get availability. No authentication needed. Filter by price, star rating, amenities, and meal type. Get hotel details, photos, and reviews.
Authenticate
Call guest_login with an email address to get a Bearer token. No password required for guest accounts. Use the token for all booking operations. Tokens are standard JWTs valid for authenticated API calls.
Book & Pay
Call prepare_booking with guest details, then complete payment via create_checkout (Revolut) or confirm_booking (B2B credit line). The guest receives a confirmation email automatically.
Available Tools
15 tools covering the complete hotel booking lifecycle. Public tools require no authentication. Authenticated tools need a Bearer token from login or guest_login.
Public Tools (No Auth Required)
search_location
Search for cities, regions, and hotels by name. Returns location IDs and coordinates for use in hotel search.
hotel_search
Start a hotel availability search by region ID or GPS coordinates. Specify dates, rooms, guest nationality, and currency.
get_search_results
Retrieve paginated search results with filters for price range, star rating, amenities, and meal type. Sort by price or rating.
get_hotel_rooms
Get available room packages for a specific hotel. Returns pricing, meal plans, and quote IDs needed for booking.
check_cancellation_policy
View cancellation deadlines and penalty fees for room packages before booking.
get_hotel_details
Get full hotel information: description, amenities, reviews, photos, coordinates, and nearby attractions.
login
Authenticate with email and password. Returns a Bearer token for use with authenticated tools.
guest_login
Register or log in with just an email address. No password required. Returns a Bearer token for booking.
Authenticated Tools (Bearer Token)
prepare_booking
Create a booking with guest details and contact information. Returns a booking ID for payment. Bookings expire after ~15 minutes.
confirm_booking
Confirm and pay using B2B credit line. Instant confirmation with booking reference number. For B2B partners only.
create_checkout
Generate a Revolut payment checkout URL. Redirect the end user to pay by card. Booking is confirmed automatically via webhook.
get_payment_url
Generate a Stripe checkout URL for card payment. Alternative to Revolut for markets where Stripe is preferred.
list_bookings
List bookings filtered by status: upcoming, completed, cancelled, or pending. Paginated results with hotel and date info.
get_booking_details
Retrieve full booking details including hotel info, guest names, payment status, and cancellation policy.
cancel_booking
Cancel a booking. Returns the refund amount and any cancellation fees. Requires explicit confirmation flag.
Integration Options
Choose the protocol that fits your stack. All endpoints return the same data. MCP clients can auto-discover tools via the discovery endpoint.
REST API
Call tools directly via HTTP POST. Each tool has its own URL path. Send JSON input in the request body and receive JSON output. Public tools need no headers. Authenticated tools require an Authorization header with a 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 '{ ... }'MCP Protocol
Use the Model Context Protocol for native AI agent integration. Tools are auto-discovered via SSE or JSON-RPC. Compatible with Claude Desktop, Cursor, and any MCP-compatible client. The discovery endpoint provides server capabilities and tool metadata.
{
"mcpServers": {
"locktrip": {
"url": "https://locktrip.com/mcp/sse"
}
}
}Discovery Endpoints
Machine-readable endpoints for automated tool discovery. Use these to integrate LockTrip into AI agent frameworks, API gateways, or LLM tool registries.
Payment Options
Multiple payment paths for different use cases. B2C agents generate checkout links for end users. B2B partners pay instantly via credit line.
Revolut Checkout
Generate a hosted payment page via the create_checkout tool. The end user clicks the link and pays by card. The booking is confirmed automatically via webhook. Best for consumer-facing AI agents.
Stripe Checkout
Alternative card payment via the get_payment_url tool. Returns a Stripe-hosted checkout URL. Useful for markets or currencies where Stripe is preferred over Revolut.
B2B Credit Line
For business partners with a pre-funded credit line. Call confirm_booking to pay instantly from your balance. No redirect needed. Ideal for travel agencies and OTAs building automated booking pipelines.
Rate Limits
Generous limits for both anonymous and authenticated usage. Authenticated users get higher quotas across all endpoints.
| Tier | Search Tools | Booking Tools |
|---|---|---|
| Anonymous | 30 req/min | N/A (auth required) |
| Authenticated | 60 req/min | 20 req/min |
Ready to Build?
Start searching hotels right now with no API key. Read the OpenAPI spec or connect your MCP client to auto-discover all 15 tools. For B2B partnerships and credit line access, contact our business team.