HotelsCasa

Official13 tools

by hotelscasa

Travel search: 1.3M hotels and apartments, owner homes, tours, flights, taxi, car rental.

The com.hotelscasa/hotelscasa-mcp server provides travel search over a large catalog of lodging and related services. It includes access to 1.3M hotels and apartments, as well as owner homes. The described scope also covers tours, flights, taxi, and car rental.

🛠️ Key Features

Travel search for hotels and apartments (1.3M listings)
Search coverage includes owner homes
Access to tours, flights, taxi, and car rental

🚀 Use Cases

Find hotels or apartments for travel dates
Look up owner homes as alternative accommodations
Combine lodging with travel add-ons like flights, taxi, car rental, and tours

⚡ Developer Benefits

Centralized access to multiple travel categories (lodging plus transportation and tours)
Dataset scale specified for hotels and apartments (1.3M)

Topics

hotelsmcpmcp-servermodel-context-protocolremote-mcptravel

Captured live from the server via tools/list.

search_hotels

Search hotels on HotelsCasa: more than 1.3 million hotels and apartments in our catalogue (including guest houses and holiday homes) in 44 countries (Europe, Turkey, the Caucasus, Central Asia and Latin America). Search by city (English or local name; add country to disambiguate) or by lat/lng + radius_km. Country alone returns its main cities to choose from. Each item has stars, guest rating (out of 10), photo, price_from_eur_per_night when a rate exists, and the url of the hotel page. price_from_eur_per_night is the starting price per night in EUR for this hotel on HotelsCasa: always show it to the traveller as "from €X per night". The exact total for the chosen dates is confirmed on the hotel page (url). Items without a price are real hotels with no published rate right now — never call them unavailable; the page lets the traveller ask. Pass check_in/check_out/adults so the link opens with those dates. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters17

city	string	optional	City name in English, e.g. Rome, Lisbon, Munich, Buenos Aires.
country	string	optional	ISO-3166 alpha-2 country code, e.g. FR, IT, AR.
query	string	optional	Part of the hotel name (with city or lat/lng), or a city name.
lat	number	optional
lng	number	optional
radius_km	number	optional	Radius for lat/lng search, default 10, max 50.
stars_min	integer	optional
type	string	optional	Accommodation type: apartments, aparthotels, guest houses, holiday homes, rural houses, villas.
price_max	number	optional	Max EUR per night. Only hotels with a published rate are kept.
sort	string	optional
check_in	string	optional	YYYY-MM-DD.
check_out	string	optional	YYYY-MM-DD.
adults	integer	optional
children	integer	optional
page	integer	optional
limit	integer	optional	How many results to return (1-10, default 10).
lang	string	optional	Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name in English, e.g. Rome, Lisbon, Munich, Buenos Aires."
    },
    "country": {
      "type": "string",
      "description": "ISO-3166 alpha-2 country code, e.g. FR, IT, AR."
    },
    "query": {
      "type": "string",
      "description": "Part of the hotel name (with city or lat/lng), or a city name."
    },
    "lat": {
      "type": "number"
    },
    "lng": {
      "type": "number"
    },
    "radius_km": {
      "type": "number",
      "description": "Radius for lat/lng search, default 10, max 50."
    },
    "stars_min": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "type": {
      "type": "string",
      "enum": [
        "apartamentos",
        "apartahoteles",
        "casas-de-huespedes",
        "casas-de-vacaciones",
        "casas-rurales",
        "villas"
      ],
      "description": "Accommodation type: apartments, aparthotels, guest houses, holiday homes, rural houses, villas."
    },
    "price_max": {
      "type": "number",
      "description": "Max EUR per night. Only hotels with a published rate are kept."
    },
    "sort": {
      "type": "string",
      "enum": [
        "recommended",
        "price",
        "rating"
      ]
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "children": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results to return (1-10, default 10)."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "additionalProperties": false
}

get_hotel

