Quub hotel search and booking

Working · 1.7 s

rent.quub/hotelsv1.0.0 Domain verified

Live hotel prices worldwide, sourced destination guides, prebooking. No key needed for reads.

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://quub.rent/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_booking Destructive

Cancels a confirmed booking with a refundable rate that this key made. The refund follows the rate terms (free before the deadline, the hotel charge after it) and goes back to the card through Nuitee. Non-refundable rates cannot be cancelled online. Only call this when the guest asked for it. Needs the guest email. Needs a Quub API key (this connection has none yet: use request_api_key).

booking_idstring, required

booking_id from prebook.

guest_emailstring, required

The guest email used for the booking.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (8)

cancel_booking

destructive

Argument	Type	Description
booking_id*	string	booking_id from prebook.
guest_email*	string	The guest email used for the booking.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id",
    "guest_email"
  ],
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "booking_id from prebook."
    },
    "guest_email": {
      "type": "string",
      "description": "The guest email used for the booking."
    }
  }
}

get_booking

Status of a booking this key made: awaiting_payment (with pay_url), confirming, confirmed (confirmation number, hotel reference, voucher_url), outcome_pending, failed or cancelled (refund), plus the total, the cancellation terms and the free cancellation deadline. Needs the guest email or the booking_secret from prebook. Needs a Quub API key (this connection has none yet: use request_api_key).

read-only

Argument	Type	Description
booking_id*	string	booking_id from prebook, starts with Q.
guest_email	string	The guest email used for the booking.
booking_secret	string	booking_secret from prebook.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id"
  ],
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "booking_id from prebook, starts with Q."
    },
    "guest_email": {
      "type": "string",
      "description": "The guest email used for the booking."
    },
    "booking_secret": {
      "type": "string",
      "description": "booking_secret from prebook."
    }
  }
}

get_destination_guide

The facts of one destination guide as data, each with its source URL: tourist tax, short-term rental rules, guest registration, parking with a rental car, monthly stays, airport, emergency number (key_facts), the areas to stay in (who each suits, how parking and car access work, distances), the articles, the FAQ and every source.

read-only

Argument	Type	Description
slug*	string	Destination slug from list_destinations, e.g. "lisbon".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Destination slug from list_destinations, e.g. \"lisbon\"."
    }
  }
}

get_hotel

One hotel's details (address, coordinates, stars, rating, photos, description, facilities, check-in and check-out times, parking) and, when dates are given, every bookable room for them: offer_id, room name, board, refundable and the free cancellation deadline, total, per night, taxes included and taxes at the property, and a book_url where a person can fill in the guest form. Prices are the total for the whole stay for one room, in the currency asked (EUR by default), as Nuitee, the booking partner and merchant of record, charges them, with the taxes Nuitee collects included. Taxes and fees paid at the property (often a city or tourist tax) are listed separately in taxes_at_property and are not in the total.

read-only

Argument	Type	Description
adults	integer	Adults in the one room, 1 to 8. Default 2.
checkin	string	Check-in date, YYYY-MM-DD, today or later.
checkout	string	Check-out date, YYYY-MM-DD, 1 to 30 nights after check-in.
children	array	Ages of children in the room, if any.
currency	string	ISO 4217 currency for the prices, default EUR.
hotel_id*	string	The hotel id from search_hotels.
nationality

list_destinations

The destinations Quub has a sourced guide for (slug, name, country, one line, last fact check, guide URL). Hotels can be searched anywhere, not only in these. Optional q filters by name or country.

read-only

Argument	Type	Description
q	string	Filter by name, country or slug, e.g. "Spain".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Filter by name, country or slug, e.g. \"Spain\"."
    }
  }
}

prebook

Holds one room (an offer_id from search_hotels or get_hotel) with the partner for the named guest and returns booking_id, booking_secret (shown once), the confirmed total (price_changed and previous_total when the hotel repriced it), the cancellation terms and pay_url. Nothing is ever charged by a tool: the person named as guest pays on the pay_url page, Nuitee's payment form, and the booking exists only after that payment. Give the guest pay_url and tell them the total and the cancellation terms; if price_changed is true, say so. The guest's name must match the ID shown at check-in; email and phone with country code are required. Send an idempotency_key to make a retry safe. Needs a Quub API key (this connection has none yet: use request_api_key).

