# Qontaktly

> Qontaktly is a direct hotel booking platform. Hotels, hostels, B&Bs, and vacation rentals list their rooms here and take commission free direct bookings. AI agents can search live availability and book rooms on behalf of guests.

## Book via MCP

Qontaktly exposes a booking MCP server (Streamable HTTP transport):

- Endpoint: POST https://www.qontaktly.com/api/mcp
- Metadata: https://www.qontaktly.com/.well-known/mcp.json
- Overview (for humans and agents alike): https://www.qontaktly.com/mcp

Tools:

- search_properties: find bookable properties by name, city, or country.
- get_availability: room types, stay totals, and rate plans for a property and date range.
- create_held_booking: create a reservation held for about 1 hour pending the deposit.
- get_payment_link: get the secure link the guest uses to pay the deposit.
- get_booking_status: check a reservation's current status by reservation id.
- get_room_photos: room photos returned as inline images the conversation can display.

Hold semantics: creating a booking holds the room for about 1 hour. Paying the deposit within that window confirms the reservation; unpaid holds are released automatically.

## Check availability over plain HTTP

GET https://www.qontaktly.com/api/agent/availability?property=<id-or-slug>&check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&adults=2&children=0

Example:

https://www.qontaktly.com/api/agent/availability?property=sunset-villa&check_in=2026-08-01&check_out=2026-08-04&adults=2

Returns JSON with the property, the sellable room types with stay totals and rate plans, the deposit policy, and booking links. Dates use YYYY-MM-DD; stays are 1 to 90 nights.

## Booking pages

Every property has a public booking page for humans at https://www.qontaktly.com/book/<slug>. Agents that cannot use MCP can hand the guest that link.