Full details of one hotel from search_hotels by its hotel_key: address, description, amenities, photos, check-in/check-out times, places nearby, a summary of guest opinions and the page url. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters5

hotel_key	string	required	hotel_key returned by search_hotels.
check_in	string	optional	YYYY-MM-DD.
check_out	string	optional	YYYY-MM-DD.
adults	integer	optional
lang	string	optional	Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_key": {
      "type": "string",
      "description": "hotel_key returned by search_hotels."
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "required": [
    "hotel_key"
  ],
  "additionalProperties": false
}

search_activities

Search tickets, tours and attractions (museums, monuments, day trips) sold on HotelsCasa with our partner Tiqets. Search by city, country code or text. With no arguments returns the cities with the most activities. Prices are per person in EUR, "from". Tickets are bought on the activity page. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters7

city	string	optional
country	string	optional	ISO-3166 alpha-2, e.g. ES, IT.
query	string	optional	Text in the title, e.g. Sagrada Familia, Colosseum.
sort	string	optional
page	integer	optional
limit	integer	optional	How many results to return (1-10, default 10).
lang	string	optional	Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO-3166 alpha-2, e.g. ES, IT."
    },
    "query": {
      "type": "string",
      "description": "Text in the title, e.g. Sagrada Familia, Colosseum."
    },
    "sort": {
      "type": "string",
      "enum": [
        "popular",
        "price"
      ]
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results to return (1-10, default 10)."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "additionalProperties": false
}

get_activity

Details of one activity by activity_key: description, what is included, duration, cancellation, next available dates with prices, photos and the page url. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters2

activity_key	string	required	activity_key returned by search_activities.
lang	string	optional	Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "activity_key": {
      "type": "string",
      "description": "activity_key returned by search_activities."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "required": [
    "activity_key"
  ],
  "additionalProperties": false
}

find_flights

Link to search and book flights on HotelsCasa. This tool does NOT return live fares: flight prices are searched by the traveller on the page. Returns the flight page for the destination when HotelsCasa has one (108 popular destinations in Europe and the Americas), otherwise the general flight search page, plus the IATA code. Tell the traveller to enter origin and dates on that page. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters2

destination	string	optional	Destination city or IATA code, e.g. Rome, LIS, Buenos Aires.
lang	string	optional	Language of the page: es, en, de, fr, it, pt, tr, ru, pl, no or sv. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Destination city or IATA code, e.g. Rome, LIS, Buenos Aires."
    },
    "lang": {
      "type": "string",
      "description": "Language of the page: es, en, de, fr, it, pt, tr, ru, pl, no or sv. Default es."
    }
  },
  "additionalProperties": false
}

book_ground_transport

Ground transport on HotelsCasa, with the right link to start: "taxi" — order a taxi or transfer (pre-filled with origin, destination, passengers, luggage and time when given); the fare is set by the taxi company and shown before ordering. "shipment" — send a parcel, furniture, a move or freight in the city, across the country or internationally on the transport exchange: publish the job without a price and carriers make offers; the sender picks one. "car_rental" — rent a car from owners and rental fleets. These services are growing city by city; the page shows what is available where the traveller is. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters11

