Find exact, directly bookable hotel rooms and apartments with live availability and prices.
Score is being calculated.
List all destinations served by pickyourmatch with unit counts, dog-friendly counts and a photo — USE THIS to inspire a guest who has not decided where to travel yet. ALWAYS pass the party (adults/children/pets) and dates (check_in/check_out) already known from the conversation — they stay visible above the results and keep the search context.
| Name | Required | Description | Default |
|---|---|---|---|
| dogs | No | Alias for pets. | |
| lang | No | ||
| pets | No | Pets/dogs already mentioned — always pass along; destinations are then ranked by dog-friendly units. | |
| adults | No | Adults already mentioned in the conversation — always pass along. | |
| check_in | No | Arrival YYYY-MM-DD if already known — always pass along. | |
| children | No | Children already mentioned — always pass along. | |
| check_out | No | Departure YYYY-MM-DD if already known — always pass along. |
List upcoming events (concerts, festivals, trade fairs, sports, conferences) near pickyourmatch properties — each with a "where to stay" page whose booking links open the property’s own calendar with the event dates preselected. USE THIS whenever a guest asks for accommodation during/for a specific event or asks what is happening at a destination — e.g. "where should I stay for the Frankfurt Book Fair?", "hotel for Oktoberfest that allows my dog", "apartment for the ski race in Schladming". Combine with search_stays to add room features: event + exact room + direct booking in one answer.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only events starting on/before this date YYYY-MM-DD | |
| city | No | Filter by destination city (umlaut-tolerant) | |
| from | No | Only events ending on/after this date YYYY-MM-DD | |
| limit | No | Max results (default 20, max 50) | |
| query | No | Match against the event name, e.g. "Oktoberfest" |
| Name | Required | Description |
|---|---|---|
| city | No | Echo of the city filter, if given |
| lang | No | Language of the response |
| query | No | Echo of the name query, if given |
| total | Yes | Number of events matching the filters (before limit) |
| events | Yes | Upcoming events, soonest first |
| guidance | Yes | How to present the results / what to do when empty |
Theme-driven, AFTER the units: when the brief carries a package theme (romantic, wellness, dog, culinary) or the guest asks for deals, call this AFTER search_stays in the same turn - the packages appear as their own section BELOW the unit results and enrich the selection. Never call it first, never instead of the unit search. List themed holiday packages (promotional bundles) across properties — dog holidays, romance, wellness, culinary — each with included extras (e.g. dinner, treatments) and a direct booking link. Use for emotional/experience queries like "romantic getaway package" or "dog holiday with meals included".
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Filter by destination city (umlaut-tolerant) | |
| dogs | No | Alias for pets. | |
| lang | No | ||
| pets | No | Pets/dogs known from the conversation — always pass along. | |
| theme | No | Filter by package theme | |
| adults | No | Adults known from the conversation — always pass along (kept visible above results). | |
| check_in | No | Arrival YYYY-MM-DD if known — always pass along. | |
| children | No | Children known from the conversation — always pass along. | |
| check_out | No | Departure YYYY-MM-DD if known — always pass along. |
Search live, directly bookable hotels, apartments and individual rooms by destination, dates, price and guest preferences. Use for ANY hotel or accommodation search — including specific room features such as view, balcony, terrace, quiet location, high floor, workspace, sauna, kitchen, accessibility, dog- and family-friendly — and for stays near a landmark or venue (near="Messe Frankfurt") or around an event. Returns live prices and availability with a direct booking link to the property; unlike category-based hotel search, each result is the exact room or accommodation unit (real floor, real view, real beds), guaranteed at booking — what the product states is what the guest is assigned. Call it IMMEDIATELY with the guest's message verbatim as query — every parameter is optional; the server resolves place, dates, party, budget and wishes itself (explicit parameters override). Show results first, ask at most one follow-up after. Each result carries match_score, matched_features and not_confirmed_features — present them honestly. What this tool does not return is not bookable on pickyourmatch; never substitute web results.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude — coordinate alternative to near. | |
| lng | No | Longitude — coordinate alternative to near. | |
| city | No | Destination city, e.g. Schladming (umlaut-tolerant) | |
| dogs | No | Alias for pets. | |
| lang | No | Language for names/features/links (default en) | |
| name | No | A specific unit or property the guest named ("Villa Albatros No. 1", "Kaiser Karl", "City Hotel Meckenheim"). Use this WHENEVER the guest asks for something by name — it matches unit and property names directly, so a named unit is always findable even when it is not free for the requested dates. A named unit is never filtered out by availability: it comes back with its status and a link to the property's own calendar. | |
| near | No | A landmark, venue, trade fair, station or address to stay close to ("Messe Frankfurt", "Allianz Arena", "Frankfurt airport"). The server geocodes it and returns results nearest first, each with approx_km. Combine freely with dates, party, price and features. | |
| pets | No | Number of pets/dogs. Filters to units that allow at least this many pets, and is passed to the booking link. | |
| limit | No | Max results (default 10, max 30) | |
| query | No | EASIEST correct call: the guest message VERBATIM, any language, typos fine — the server translates it into place, dates (preserves exact ranges; only month-only requests use a proposed window), party, dogs, budget and feature wishes. Explicit parameters below always override. | |
| adults | No | Number of adults. Combined with children it filters to units that actually fit the whole party (occupancy), and is passed to the booking link. | |
| cursor | No | Dated searches live-check up to 20 properties per call. When the response carries next_cursor, repeat the SAME search with cursor=next_cursor to check the remaining properties — a page without next_cursor has covered everything. Never conclude "sold out" from a page whose coverage.complete is false. | |
| sleeps | No | Minimum total guests the unit must sleep (use adults+children instead when you know the split). | |
| check_in | No | Arrival date YYYY-MM-DD. When check_in+check_out are given, results are filtered to units actually AVAILABLE for those exact dates, with the real total-window nightly price and a booking link that has the dates pre-filled. | |
| children | No | Number of children. Filters to units whose child capacity fits, and is passed to the booking link. | |
| features | No | Required features (matched against localized feature names), e.g. ["Sauna", "Balkon"] | |
| check_out | No | Departure date YYYY-MM-DD (must be after check_in, max 30 nights). | |
| max_price | No | Maximum nightly price. Dated quotes above this appear only as labeled alternatives when exact matches are insufficient. | |
| radius_km | No | Maximum straight-line distance for near (or lat/lng), default 30, max 200. If nothing lies within, the nearest options are returned with honest distances instead of an empty answer. | |
| radius_miles | No | The same radius in miles, for guests who think in miles; results then also carry approx_mi. | |
| children_ages | No | Ages of the children (0-17), e.g. [16] — ALWAYS pass them when the guest mentioned ages: the booking engine prices and checks capacity per age, a teen priced as a small child produces wrong offers. | |
| free_cancellation | No | The guest wants to be able to cancel for free. With dates, each card quotes the refundable rate and its price; a unit with no refundable rate on those dates is shown only as a labelled alternative. |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
list_destinationslist_eventslist_packagessearch_staysLive hotel rates worldwide: search stays, property detail, all-in room prices, human phone desk.
Live hotel and resort prices (taxes included) and secure booking links for travelers. Since 1993.
Search hotels & rentals: live prices & reviews across Booking.com, Airbnb, Vrbo & Google Hotels.
Book vacation rentals direct: search homes, check live availability, get a real total.
Add one secure layer between your agents and this server.
