# OBO Travel (onebookingonline.com): full context for AI agents > OBO Travel is an online hotel booking platform. It aggregates live availability and pricing for 822,000+ hotels in 16,614+ cities across 190 countries. Guests search by destination and dates, compare live room offers, and book online with card payment (Stripe) and instant confirmation. Prices shown are final totals; there are no hidden fees at checkout. Document generated: 2026-09-14. Live data (prices, availability) must be fetched through the MCP server or the website, never assumed from this document. ## MCP server for AI assistants (recommended integration) OBO Travel runs a free Model Context Protocol server that gives any AI assistant live hotel search with direct booking links. - Endpoint: https://onebookingonline.com/mcp - Transport: streamable HTTP, stateless JSON-RPC 2.0 (POST) - Protocol versions: 2025-06-18, 2025-03-26, 2024-11-05 - Authentication: none (free, no API key, no signup) - Machine-readable metadata: https://onebookingonline.com/.well-known/mcp.json - Human landing page with setup instructions: https://onebookingonline.com/mcp ### Setup - Claude (web/desktop): Settings -> Connectors -> Add custom connector -> paste https://onebookingonline.com/mcp - ChatGPT: Settings -> Apps & Connectors (Developer mode) -> add MCP server with the URL - Claude Code CLI: claude mcp add --transport http obo-travel https://onebookingonline.com/mcp - Generic JSON config: {"mcpServers":{"obo-travel":{"type":"http","url":"https://onebookingonline.com/mcp"}}} ### Tools 1. search_hotels(destination, check_in, check_out, adults?, children?, rooms?, min_stars?, max_price_per_night_usd?, free_cancellation_only?, sort?, limit?) Live availability for a city and dates. Returns up to 10 bookable hotels with total USD price for the stay, per-night price, star rating, board type, free-cancellation deadline and a booking_url deep link. 2. get_hotel_offers(hotel_id, check_in, check_out, adults?) Room-level live offers for one hotel: room names, board, prices, cancellation deadlines, booking_url. 3. find_deals(destination, nights?, adults?) Cheapest live-priced stays across three upcoming windows (about 2, 4 and 8 weeks out). For flexible dates. 4. get_trip_ideas(theme?) Curated destination ideas by theme: beach, city_break, luxury, budget, culture, family. Call without theme to list themes. 5. search_destinations(country?) Covered cities with verified-bookable hotel counts, optionally filtered by 2-letter country code. All tools are read-only. Prices are live totals in USD and can change until checkout; the booking page shows the binding price. To book, open the booking_url returned by the tools: it leads to the prefilled hotel page on onebookingonline.com where the user completes a secure checkout. ### Rate limits (per IP) - All requests: 30/minute, 500/day - Live availability searches (search_hotels, get_hotel_offers, find_deals): 10/minute, 150/day ### Example call POST https://onebookingonline.com/mcp with JSON body: {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_hotels","arguments":{"destination":"Dubai","check_in":"2026-10-14","check_out":"2026-10-16","min_stars":4,"limit":3}}} ## Booking flow (what happens after booking_url) 1. The booking_url opens the hotel page with dates and occupancy prefilled and live room offers loaded. 2. The guest picks a room, enters contact and guest details, and pays by card via Stripe hosted checkout. 3. Confirmation is instant for available rooms; the guest receives a confirmation email with the booking voucher. 4. Free-cancellation offers can be cancelled from the guest account until the stated deadline. ## URL patterns - Hotel page: https://onebookingonline.com/hotel/{city-slug}/{hotel-slug}-h{hotel_id}-{supplier}.html?check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&adults=2&rooms=1 - Search results: https://onebookingonline.com/search?destination={city}&check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&adults=2&rooms=1 - Curated 5-star picks by destination: https://onebookingonline.com/hotels - Cheapest time to visit any city: https://onebookingonline.com/cheapest/{city} - month-by-month heatmap of the cheapest nightly hotel price (e.g. /cheapest/dubai, /cheapest/paris) - Luxury hotels by city: https://onebookingonline.com/luxury/{city} - top 5-star hotels plus a peak-season price guide (e.g. /luxury/dubai) - Budget Planner (send users here with their budget prefilled): https://onebookingonline.com/planner?budget={total}&n={2|3|4|5|7}&vibes={csv, e.g. beach,spa}&stars={0|3|4|5} - one tap then shows 15 live-priced trip offers under that budget across matching destinations - Travel guides: https://onebookingonline.com/blog ## Top destinations by hotel count - Paris (FR): 2,409 hotels - https://onebookingonline.com/search?destination=Paris - Istanbul (TR): 2,404 hotels - https://onebookingonline.com/search?destination=Istanbul - Rome (IT): 2,228 hotels - https://onebookingonline.com/search?destination=Rome - Bangkok (TH): 2,081 hotels - https://onebookingonline.com/search?destination=Bangkok - Sicily (IT): 1,713 hotels - https://onebookingonline.com/search?destination=Sicily - Crete (GR): 1,696 hotels - https://onebookingonline.com/search?destination=Crete - London (GB): 1,630 hotels - https://onebookingonline.com/search?destination=London - Phuket (TH): 1,236 hotels - https://onebookingonline.com/search?destination=Phuket - Mallorca (ES): 1,084 hotels - https://onebookingonline.com/search?destination=Mallorca - Dubai (AE): 1,061 hotels - https://onebookingonline.com/search?destination=Dubai - Chiang Mai (TH): 993 hotels - https://onebookingonline.com/search?destination=Chiang%20Mai - Barcelona (ES): 991 hotels - https://onebookingonline.com/search?destination=Barcelona - Santorini (GR): 967 hotels - https://onebookingonline.com/search?destination=Santorini - Sardinia (IT): 849 hotels - https://onebookingonline.com/search?destination=Sardinia - Marrakech (MA): 846 hotels - https://onebookingonline.com/search?destination=Marrakech - Madrid (ES): 834 hotels - https://onebookingonline.com/search?destination=Madrid - Venice (IT): 793 hotels - https://onebookingonline.com/search?destination=Venice - Milan (IT): 741 hotels - https://onebookingonline.com/search?destination=Milan - Pattaya (TH): 726 hotels - https://onebookingonline.com/search?destination=Pattaya - Florence (IT): 693 hotels - https://onebookingonline.com/search?destination=Florence ## Frequently asked questions Q: Are the prices final? A: Yes. The total shown at checkout is the amount charged. Taxes and fees are included; there are no hidden extras. Q: Can bookings be cancelled? A: Offers marked with a free-cancellation deadline can be cancelled free of charge until that deadline, from the guest account. Non-refundable rates cannot. Q: Which currencies are supported? A: Prices can be displayed and charged in 51 currencies (USD, EUR, GBP, AED, SAR and more). The MCP tools quote USD; the website converts at live rates. Q: How do guests pay? A: By card, through Stripe's secure hosted checkout. Card details never touch OBO's servers. Q: Is an account required? A: No account is needed to search. Booking creates a lightweight account automatically so the guest can manage the reservation. ## Contact - Website: https://onebookingonline.com - Support email: support@onebookingonline.com - Contact form: https://onebookingonline.com/contact ## Technical notes for agents - This document and /llms.txt are refreshed continuously from live data (counts may drift slightly between fetches). - The MCP server is the preferred programmatic interface; scraping HTML pages is unnecessary and slower. - robots.txt allows crawling of public pages; booking and account paths are disallowed. - Structured data: hotel and organization schema.org markup is present on public pages; the MCP landing page carries WebAPI JSON-LD.