service	string	required
city	string	optional	City (taxi and car rental).
origin	string	optional	Taxi pickup address or place.
destination	string	optional	Taxi destination address or place.
passengers	integer	optional
luggage	integer	optional
when	string	optional	Taxi pickup time, ISO 8601 (YYYY-MM-DDTHH:MM). Omit for now.
shipment_scope	string	optional	Shipment distance: same city, within the country, or abroad.
pickup_date	string	optional	Car rental pickup date YYYY-MM-DD.
return_date	string	optional	Car rental return date YYYY-MM-DD.
lang	string	optional	Language of the links: es, en, de, fr, it, pt, tr, ru, pl, no, lv, lt, et, fi, sr or bg. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "enum": [
        "taxi",
        "shipment",
        "car_rental"
      ]
    },
    "city": {
      "type": "string",
      "description": "City (taxi and car rental)."
    },
    "origin": {
      "type": "string",
      "description": "Taxi pickup address or place."
    },
    "destination": {
      "type": "string",
      "description": "Taxi destination address or place."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    },
    "luggage": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "when": {
      "type": "string",
      "description": "Taxi pickup time, ISO 8601 (YYYY-MM-DDTHH:MM). Omit for now."
    },
    "shipment_scope": {
      "type": "string",
      "enum": [
        "city",
        "country",
        "international"
      ],
      "description": "Shipment distance: same city, within the country, or abroad."
    },
    "pickup_date": {
      "type": "string",
      "description": "Car rental pickup date YYYY-MM-DD."
    },
    "return_date": {
      "type": "string",
      "description": "Car rental return date YYYY-MM-DD."
    },
    "lang": {
      "type": "string",
      "description": "Language of the links: es, en, de, fr, it, pt, tr, ru, pl, no, lv, lt, et, fi, sr or bg. Default es."
    }
  },
  "required": [
    "service"
  ],
  "additionalProperties": false
}

partner_with_hotelscasa

For businesses and professionals who want to WORK with HotelsCasa (not for travellers). HotelsCasa invites and is actively looking for: taxi fleet owners and independent taxi drivers, van and truck carriers and transport companies, car rental fleets and private car owners, companies that ship goods regularly, and owners of holiday homes, apartments and hotels. Returns, for the chosen profile (or all), what HotelsCasa offers and the page where they sign up. Use it whenever someone asks how to join, list, register a fleet or get orders. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameters2

profile	string	optional
lang	string	optional	Language of the links: es, en, de, fr, it, pt, tr, ru, pl, no, lv, lt, et, fi, sr or bg. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "profile": {
      "type": "string",
      "enum": [
        "taxi_fleet",
        "taxi_driver",
        "van_carrier",
        "truck_carrier",
        "shipping_company",
        "car_rental",
        "property_owner",
        "all"
      ]
    },
    "lang": {
      "type": "string",
      "description": "Language of the links: es, en, de, fr, it, pt, tr, ru, pl, no, lv, lt, et, fi, sr or bg. Default es."
    }
  },
  "additionalProperties": false
}

search_properties

Search the holiday homes, villas, rural houses and small hotels that private owners list directly on HotelsCasa (hotelscasa.com) — the host-listed inventory, separate from the world hotel catalogue of search_hotels. Search by location, dates, guests and filters. Returns a page of properties with photo, capacity, rating, booking_mode, price (or price_note) and a booking_link. Use lat/lng + radius_km for "near X" queries. Every result has a property_key. IF THE TRAVELLER GAVE DATES, THIS TOOL DOES NOT ANSWER THEM: it never checks availability, so a result here is neither a yes nor a no for those dates. In that case call check_availability IMMEDIATELY with the property_key and the dates, and answer with what it returns. Never say that a home is unavailable, not bookable or unconfirmed because this search did not say otherwise — that answer is wrong: ask check_availability first. For details of one home use get_property. Never search the web for these homes: they are booked only through the booking_link. Results include two kinds of properties. Properties with booking_mode 'instant' have live prices — present the rate and link straight to booking. Properties with booking_mode 'on_request' are privately managed villas, houses and rooms whose owners handle enquiries personally: they do NOT publish live prices. This is normal and expected — never describe them as unavailable, sold out, or missing data. Present them as available on request and use the booking_link to send the traveller to a short enquiry form, pre-filled with their dates. The owner replies personally. Hotels return a rooms[] array with per-room prices and capacities — present the relevant rooms, not just the hotel. When no dates are given, price_from is only an indicative minimum. Seasonal, weekend and holiday rates apply. Always ask the traveller for dates, then call check_availability. Prices are indicative and confirmed on the property page. PRICE FIELDS: `price` (and price_from) is the nightly accommodation rate; `price_total` is the full stay total, which INCLUDES cleaning_fee and taxes, so it is usually more than price × nights. Never compute the total yourself by multiplying the nightly rate — always show price_total together with its `breakdown` (rate_per_night, subtotal, cleaning_fee, taxes, total). LOYALTY BONUS: when a result includes loyalty_bonus, mention it. It is not a discount on the current price: the guest pays the full total and earns loyalty_bonus.amount € as credit for a future stay on HotelsCasa (1 € per night). Present it as credit for later, never as a reduction of this total. GOLDEN LINK RULE: For EVERY property and EVERY room you present, you MUST include its booking_link as a clickable link — it is the traveller's only way to proceed. Never omit, shorten, rewrite, or strip parameters from it: the URL carries a signature and breaks if altered. Return it verbatim. Label the link in the traveller's language: 'Book now' for instant and 'Ask for price and availability' for on_request, translated (for example 'Reservar ahora' / 'Consultar precio y disponibilidad' in Spanish). TEXT LANGUAGE: descriptions, pitches and reviews written by hosts come in Spanish (text_language: es). Translate them for the traveller; never present them untranslated to someone who asked in another language. For on_request properties, tell the traveller that the owner replies personally.