Argument	Type	Description
adults	integer	Adults in the one room, 1 to 8. Default 2.
checkin*	string	Check-in date, YYYY-MM-DD, today or later.
remarks	string	Special requests for the hotel, not guaranteed.
checkout*	string	Check-out date, YYYY-MM-DD, 1 to 30 nights after check-in.
currency	string	ISO 4217 currency for the prices, default EUR.
hotel_id*	string	The hotel id the offer belongs to.
offer_id*

request_api_key

Sends an email with a one-time link to a free Quub API key. The owner of the address opens the link, sees the key once and adds it to this connector (Authorization: Bearer quub_..., or ?key=quub_... on the server URL). A key is needed for prebook, get_booking and cancel_booking and raises the search limits. Bookings made with a key carry an 8 percent margin. Only send it to an address the person gave you for this.

Argument	Type	Description
email*	string	Where the link goes.
label	string	A name for the key, e.g. the agent or app.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Where the link goes."
    },
    "label": {
      "type": "string",
      "maxLength": 80,
      "description": "A name for the key, e.g. the agent or app."
    }
  }
}

search_hotels

Live hotel prices for a place and dates. place can be a city, region, island, airport or landmark name anywhere in the world, a Quub destination slug (see list_destinations) or a Google place id. Returns up to limit hotels, cheapest first (or best rated): id, name, stars, guest rating (0 to 10) and review count, coordinates, photo, area or distance from the centre, the cheapest room with its total, board, refund rule and free cancellation deadline, its offer_id for prebook, and hotel_url / book_url pages a person can open. Prices are the total for the whole stay for one room, in the currency asked (EUR by default), as Nuitee, the booking partner and merchant of record, charges them, with the taxes Nuitee collects included. Taxes and fees paid at the property (often a city or tourist tax) are listed separately in taxes_at_property and are not in the total.

read-only

Argument	Type	Description
sort	string	price (cheapest total first, default) or rating.
limit	integer	How many hotels, 1 to 60. Default 20.
place*	string	Where: "Lisbon", "Kotor, Montenegro", "lisbon" (slug) or a Google place id.
adults	integer	Adults in the one room, 1 to 8. Default 2.
checkin*	string	Check-in date, YYYY-MM-DD, today or later.
checkout*

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "offer_id", "hotel_id", "checkin", "checkout", "guest_first_name", "guest_last_name", "guest_email", "guest_phone" ], "properties": { "adults": { "type": "integer", "maximum": 8, "minimum": 1, "description": "Adults in the one room, 1 to 8. Default 2." }, "checkin": { "type": "string", "description": "Check-in date, YYYY-MM-DD, today or later." }, "remarks": { "type": "string", "maxLength": 500, "description": "Special requests for the hotel, not guaranteed." }, "checkout": { "type": "string", "description": "Check-out date, YYYY-MM-DD, 1 to 30 nights after check-in." }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency for the prices, default EUR." }, "hotel_id": { "type": "string", "description": "The hotel id the offer belongs to." }, "offer_id": { "type": "string", "description": "offer_id from search_hotels or get_hotel, for these dates and adults." }, "guest_email": { "type": "string", "description": "The confirmation goes here; the guest needs it to cancel." }, "guest_phone": { "type": "string", "description": "With country code, e.g. +31 6 1234 5678." }, "nationality": { "type": "string", "maxLength": 2, "minLength": 2, "description": "Guest nationality, ISO 3166 alpha-2 (prices can depend on it). Default from the client's language, else NL." }, "expected_total": { "type": "number", "description": "The total you saw for this offer, so a change is flagged." }, "guest_last_name": { "type": "string", "description": "As on the ID shown at check-in." }, "idempotency_key": { "type": "string", "maxLength": 200, "description": "Any unique string; the same key returns the same booking instead of a second one." }, "guest_first_name": { "type": "string", "description": "As on the ID shown at check-in." } } }