此 MCP 可以做什么
Searches and provides booking links for hotels, private homes, activities, flights, rental cars, taxis, and other travel-related services, with availability checks for selected inventory.
功能
工具
13
工具
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.
只读
幂等
输入模式
{'type': 'object', 'required': ['service'], 'properties': {'city': {'type': 'string', 'description': 'City (taxi and car rental).'}, '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.'}, 'when': {'type': 'string', 'description': 'Taxi pickup time, ISO 8601 (YYYY-MM-DDTHH:MM). Omit for now.'}, 'origin': {'type': 'string', 'description': 'Taxi pickup address or place.'}, 'luggage': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'service': {'enum': ['taxi', 'shipment', 'car_rental'], 'type': 'string'}, 'passengers': {'type': 'integer', 'maximum': 8, 'minimum': 1}, 'destination': {'type': 'string', 'description': 'Taxi destination address or place.'}, 'pickup_date': {'type': 'string', 'description': 'Car rental pickup date YYYY-MM-DD.'}, 'return_date': {'type': 'string', 'description': 'Car rental return date YYYY-MM-DD.'}, 'shipment_scope': {'enum': ['city', 'country', 'international'], 'type': 'string', 'description': 'Shipment distance: same city, within the country, or abroad.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'tip': {'type': 'string'}, 'url': {'type': 'string'}, 'service': {'type': 'string'}, 'how_it_works': {'type': 'string'}, 'business_account': {'type': 'string'}}, 'additionalProperties': True}
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 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.
只读
幂等
输入模式
{'type': 'object', 'required': ['items'], 'properties': {'lang': {'type': 'string', 'description': 'Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['property_key'], 'properties': {'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'property_key': {'type': 'integer', 'description': 'The property_key from search_properties results.'}}, 'additionalProperties': False}, 'maxItems': 10}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'error': {'type': 'string'}, 'locale': {'type': 'string'}, 'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'rooms': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'available': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'booking_link': {'type': 'string'}, 'booking_mode': {'type': 'string'}, 'property_key': {'type': 'integer'}, 'price_breakdown': {'anyOf': [{'type': 'object', 'properties': {}, 'additionalProperties': True}, {'type': 'null'}]}}, 'additionalProperties': True}}}, 'additionalProperties': True}
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: 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.
只读
幂等
输入模式
{'type': 'object', 'required': ['vehicle_ids', 'pickup_date', 'return_date'], 'properties': {'pickup_date': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'return_date': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'vehicle_ids': {'type': 'array', 'items': {'type': 'integer'}, 'maxItems': 10}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'days': {'type': 'integer'}, 'available': {'type': 'boolean'}, 'price_day': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_eur': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'vehicle_id': {'type': 'integer'}}, 'additionalProperties': True}}, 'message': {'type': 'string'}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'lang': {'type': 'string', 'description': 'Language of the page: es, en, de, fr, it, pt, tr, ru, pl, no or sv. Default es.'}, 'destination': {'type': 'string', 'description': 'Destination city or IATA code, e.g. Rome, LIS, Buenos Aires.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'iata': {'type': 'string'}, 'note': {'type': 'string'}, 'live_fares': {'type': 'boolean'}, 'destination': {'type': 'string'}, 'search_page': {'type': 'string'}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'required': ['activity_key'], 'properties': {'lang': {'type': 'string', 'description': 'Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'activity_key': {'type': 'string', 'description': 'activity_key returned by search_activities.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'error': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'message': {'type': 'string'}, 'summary': {'type': 'string'}, 'activity': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'city': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'type': 'string'}, 'tagline': {'type': 'string'}, 'rating_5': {'type': 'number'}, 'sold_out': {'type': 'boolean'}, 'photo_url': {'type': 'string'}, 'activity_key': {'type': 'string'}, 'reviews_count': {'type': 'integer'}, 'price_from_eur': {'type': 'number'}}, 'additionalProperties': True}, 'duration': {'type': 'string'}, 'included': {'type': 'string'}, 'next_dates': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'description': {'type': 'string'}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'required': ['hotel_key'], 'properties': {'lang': {'type': 'string', 'description': 'Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'adults': {'type': 'integer', 'maximum': 8, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'children': {'type': 'integer', 'maximum': 4, 'minimum': 0}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'hotel_key': {'type': 'string', 'description': 'hotel_key returned by search_hotels.'}, 'nationality': {'type': 'string', 'description': 'Guest nationality, ISO-3166 alpha-2.'}, 'children_ages': {'type': 'string', 'description': 'Ages of the children, comma separated, e.g. "4,9".'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'error': {'type': 'string'}, 'hotel': {'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'url': {'type': 'string'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'stars': {'type': 'integer'}, 'country': {'type': 'string'}, 'hotel_key': {'type': 'string'}, 'photo_url': {'type': 'string'}, 'rating_10': {'type': 'number'}, 'price_note': {'type': 'string'}, 'distance_km': {'type': 'number'}, 'reviews_count': {'type': 'integer'}, 'price_from_eur_per_night': {'type': 'number'}}, 'additionalProperties': True}, 'nearby': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'address': {'type': 'string'}, 'message': {'type': 'string'}, 'city_url': {'type': 'string'}, 'amenities': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}}, 'additionalProperties': True}
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 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.
只读
幂等
输入模式
{'type': 'object', 'required': ['property_key'], 'properties': {'lang': {'type': 'string', 'description': 'Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'property_key': {'type': 'integer', 'description': 'The property_key returned by search_properties.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'error': {'type': 'string'}, 'rooms': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'message': {'type': 'string'}, 'reviews': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'bedrooms': {'type': 'integer'}, 'amenities': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'available': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'bathrooms': {'type': 'integer'}, 'max_guests': {'type': 'integer'}, 'price_from': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price_note': {'type': 'string'}, 'description': {'type': 'string'}, 'price_total': {'type': 'number'}, 'short_pitch': {'type': 'string'}, 'booking_link': {'type': 'string'}, 'booking_mode': {'type': 'string'}, 'cancellation': {'type': 'string'}, 'property_key': {'type': 'integer'}, 'property_type': {'type': 'string'}, 'reviews_count': {'type': 'integer'}, 'text_language': {'type': 'string'}, 'thumbnail_url': {'type': 'string'}}, 'additionalProperties': True}
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: 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.
只读
幂等
输入模式
{'type': 'object', 'required': ['vehicle_id'], 'properties': {'lang': {'type': 'string', 'description': 'Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.'}, '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.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'city': {'type': 'string'}, 'days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'fuel': {'type': 'string'}, 'make': {'type': 'string'}, 'name': {'type': 'string'}, 'class': {'type': 'string'}, 'error': {'type': 'string'}, 'model': {'type': 'string'}, 'seats': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'country': {'type': 'string'}, 'instant': {'type': 'boolean'}, 'message': {'type': 'string'}, 'available': {'type': 'boolean'}, 'price_day': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_eur': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'conditions': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'price_note': {'type': 'string'}, 'vehicle_id': {'type': 'integer'}, 'busy_ranges': {'type': 'array', 'items': {'type': 'object', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}}, 'additionalProperties': True}}, 'description': {'type': 'string'}, 'booking_link': {'type': 'string'}, 'transmission': {'type': 'string'}, 'thumbnail_url': {'type': 'string'}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'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.'}, 'profile': {'enum': ['taxi_fleet', 'taxi_driver', 'van_carrier', 'truck_carrier', 'shipping_company', 'car_rental', 'property_owner', 'all'], 'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'who': {'type': 'string'}, 'more': {'type': 'string'}, 'offer': {'type': 'string'}, 'profile': {'type': 'string'}, 'profiles': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'all_programmes': {'type': 'string'}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'City name in any language, e.g. Istanbul, Стамбул, Rome, Roma.'}, 'lang': {'type': 'string', 'description': 'Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'page': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'sort': {'enum': ['popular', 'price'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results to return (1-10, default 10).'}, 'query': {'type': 'string', 'description': 'Text in the title, e.g. Sagrada Familia, Colosseum.'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2, e.g. TR, IT, BR. Can be combined with city.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'page': {'type': 'integer'}, 'count': {'type': 'integer'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'city': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'type': 'string'}, 'tagline': {'type': 'string'}, 'rating_5': {'type': 'number'}, 'sold_out': {'type': 'boolean'}, 'photo_url': {'type': 'string'}, 'activity_key': {'type': 'string'}, 'reviews_count': {'type': 'integer'}, 'price_from_eur': {'type': 'number'}}, 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'cities': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'message': {'type': 'string'}, 'next_page': {'type': 'integer'}, 'matched_cities': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}}, 'additionalProperties': True}
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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'city': {'type': 'string', 'description': 'City name in English, e.g. Rome, Lisbon, Munich, Buenos Aires.'}, 'lang': {'type': 'string', 'description': 'Language of the answer and of the links: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'page': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'sort': {'enum': ['recommended', 'price', 'rating'], 'type': 'string'}, 'type': {'enum': ['apartamentos', 'apartahoteles', 'casas-de-huespedes', 'casas-de-vacaciones', 'casas-rurales', 'villas'], 'type': 'string', 'description': 'Accommodation type: apartments, aparthotels, guest houses, holiday homes, rural houses, villas.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results to return (1-10, default 10).'}, 'query': {'type': 'string', 'description': 'Part of the hotel name (with city or lat/lng), or a city name.'}, 'rooms': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'How many rooms for the same stay (default 1).'}, 'adults': {'type': 'integer', 'maximum': 8, 'minimum': 1}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2 country code, e.g. FR, IT, AR.'}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'children': {'type': 'integer', 'maximum': 4, 'minimum': 0}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'price_max': {'type': 'number', 'description': 'Max EUR per night. With dates it is applied to the live price for those dates; without dates, to the catalogue price.'}, 'price_min': {'type': 'number', 'description': 'Min EUR per night. Same rule as price_max.'}, 'radius_km': {'type': 'number', 'description': 'Radius for lat/lng search, default 10, max 50.'}, 'stars_min': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'nationality': {'type': 'string', 'description': 'Guest nationality, ISO-3166 alpha-2. Affects the rate; taken from the traveller IP when omitted.'}, 'children_ages': {'type': 'string', 'description': 'Ages of the children, comma separated, e.g. "4,9". The supplier prices a child by age; without this, 8 years is assumed.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'city': {'type': 'object', 'properties': {}, 'additionalProperties': True}, 'page': {'type': 'integer'}, 'count': {'type': 'integer'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'url': {'type': 'string'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'stars': {'type': 'integer'}, 'country': {'type': 'string'}, 'hotel_key': {'type': 'string'}, 'photo_url': {'type': 'string'}, 'rating_10': {'type': 'number'}, 'price_note': {'type': 'string'}, 'distance_km': {'type': 'number'}, 'reviews_count': {'type': 'integer'}, 'price_from_eur_per_night': {'type': 'number'}}, 'additionalProperties': True}}, 'cities': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'message': {'type': 'string'}, 'next_page': {'type': 'integer'}}, 'additionalProperties': True}
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 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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'lat': {'type': 'number', 'description': 'Latitude for radius search.'}, 'lng': {'type': 'number', 'description': 'Longitude for radius search.'}, 'city': {'type': 'string'}, 'lang': {'type': 'string', 'description': 'Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results to return (1-10, default 10).'}, 'query': {'type': 'string', 'description': 'Free text (name or city).'}, 'guests': {'type': 'integer', 'maximum': 16, 'minimum': 1}, 'region': {'type': 'string', 'description': 'Province/region.'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2, e.g. ES.'}, 'bedrooms': {'type': 'integer', 'minimum': 0}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'bathrooms': {'type': 'integer', 'minimum': 0}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'price_max': {'type': 'number', 'description': 'EUR/night. Same rule as price_min.'}, 'price_min': {'type': 'number', 'description': 'EUR/night. Only constrains objects that publish a rate; on_request objects are always kept.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km (default 15, max 100).'}, 'page_token': {'type': 'string', 'description': 'Opaque token from a previous page.'}, 'property_type': {'enum': ['entire_home', 'private_room'], 'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'page': {'type': 'integer'}, 'count': {'type': 'integer'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'rooms': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': True}}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'bedrooms': {'type': 'integer'}, 'bathrooms': {'type': 'integer'}, 'max_guests': {'type': 'integer'}, 'price_from': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price_note': {'type': 'string'}, 'price_total': {'type': 'number'}, 'short_pitch': {'type': 'string'}, 'booking_link': {'type': 'string'}, 'booking_mode': {'type': 'string'}, 'property_key': {'type': 'integer'}, 'property_type': {'type': 'string'}, 'reviews_count': {'type': 'integer'}, 'text_language': {'type': 'string'}, 'thumbnail_url': {'type': 'string'}}, 'additionalProperties': True}}, 'locale': {'type': 'string'}, 'message': {'type': 'string'}, 'next_page_token': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': True}
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: 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.
只读
幂等
输入模式
{'type': 'object', 'properties': {'lat': {'type': 'number', 'description': 'Latitude for radius search.'}, 'lng': {'type': 'number', 'description': 'Longitude for radius search.'}, 'city': {'type': 'string'}, 'lang': {'type': 'string', 'description': 'Language of the answer: es, en, de, fr, it, pt, tr or ru. Default es.'}, 'class': {'type': 'string', 'description': 'Vehicle category slug (economy, suv, van…).'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results to return (1-10, default 10).'}, 'query': {'type': 'string', 'description': 'Free text: make, model or city.'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2, e.g. ES.'}, 'price_max': {'type': 'number', 'description': 'EUR/day. Same rule as price_min.'}, 'price_min': {'type': 'number', 'description': 'EUR/day. Cars without a published rate are always kept.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km (default 15, max 100).'}, 'seats_min': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'page_token': {'type': 'string', 'description': 'Opaque token from a previous page.'}, 'pickup_date': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'return_date': {'type': 'string', 'description': 'YYYY-MM-DD.'}, 'transmission': {'type': 'string', 'description': "'manual' or 'automatic'."}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'page': {'type': 'integer'}, 'count': {'type': 'integer'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'fuel': {'type': 'string'}, 'make': {'type': 'string'}, 'name': {'type': 'string'}, 'class': {'type': 'string'}, 'model': {'type': 'string'}, 'seats': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'country': {'type': 'string'}, 'instant': {'type': 'boolean'}, 'available': {'type': 'boolean'}, 'price_day': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_eur': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price_note': {'type': 'string'}, 'vehicle_id': {'type': 'integer'}, 'booking_link': {'type': 'string'}, 'transmission': {'type': 'string'}, 'thumbnail_url': {'type': 'string'}}, 'additionalProperties': True}}, 'message': {'type': 'string'}, 'next_page_token': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': True}
历史
近期工具变更
已更改
search_activities
2026年10月2日 02:41
已更改
get_hotel
2026年9月24日 02:40
已更改
search_hotels
2026年9月24日 02:40
已添加
check_vehicle_availability
2026年9月20日 02:40
已添加
get_vehicle
2026年9月20日 02:40
已添加
search_vehicles
2026年9月20日 02:40
已添加
check_availability
2026年9月20日 02:40
已添加
get_property
2026年9月20日 02:40
已添加
search_properties
2026年9月20日 02:40
已添加
partner_with_hotelscasa
2026年9月20日 02:40
已添加
book_ground_transport
2026年9月20日 02:40
已添加
find_flights
2026年9月20日 02:40
已添加
get_activity
2026年9月20日 02:40
已添加
search_activities
2026年9月20日 02:40
已添加
get_hotel
2026年9月20日 02:40
已添加
search_hotels
2026年9月20日 02:40
发现
类似的 MCP 服务器
Itaim Bibi
io.github.junoventures/itaimbibi-sampa-br
Provides an Itaim Bibi neighborhood directory with local place search, menus, events, offers, services, bookings, reservations, t…
Tatuapé
io.github.junoventures/tatuape-sampa-br
Provides a Tatuapé neighborhood directory with local place search, menus, events, offers, services, bookings, reservations, ticke…
Agenda SP
io.github.junoventures/agenda-sampa-br
Provides São Paulo cultural agenda and local directory features, including events, venues, restaurants, offers, bookings, reserva…
Vila Buarque
io.github.junoventures/vilabuarque-sampa-br
Provides a neighborhood directory for local places, restaurants, menus, events, offers, services, reservations, bookings, and pur…
Centro
io.github.junoventures/centro-sampa-br
Provides a Centro neighborhood directory with local place search, menus, events, offers, services, bookings, reservations, ticket…
Bela Vista
io.github.junoventures/belavista-sampa-br
Provides a Bela Vista neighborhood directory with local place search, menus, events, offers, services, bookings, reservations, ti…
Jardins
io.github.junoventures/jardins-sampa-br
Provides a Jardins neighborhood directory with local place search, menus, events, offers, services, bookings, reservations, ticke…
Aclimação
io.github.junoventures/aclimacao-sampa-br
Provides a neighborhood directory for Aclimação with local places, restaurant menus, events, offers, services, bookings, reservat…