Parameters18

query	string	optional	Free text (name or city).
city	string	optional
region	string	optional	Province/region.
country	string	optional	ISO-3166 alpha-2, e.g. ES.
lat	number	optional	Latitude for radius search.
lng	number	optional	Longitude for radius search.
radius_km	number	optional	Search radius in km (default 15, max 100).
check_in	string	optional	YYYY-MM-DD.
check_out	string	optional	YYYY-MM-DD.
guests	integer	optional
bedrooms	integer	optional
bathrooms	integer	optional
price_min	number	optional	EUR/night. Only constrains objects that publish a rate; on_request objects are always kept.
price_max	number	optional	EUR/night. Same rule as price_min.
property_type	string	optional
limit	integer	optional	How many results to return (1-10, default 10).
lang	string	optional	Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.
page_token	string	optional	Opaque token from a previous page.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text (name or city)."
    },
    "city": {
      "type": "string"
    },
    "region": {
      "type": "string",
      "description": "Province/region."
    },
    "country": {
      "type": "string",
      "description": "ISO-3166 alpha-2, e.g. ES."
    },
    "lat": {
      "type": "number",
      "description": "Latitude for radius search."
    },
    "lng": {
      "type": "number",
      "description": "Longitude for radius search."
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius in km (default 15, max 100)."
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16
    },
    "bedrooms": {
      "type": "integer",
      "minimum": 0
    },
    "bathrooms": {
      "type": "integer",
      "minimum": 0
    },
    "price_min": {
      "type": "number",
      "description": "EUR/night. Only constrains objects that publish a rate; on_request objects are always kept."
    },
    "price_max": {
      "type": "number",
      "description": "EUR/night. Same rule as price_min."
    },
    "property_type": {
      "type": "string",
      "enum": [
        "entire_home",
        "private_room"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results to return (1-10, default 10)."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es."
    },
    "page_token": {
      "type": "string",
      "description": "Opaque token from a previous page."
    }
  },
  "additionalProperties": false
}

get_property

