TripWays
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Find, price, and book tours, day trips, and activities worldwide, with live dates and prices.
| Author | com.tripways |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 182 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"TripWays": {
"url": "https://mcp.tripways.com/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (12)
search_toursread-onlySearch the TripWays catalog of bookable tours, day trips, and activities worldwide. Pass a natural-language query plus any filters you already know: destination, price range in USD, duration in hours, activity, theme, or cancellation policy. Returns ranked tours with bokun_id, title, from-price, duration, destinations, rating, cancellation policy, hero_image, the TripWays page (url), and checkout_url. For live dates, remaining seats, or a group total, use check_availability and get_price_quote.
Parameters:
query(required) — string — Natural-language search, e.g. 'family food tour in Rome under $100'.limit— integertheme— stringactivity— string — Activity facet, e.g. food, hiking, snorkeling.price_max— numberprice_min— numberdestination— string — Place name (city, region, country, or well-known area/landmark). Resolved against TripWays destinations; a landmark that is not a destination is added to the search text.cancellation— stringduration_hours_max— numberduration_hours_min— number
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_tour_detailsread-onlyGet the full details of one TripWays tour by bokun_id (the number in tripways.com/t/{id}): summary, itinerary stops, inclusions and exclusions, languages, cancellation policy, meeting point or pickup, from-price, rating, hero_image, url, and checkout_url. Live dates and group totals come from check_availability and get_price_quote.
Parameters:
bokun_id(required) — string
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_destination_inforead-onlyResolve a place name (a city, region, country, or well-known area such as Khao Sok) to a TripWays destination with bookable tours. Useful before search_tours when a name could mean more than one place. An ambiguous name returns destination_ambiguous with a did_you_mean list; pass country_code (ISO 3166-1 alpha-2, e.g. FR) to choose one. Area names resolve to their parent destination and include resolved_via=area_alias.
Parameters:
query(required) — stringcountry_code— string — Optional ISO2 pin, e.g. FR.
Hints: read-only yes · destructive no · idempotent yes · open-world no
check_availabilityread-onlyCheck live start times and remaining seats for a TripWays tour on one date or a range of up to 31 days. Pass party_size (seats needed) or a travelers object; slots that cannot fit the group are left out, and party_size wins if both are given. The status field is ok, no_schedule, no_fit, or calendar_gone. Use get_price_quote with the same date, start time, and travelers for the total.
Parameters:
bokun_id(required) — stringdate(required) — stringdate_end— string — Inclusive end; default = date. Max 31 days.travelers— object — Simple ages; mapped to occupied seats (infants excluded unless the tour has an infant category). Used only when party_size is omitted.party_size— integer — Occupied seats to keep (not ticket count). Slots with availabilityCount < party_size are omitted unless unlimited. Wins over travelers when both are set.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
get_price_quoteread-onlyGet the live total for a TripWays tour on one date and start time for a traveler mix, priced from the operator's booking calendar. A quote does not hold seats or charge anything. Optional extras and promo codes are not included. When the tour's rates cannot price that mix, the result is unpriced.
Parameters:
bokun_id(required) — stringdate(required) — stringtravelers— object — Simple ages; mapped to Bokun pricing categories.start_time— string — HH:MM if start_time_id unknown.start_time_id— integer
Hints: read-only yes · destructive no · idempotent yes · open-world yes
get_booking_linkread-onlyGet the TripWays checkout link for a tour, optionally preset to a date, start time, rate, and traveler mix. The traveler pays on tripways.com; this tool does not hold seats or take payment. bookable_natively and reason say whether the link opens TripWays checkout or the operator's calendar, and whether a hotel pickup must be chosen at checkout.
Parameters:
bokun_id(required) — stringdate— stringrate_id— integertravelers— object — Simple ages; mapped to Bokun pricing categories.start_time— string — HH:MM if start_time_id unknown.start_time_id— integer
Hints: read-only yes · destructive no · idempotent yes · open-world yes
compare_toursread-onlyCompare 2 to 4 TripWays tours side by side by bokun_id: from-price, duration, rating, cancellation type, hotel pickup, languages, inclusions, and exclusions. The result also names the tour with the lowest from-price, the shortest duration, the best rating (10+ reviews), and which have free cancellation. Ids that are not bookable tours come back in not_found. For group totals on a date, use check_availability and get_price_quote.
Parameters:
bokun_ids(required) — array — Two to four tour ids (the number in tripways.com/t/{id}).
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_tour_reviewsread-onlyGet the rating summary and written reviews for one TripWays tour by bokun_id. Written reviews come from travelers who booked on TripWays and carry first name, country, date, star rating, and text; the overall rating can also include ratings from other platforms. limit sets how many written reviews to return (1 to 10, default 5, newest first).
Parameters:
bokun_id(required) — stringlimit— integer
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_cancellation_policyread-onlyGet the cancellation terms stored for one TripWays tour by bokun_id: the type (free, flexible, partial, or non_refundable), the refund percent and cutoff when the tour has them, and the operator's policy text. These are the tour's terms, not a quote for a specific booking.
Parameters:
bokun_id(required) — string
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_meeting_pointread-onlyGet where one TripWays tour starts, by bokun_id: the operator's meeting point text, whether hotel pickup is available, and the operator's know-before-you-go notes and what to bring. Fields the operator has not filled in are left out, with a note when nothing is stored.
Parameters:
bokun_id(required) — string
Hints: read-only yes · destructive no · idempotent yes · open-world no
find_alternativesread-onlyFind tours similar to one TripWays tour that have open start times on a date, or a date range of up to 31 days, for a group. Pass the tour the traveler wanted (bokun_id), the date, and party_size or travelers. Returns up to limit similar tours (1 to 5, default 3), each with its card and up to three open start times with seats left, plus the original tour's own status for those dates. It reads several live calendars, so it can take a few seconds.
Parameters:
bokun_id(required) — stringdate(required) — stringlimit— integerdate_end— string — Inclusive end; default = date. Max 31 days.travelers— object — Simple ages; mapped to occupied seats. Used only when party_size is omitted.party_size— integer — Occupied seats to keep. Wins over travelers when both are set.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
get_itinerary_ideasread-onlySuggest a day-by-day plan of bookable TripWays tours for a destination. Pass destination, days (1 to 7, default 3), and optional interests such as food, history, or boat trips. Each day holds one full-day tour or a morning and afternoon pair, with from-prices and links; multi-day tours are listed apart. These are suggestions only: dates, seats, and group totals are not checked.
Parameters:
destination(required) — string — City, region, or country, e.g. 'Rome' or 'Phuket'.days— integerinterests— string — Optional, e.g. 'food and history'.
Hints: read-only yes · destructive no · idempotent yes · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.