Hotel data for AI assistants

Everything on this site is also published in a form a machine can read: Markdown, JSON, and an MCP server. It is public, read-only and needs no API key. Availability and prices come straight from each hotel's own management system — the same numbers the front desk sees.

Two kinds of listing

bookable — the reservation is taken here and lands in the hotel's own system. Live price, no booking fee, no commission on the guest's price. Cash on arrival or card online.
listed — the hotel is known and its facts are published, but its nights are not sold here. Contact is by email enquiry only. Never present one of these as bookable.

Endpoints

/llms.txt	Markdown index of the whole site — the llms.txt convention.
/llms-full.txt	Every hotel and city in one file, with live prices.
/hotel/{slug}.md	One hotel, as Markdown: rooms, prices, policies.
/hotels/{city}.md	Every hotel in a city, as Markdown.
/api/hotels	JSON. Accepts check_in, check_out, guests, city, bookable_only, limit.
/api/hotels/{slug}	JSON for one hotel, with its rooms priced for your dates.
/api/cities	JSON list of destinations and how many hotels are bookable in each.
/api/things-to-do/{city}	JSON list of highly-rated places in a city.
/mcp	MCP server, JSON-RPC 2.0 over POST.

MCP server

Point an MCP-capable assistant at the URL below. It is stateless HTTP JSON-RPC: no session, no key, read-only.

https://www.heroeshotels.com/mcp

search_hotels

Find hotels in Cambodia with live availability and prices for given dates. Returns bookable hotels (reservable on heroeshotels.com, no booking fee) and listed ones (enquiry only).

get_hotel

Everything known about one hotel, including its rooms and their price for the dates given.

check_availability

Is this hotel available for these dates, and at what price? Reads the hotel's own system.

list_cities

The Cambodian destinations covered, with how many hotels are bookable in each and the lowest nightly price.

things_to_do

Highly-rated places in a city — sights, restaurants, bars, beaches — with their Google rating.

Terms

Free to read, quote and cite, including inside an AI answer. A link back to the hotel's page is appreciated — it is how a traveller reaches the hotel without a commission being taken from them. Please do not present a price without the dates it was quoted for: hotel rates change by the night.