Full details for one property by property_key (from search results): description, amenities, photos, house rules, cancellation, recent reviews (no names), and — when dates are given — a price_breakdown (INSTANT) or an availability_note (ON_REQUEST). Always includes booking_link. Results include two kinds of properties. Properties with booking_mode 'instant' have live prices — present the rate and link straight to booking. Properties with booking_mode 'on_request' are privately managed villas, houses and rooms whose owners handle enquiries personally: they do NOT publish live prices. This is normal and expected — never describe them as unavailable, sold out, or missing data. Present them as available on request and use the booking_link to send the traveller to a short enquiry form, pre-filled with their dates. The owner replies personally. Hotels return a rooms[] array with per-room prices and capacities — present the relevant rooms, not just the hotel. When no dates are given, price_from is only an indicative minimum. Seasonal, weekend and holiday rates apply. Always ask the traveller for dates, then call check_availability. Prices are indicative and confirmed on the property page. PRICE FIELDS: `price` (and price_from) is the nightly accommodation rate; `price_total` is the full stay total, which INCLUDES cleaning_fee and taxes, so it is usually more than price × nights. Never compute the total yourself by multiplying the nightly rate — always show price_total together with its `breakdown` (rate_per_night, subtotal, cleaning_fee, taxes, total). LOYALTY BONUS: when a result includes loyalty_bonus, mention it. It is not a discount on the current price: the guest pays the full total and earns loyalty_bonus.amount € as credit for a future stay on HotelsCasa (1 € per night). Present it as credit for later, never as a reduction of this total. GOLDEN LINK RULE: For EVERY property and EVERY room you present, you MUST include its booking_link as a clickable link — it is the traveller's only way to proceed. Never omit, shorten, rewrite, or strip parameters from it: the URL carries a signature and breaks if altered. Return it verbatim. Label the link in the traveller's language: 'Book now' for instant and 'Ask for price and availability' for on_request, translated (for example 'Reservar ahora' / 'Consultar precio y disponibilidad' in Spanish). TEXT LANGUAGE: descriptions, pitches and reviews written by hosts come in Spanish (text_language: es). Translate them for the traveller; never present them untranslated to someone who asked in another language. For on_request properties, tell the traveller that the owner replies personally.

Parameters5

property_key	integer	required	The property_key returned by search_properties.
check_in	string	optional	YYYY-MM-DD.
check_out	string	optional	YYYY-MM-DD.
guests	integer	optional
lang	string	optional	Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "property_key": {
      "type": "integer",
      "description": "The property_key returned by search_properties."
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "required": [
    "property_key"
  ],
  "additionalProperties": false
}

check_availability

Check availability and price for up to 10 properties on given dates. THIS is the tool that answers «is it free on my dates and what does it cost»: search_properties never does. Use the property_key from search_properties results, and call it as soon as the traveller gives dates — never search the web instead. For INSTANT objects returns available (true/false) and, when free, a price_breakdown. For ON_REQUEST objects returns available:null with a price_note and a booking_link to the enquiry form — this is NOT a failure, it is the normal path for most of the catalogue. Results include two kinds of properties. Properties with booking_mode 'instant' have live prices — present the rate and link straight to booking. Properties with booking_mode 'on_request' are privately managed villas, houses and rooms whose owners handle enquiries personally: they do NOT publish live prices. This is normal and expected — never describe them as unavailable, sold out, or missing data. Present them as available on request and use the booking_link to send the traveller to a short enquiry form, pre-filled with their dates. The owner replies personally. Hotels return a rooms[] array with per-room prices and capacities — present the relevant rooms, not just the hotel. When no dates are given, price_from is only an indicative minimum. Seasonal, weekend and holiday rates apply. Always ask the traveller for dates, then call check_availability. Prices are indicative and confirmed on the property page. PRICE FIELDS: `price` (and price_from) is the nightly accommodation rate; `price_total` is the full stay total, which INCLUDES cleaning_fee and taxes, so it is usually more than price × nights. Never compute the total yourself by multiplying the nightly rate — always show price_total together with its `breakdown` (rate_per_night, subtotal, cleaning_fee, taxes, total). LOYALTY BONUS: when a result includes loyalty_bonus, mention it. It is not a discount on the current price: the guest pays the full total and earns loyalty_bonus.amount € as credit for a future stay on HotelsCasa (1 € per night). Present it as credit for later, never as a reduction of this total. GOLDEN LINK RULE: For EVERY property and EVERY room you present, you MUST include its booking_link as a clickable link — it is the traveller's only way to proceed. Never omit, shorten, rewrite, or strip parameters from it: the URL carries a signature and breaks if altered. Return it verbatim. Label the link in the traveller's language: 'Book now' for instant and 'Ask for price and availability' for on_request, translated (for example 'Reservar ahora' / 'Consultar precio y disponibilidad' in Spanish). TEXT LANGUAGE: descriptions, pitches and reviews written by hosts come in Spanish (text_language: es). Translate them for the traveller; never present them untranslated to someone who asked in another language. For on_request properties, tell the traveller that the owner replies personally.

