# LockTrip

> Hotel booking platform with 2.5M+ properties worldwide. Search is free, no authentication required.

LockTrip is an online hotel booking platform offering competitive rates across more than 2.5 million hotel properties in 190+ countries. The platform provides a full booking journey through its MCP (Model Context Protocol) API, enabling AI agents to search, compare, and book hotels programmatically.

## API Access

LockTrip exposes a REST + JSON-RPC + SSE API for AI agents:

- Base URL: https://locktrip.com/mcp/
- Tool list: GET https://locktrip.com/mcp/tools
- OpenAPI spec: GET https://locktrip.com/mcp/openapi.json
- MCP discovery: GET https://locktrip.com/mcp/discovery

## Available Tools (14 total)

### Public Tools (No Authentication Required)

- **search_location**: Search cities, regions, or hotel names to get location IDs
- **hotel_search**: Initiate hotel search by location or coordinates. Returns a searchKey
- **get_search_results**: Get paginated search results. Poll until complete
- **get_hotel_rooms**: Get available room packages with prices for a hotel
- **check_cancellation_policy**: Get cancellation terms for room packages
- **get_hotel_details**: Get full hotel info (description, amenities, photos, reviews)
- **login**: Authenticate with email + password to get a Bearer token
- **guest_login**: Register/login with just an email to get a Bearer token

### Authenticated Tools (Bearer Token Required)

- **prepare_booking**: Create a booking with guest details
- **confirm_booking**: Confirm and pay for a booking
- **list_bookings**: List user's bookings by status
- **get_booking_details**: Get full booking details
- **cancel_booking**: Cancel a booking
- **get_payment_url**: Get Stripe checkout URL for payment

## Typical AI Agent Flow

1. `search_location("Paris")` → get regionId
2. `hotel_search(regionId, dates, rooms)` → get searchKey
3. `get_search_results(searchKey)` → browse hotels (poll until complete)
4. `get_hotel_details(hotelId)` → full hotel info
5. `get_hotel_rooms(hotelId, searchKey)` → room packages + prices
6. `check_cancellation_policy(searchKey, hotelId, packageIds)` → terms
7. `guest_login(email)` → Bearer token (steps 1-6 need no auth)
8. `prepare_booking(quoteId, rooms, contact)` → booking ready
9. `confirm_booking(bookingId, quoteId)` → confirmed

## Rate Limits

- Anonymous: 30 requests/minute (5/min for hotel_search)
- Authenticated: 120 requests/minute (20/min for hotel_search)

## Links

- Website: https://locktrip.com
- OpenAPI: https://locktrip.com/mcp/openapi.json
- MCP Discovery: https://locktrip.com/mcp/discovery