HotelsCasa

com.hotelscasaPublished by hotelscasa.comOfficial publisherv2.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

HotelsCasa is a public, read-only travel search server that lets an assistant find hotels, owner-listed homes, tours, rental cars and transport links across 77+

What you can do
Search and read hotel and apartment listings by city or coordinates, with indicative prices, filters and full details for one hotel, including live availability when dates are given.
When to use it
When a traveller wants help finding accommodation, tours, rental cars or transport links in Europe, Turkey, Russia and Ukraine, the Caucasus, Central Asia or Latin America, and will book on the HotelsCasa page.
Requirements
A remote Streamable HTTP endpoint; no installation, account, API key or header is needed. Network access to the HotelsCasa endpoint is required.
Before you install
All tools are read-only and nothing is booked, ordered or sent by them; booking happens on the returned hotelscasa.com page. Hotel prices are indicative nightly rates, not the exact price for the dates. Requests are rate-limited per IP address.

Installation

In SourceWeft

  1. Open HotelsCasa in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.hotelscasa%2Fhotelscasa-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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:

sh
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.

ToolWhat it does
search_hotelsHotels, 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_hotelOne hotel in full: description, amenities, photos, check-in times, places nearby.
search_activitiesTickets, tours and attractions by city, country or free text.
get_activityOne activity with what is included, duration and the next available dates with prices.
find_flightsThe 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_transportThe 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_hotelscasaFor 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_propertiesHomes listed directly by private owners, with booking mode, price and booking link.
get_propertyOne owner-listed home in full, with rooms, conditions and cancellation policy.
check_availabilityAvailability and total price of up to 10 owner-listed homes for given dates.
search_vehiclesCars listed by their owners, by city, dates, seats and transmission.
get_vehicleOne car in full: specs, rental conditions, deposit, busy dates.
check_vehicle_availabilityAvailability 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

  1. "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.

  2. "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.

  3. "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.

Links

Source: README.md at commit 0cfc102

Tools

13

search_hotels

Search hotels

Search hotels on HotelsCasa: hotels, apartments, guest houses and holiday homes that can actually be booked, in 77 countries — Europe, Turkey, Russia and Ukraine, the Caucasus, Central Asia, and the whole of Latin America including Mexico, Central America and the Caribbean. 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 and the url of the hotel page. WITH DATES (check_in + check_out): availability is checked LIVE with the supplier before answering. Every item returned has a room actually free for those dates, and carries available:true, price_eur_per_night, price_total_eur, nights, board and refundable. Show price_total_eur for the stay together with the nightly rate, and say the price was checked for those dates. An empty list with availability_checked:true means there really is nothing free for those dates — say so and offer other dates or a wider radius. If availability_checked is false, the supplier did not answer: the prices are catalogue prices for OTHER dates — never present them as a confirmation. WITHOUT DATES: price_from_eur_per_night is an indicative starting price per night; show it as "from EUR X per night" and confirm on the page. Pass check_in/check_out/adults (and children_ages when children travel) to get real, bookable prices. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameterslatlngcitylangpagesorttypelimitqueryroomsadultscountry+9 more

get_hotel

Hotel details

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. With check_in/check_out it also checks availability live and returns an `availability` block: available true/false for those dates, with the real price when a room is free. availability.checked false means the supplier did not answer — the price is a catalogue price for other dates, not a confirmation. Always give the traveller the url of every item as a clickable link, unchanged: it is the only way to book or buy.

Parameterslangadultscheck_inchildrencheck_outhotel_keyrequirednationalitychildren_ages

search_activities

Search tickets and tours

Search tickets, tours and attractions (museums, monuments, day trips) sold on HotelsCasa with our partner Tiqets. Search by city (its name in any language works: Istanbul, İstanbul, Estambul, Стамбул), by ISO country code or by text. With no arguments returns the cities with the most activities. The answer carries `total` (how many activities match in all), `count` (how many are on this page, 10 at most) and `matched_cities` when a city was recognised. 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.

Parameterscitylangpagesortlimitquerycountry

get_activity

Activity details

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.

Parameterslangactivity_keyrequired

find_flights

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.

Parameterslangdestination

book_ground_transport

Taxi, shipments and car rental

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.

Parameterscitylangwhenoriginluggageservicerequiredpassengersdestinationpickup_datereturn_dateshipment_scope

partner_with_hotelscasa

Work 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.

Parameterslangprofile

search_properties

Search homes from owners

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 accomm

Parameterslatlngcitylanglimitqueryguestsregioncountrybedroomscheck_inbathrooms+6 more

get_property

Home details

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 i

Parameterslangguestscheck_incheck_outproperty_keyrequired

check_availability

Check home 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 ful

Parameterslangitemsrequired

search_vehicles

Search rental cars

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: cars from local rental companies (offered_by:"rental_company") and from private owners. Cars marked instant:true are confirmed immediately; the rest are confirmed after booking by the rental company or by the owner, who replies personally. A rental-company car with similar_model:true guarantees the class, not the exact model. 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. 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.

Parameterslatlngcitylangclasslimitquerycountryprice_maxprice_minradius_kmseats_min+4 more

get_vehicle

Car details

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: cars from local rental companies (offered_by:"rental_company") and from private owners. Cars marked instant:true are confirmed immediately; the rest are confirmed after booking by the rental company or by the owner, who replies personally. A rental-company car with similar_model:true guarantees the class, not the exact model. 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. 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.

Parameterslangvehicle_idrequiredpickup_datereturn_date

check_vehicle_availability

Check car 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: cars from local rental companies (offered_by:"rental_company") and from private owners. Cars marked instant:true are confirmed immediately; the rest are confirmed after booking by the rental company or by the owner, who replies personally. A rental-company car with similar_model:true guarantees the class, not the exact model. 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. 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.

Parameterspickup_daterequiredreturn_daterequiredvehicle_idsrequired

Version history

1
  1. v2.0.0LatestSep 19, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.