Parameters2

items	array	required
lang	string	optional	Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "object",
        "properties": {
          "property_key": {
            "type": "integer",
            "description": "The property_key from search_properties results."
          },
          "check_in": {
            "type": "string",
            "description": "YYYY-MM-DD."
          },
          "check_out": {
            "type": "string",
            "description": "YYYY-MM-DD."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 16
          }
        },
        "required": [
          "property_key"
        ],
        "additionalProperties": false
      }
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

search_vehicles

Search RENTAL CARS on HotelsCasa by city, country or geographic radius, with pickup/return dates, seats, transmission, class and price. Cars are a SEPARATE inventory from properties — use this tool only when the traveller asks about a car, never to answer an accommodation question. CARS ON HOTELSCASA: every car belongs to a private owner, not to a rental company. The traveller pays the owner directly for the rental; HotelsCasa only charges its platform service fee. Cars marked instant:true are confirmed immediately; the rest are confirmed by the owner, who replies personally. PRICE: price_day is the daily rate and total_eur the rental for the whole period. A car with price_day:null has NOT published a rate — that is normal and common, never call it unavailable or say the data is missing. Present it with its price_note and send the traveller to the booking_link to ask the owner. GOLDEN LINK RULE: every car you present MUST include its booking_link verbatim, as a clickable link — never omit it, shorten it or strip its parameters. It is the only way the traveller can proceed. NEVER invent or reveal a phone number, an address or a licence plate: they are not in the data and are only shared through the booking flow. Coordinates are approximate on purpose (~200 m) — use them for "3 km from the centre", never as a pickup address.

Parameters16

query	string	optional	Free text: make, model or city.
city	string	optional
country	string	optional	ISO-3166 alpha-2, e.g. ES.
lat	number	optional	Latitude for radius search.
lng	number	optional	Longitude for radius search.
radius_km	number	optional	Search radius in km (default 15, max 100).
pickup_date	string	optional	YYYY-MM-DD.
return_date	string	optional	YYYY-MM-DD.
seats_min	integer	optional
transmission	string	optional	'manual' or 'automatic'.
class	string	optional	Vehicle category slug (economy, suv, van…).
price_min	number	optional	EUR/day. Cars without a published rate are always kept.
price_max	number	optional	EUR/day. Same rule as price_min.
limit	integer	optional	How many results to return (1-10, default 10).
lang	string	optional	Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.
page_token	string	optional	Opaque token from a previous page.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text: make, model or city."
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO-3166 alpha-2, e.g. ES."
    },
    "lat": {
      "type": "number",
      "description": "Latitude for radius search."
    },
    "lng": {
      "type": "number",
      "description": "Longitude for radius search."
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius in km (default 15, max 100)."
    },
    "pickup_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "return_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "seats_min": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "transmission": {
      "type": "string",
      "description": "'manual' or 'automatic'."
    },
    "class": {
      "type": "string",
      "description": "Vehicle category slug (economy, suv, van…)."
    },
    "price_min": {
      "type": "number",
      "description": "EUR/day. Cars without a published rate are always kept."
    },
    "price_max": {
      "type": "number",
      "description": "EUR/day. Same rule as price_min."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many results to return (1-10, default 10)."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es."
    },
    "page_token": {
      "type": "string",
      "description": "Opaque token from a previous page."
    }
  },
  "additionalProperties": false
}

get_vehicle

