About HotelsCasa
HotelsCasa is a remote travel-catalog MCP server for travelers, covering stays, owner-listed homes and cars, activities, and transport or flight links. Results point to HotelsCasa pages for exact prices and booking; the server itself is read-only.
Key features
- 01Search hotels, apartments, and holiday homes
- 02Check owner-listed homes and date prices
- 03Search activities, tickets, and tours
- 04Check owner-listed cars and availability
- 05Get flight, taxi, and car-rental links
Use cases
- 01Find stays by city, dates, and budget
- 02Compare date availability for homes or cars
- 03Find destination activities and available dates
- 04Get links for taxi transfers or car rental
MCP support
It provides 13 read-only travel search tools to MCP clients over Streamable HTTP, with no authentication. Bookings take place on the returned HotelsCasa pages.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.hotelscasa.com/mcpclaude mcp add --transport http com-hotelscasa-hotelscasa https://mcp.hotelscasa.com/mcp{"mcpServers":{"com-hotelscasa-hotelscasa":{"type":"http","url":"https://mcp.hotelscasa.com/mcp"}}}Open in Cursor{"servers":{"com-hotelscasa-hotelscasa":{"type":"http","url":"https://mcp.hotelscasa.com/mcp"}}}Open in VS Code{"mcpServers":{"com-hotelscasa-hotelscasa":{"type":"http","url":"https://mcp.hotelscasa.com/mcp"}}}{"mcpServers":{"com-hotelscasa-hotelscasa":{"serverUrl":"https://mcp.hotelscasa.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
13| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | No | |
| lng | number | No | |
| city | string | No | City name in English, e.g. Rome, Lisbon, Munich, Buenos Aires. |
| lang | string | No | Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es. |
| page | integer | No | |
| sort | enum | No | recommended | price | rating |
| type | enum | No | Accommodation type: apartments, aparthotels, guest houses, holiday homes, rural houses, villas.apartamentos | apartahoteles | casas-de-huespedes | casas-de-vacaciones | casas-rurales | villas |
| limit | integer | No | How many results to return (1-10, default 10). |
| query | string | No | Part of the hotel name (with city or lat/lng), or a city name. |
| rooms | integer | No | How many rooms for the same stay (default 1). |
| adults | integer | No | |
| country | string | No | ISO-3166 alpha-2 country code, e.g. FR, IT, AR. |
| check_in | string | No | YYYY-MM-DD. |
| children | integer | No | |
| check_out | string | No | YYYY-MM-DD. |
| price_max | number | No | Max EUR per night. With dates it is applied to the live price for those dates; without dates, to the catalogue price. |
| price_min | number | No | Min EUR per night. Same rule as price_max. |
| radius_km | number | No | Radius for lat/lng search, default 10, max 50. |
| stars_min | integer | No | |
| nationality | string | No | Guest nationality, ISO-3166 alpha-2. Affects the rate; taken from the traveller IP when omitted. |
| children_ages | string | No | Ages of the children, comma separated, e.g. "4,9". The supplier prices a child by age; without this, 8 years is assumed. |
Details
From the project READMEHotelsCasa 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(thelangargument 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):
{
"mcpServers": {
"hotelscasa": {
"url": "https://mcp.hotelscasa.com/mcp"
}
}
}
Clients that only speak stdio:
{
"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 thenget_hotelfor 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") andget_activityfor 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_transportwithservice: "taxi"for a pre-filled order link, andsearch_vehicleswith 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
- Website: https://hotelscasa.com/
- Server card: https://hotelscasa.com/.well-known/mcp/server-card.json
- For AI agents: https://hotelscasa.com/llms.txt
- Privacy policy: https://hotelscasa.com/politica-de-privacidad/
- Contact: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.