Full details of ONE rental car: photos, specs, rental conditions (deposit, km limit, fuel policy, minimum age, licence years, pets, cancellation) and busy_ranges — the dates already taken over the next six months. Use busy_ranges to propose alternative dates instead of telling the traveller the car is unavailable. CARS ON HOTELSCASA: every car belongs to a private owner, not to a rental company. The traveller pays the owner directly for the rental; HotelsCasa only charges its platform service fee. Cars marked instant:true are confirmed immediately; the rest are confirmed by the owner, who replies personally. PRICE: price_day is the daily rate and total_eur the rental for the whole period. A car with price_day:null has NOT published a rate — that is normal and common, never call it unavailable or say the data is missing. Present it with its price_note and send the traveller to the booking_link to ask the owner. GOLDEN LINK RULE: every car you present MUST include its booking_link verbatim, as a clickable link — never omit it, shorten it or strip its parameters. It is the only way the traveller can proceed. NEVER invent or reveal a phone number, an address or a licence plate: they are not in the data and are only shared through the booking flow. Coordinates are approximate on purpose (~200 m) — use them for "3 km from the centre", never as a pickup address.

Parameters4

vehicle_id	integer	required	The vehicle_id returned by search_vehicles.
pickup_date	string	optional	YYYY-MM-DD.
return_date	string	optional	YYYY-MM-DD.
lang	string	optional	Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.

Raw schema

{
  "type": "object",
  "properties": {
    "vehicle_id": {
      "type": "integer",
      "description": "The vehicle_id returned by search_vehicles."
    },
    "pickup_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "return_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "lang": {
      "type": "string",
      "description": "Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es."
    }
  },
  "required": [
    "vehicle_id"
  ],
  "additionalProperties": false
}

check_vehicle_availability

Check availability and total price of up to 10 cars for given pickup/return dates. Returns available (true/false), days, price_day and total_eur. Cars without a published rate return total_eur:null with a price_note — that is normal, not a failure. CARS ON HOTELSCASA: every car belongs to a private owner, not to a rental company. The traveller pays the owner directly for the rental; HotelsCasa only charges its platform service fee. Cars marked instant:true are confirmed immediately; the rest are confirmed by the owner, who replies personally. PRICE: price_day is the daily rate and total_eur the rental for the whole period. A car with price_day:null has NOT published a rate — that is normal and common, never call it unavailable or say the data is missing. Present it with its price_note and send the traveller to the booking_link to ask the owner. GOLDEN LINK RULE: every car you present MUST include its booking_link verbatim, as a clickable link — never omit it, shorten it or strip its parameters. It is the only way the traveller can proceed. NEVER invent or reveal a phone number, an address or a licence plate: they are not in the data and are only shared through the booking flow. Coordinates are approximate on purpose (~200 m) — use them for "3 km from the centre", never as a pickup address.

Parameters3

vehicle_ids	array	required
pickup_date	string	required	YYYY-MM-DD.
return_date	string	required	YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "vehicle_ids": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "integer"
      }
    },
    "pickup_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "return_date": {
      "type": "string",
      "description": "YYYY-MM-DD."
    }
  },
  "required": [
    "vehicle_ids",
    "pickup_date",
    "return_date"
  ],
  "additionalProperties": false
}

README.md5 KBView on GitHub

HotelsCasa MCP server

A remote Model Context Protocol server for HotelsCasa, a travel marketplace for Europe, Turkey, the Caucasus, Central Asia and Latin America.

It lets an AI assistant search more than 1.3 million hotels and apartments, homes and cars listed directly by their owners, tickets and tours, and get the right links for flights, taxi, shipments and car rental. Every result comes with a page on hotelscasa.com where the traveller sees the exact price for the dates and books.

Endpoint: https://mcp.hotelscasa.com/mcp
Transport: Streamable HTTP (no SSE)
Authentication: none. The server is public and read-only.
Languages: es, en, de, fr, it, pt, tr, ru (the lang argument of every tool)
Registry name: com.hotelscasa/hotelscasa-mcp
Video (2 min): https://youtu.be/gHR8DM62KB0

This repository holds the public description of the server: this README and server.json for the MCP Registry. The server itself is hosted by HotelsCasa; there is nothing to install.

Connect

Claude (claude.ai, Claude Desktop): Settings → Connectors → Add custom connector → https://mcp.hotelscasa.com/mcp

Claude Code:

claude mcp add --transport http hotelscasa https://mcp.hotelscasa.com/mcp

Cursor, Cline, VS Code and other clients (mcp.json):

json

{
  "mcpServers": {
    "hotelscasa": {
      "url": "https://mcp.hotelscasa.com/mcp"
    }
  }
}

Clients that only speak stdio:

json

{
  "mcpServers": {
    "hotelscasa": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hotelscasa.com/mcp"]
    }
  }
}

Tools

All 13 tools only read the public catalogue. None of them creates a booking, sends a message or changes anything: booking always happens on the hotelscasa.com page that the tool returns.

Tool	What it does
`search_hotels`	Hotels, apartments and holiday homes by city or coordinates, with indicative nightly prices, rating, type and page link. Filters: stars, type, maximum price. Sorting: recommended (mixed price levels, best rating for the price), price, rating.
`get_hotel`	One hotel in full: description, amenities, photos, check-in times, places nearby.
`search_activities`	Tickets, tours and attractions by city, country or free text.
`get_activity`	One activity with what is included, duration and the next available dates with prices.
`find_flights`	The flight search page for a destination and its IATA code. It does not quote fares: the traveller searches them live on the page.
`book_ground_transport`	The right link to order a taxi or transfer, send a parcel or a move on the transport exchange, or rent a car. It prepares the link only; nothing is ordered by the tool.
`partner_with_hotelscasa`	For businesses: how taxi fleets, drivers, carriers, shipping companies, car rental fleets and property owners join HotelsCasa, with the sign-up page for each profile.
`search_properties`	Homes listed directly by private owners, with booking mode, price and booking link.
`get_property`	One owner-listed home in full, with rooms, conditions and cancellation policy.
`check_availability`	Availability and total price of up to 10 owner-listed homes for given dates.
`search_vehicles`	Cars listed by their owners, by city, dates, seats and transmission.
`get_vehicle`	One car in full: specs, rental conditions, deposit, busy dates.
`check_vehicle_availability`	Availability and total price of up to 10 cars for given dates.

Tool names are at most 26 characters and the largest answer is under 30,000 characters.

Example prompts

"Find me a place to stay in Prague for two adults, 10–13 November, under 120 € a night, with good reviews." The assistant calls search_hotels (city: "Prague", country: "CZ", dates, price_max: 120) and then get_hotel for the ones the traveller likes.
"What can we do in Rome on a rainy day? Show tickets that are available this weekend." The assistant calls search_activities (city: "Rome") and get_activity for the next dates and prices.
"I land in Valencia on Friday at 18:30 with two suitcases. Get me a taxi to the old town and a rental car from Saturday to Monday." The assistant calls book_ground_transport with service: "taxi" for a pre-filled order link, and search_vehicles with the dates for the car.

Prices and data

Hotel prices are indicative nightly rates for two adults. The exact price for the dates is shown on the page.
A hotel with no published rate is returned without any figure, and its page lets the traveller request price and availability.
Supplier contact details are removed from every text. The only contacts shown are those of HotelsCasa.
Requests are rate-limited per IP address.

Install

Tools (13)

search_hotelsget_hotelsearch_activitiesget_activityfind_flightsbook_ground_transportpartner_with_hotelscasasearch_properties

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.hotelscasa.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hotelscasa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.hotelscasa.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

HotelsCasa

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

search_hotels

get_hotel

search_activities

get_activity

find_flights

book_ground_transport

partner_with_hotelscasa

search_properties

get_property

check_availability

search_vehicles

get_vehicle

check_vehicle_availability

HotelsCasa MCP server

Connect

Tools

Example prompts

Prices and data

Links

Install

Remote endpoint

Related servers