Boat Trips Club MCP server
Read-only tools to find Boat Trips Club boat tours and hand travellers a booking link.
| Endpoint | https://mcp.boattripsclub.com/mcp |
| Transport | Streamable HTTP (JSON-RPC 2.0 over HTTPS POST) |
| Sign-in | None. All tools are read-only. |
| Limits | 300 requests per minute per IP; search returns at most 5 tours. |
Booking
An instant tour is booked and paid on our website. A request tour is sent as a booking request without payment; our team confirms it with the operator, and the traveller pays only after confirmation. No tool checks or promises availability.
search_tours
Search Boat Trips Club's live catalog of boat tours (catamarans, yachts, snorkeling, sunset cruises, private charters) by destination, group size and what the traveller wants. Returns at most 5 tours, each with its public details: price from (per boat or per person), duration, maximum guests, free-cancellation hours, what's included and booking_mode. booking_mode "instant": the traveller books and pays on our website, and the booking is confirmed once paid. booking_mode "request": the traveller sends a booking request without paying, our team confirms it with the operator, and the traveller pays only after confirmation. The date is not an availability check. Never tell the traveller that a date is available, or that a tour is booked or confirmed: no tool here checks availability for any tour. Availability is confirmed only on the Boat Trips Club website or by our team. To book, call get_booking_link.
| Parameter | Type | About |
|---|---|---|
destination | string, optional | Where, e.g. "Punta Cana", "Los Cabos", "Dubai", "Mexico". |
date | string, optional | Trip date, YYYY-MM-DD. |
guests | integer, optional | Number of guests: only tours that take this many are returned. |
query | string, optional | What they want, e.g. "private sunset catamaran with open bar". |
Returns: tours (up to 5): tour_id, title, destination, url, photo, price_from, currency, price_unit, duration_hours, max_guests, free_cancellation_hours, included, booking_mode
get_tour
One tour's public details, by the tour_id from search_tours. booking_mode "instant": the traveller books and pays on our website, and the booking is confirmed once paid. booking_mode "request": the traveller sends a booking request without paying, our team confirms it with the operator, and the traveller pays only after confirmation. Never tell the traveller that a date is available, or that a tour is booked or confirmed: no tool here checks availability for any tour. Availability is confirmed only on the Boat Trips Club website or by our team.
| Parameter | Type | About |
|---|---|---|
tour_id | string | tour_id from search_tours. |
Returns: tour_id, title, destination, url, photo, price_from, currency, price_unit, duration_hours, max_guests, free_cancellation_hours, included, booking_mode
get_booking_link
The link where the traveller books this tour on the Boat Trips Club website, with the date and group size prefilled. Every call returns a new agent_ref: keep it to check the booking's status later with get_booking_status. next_step says what the traveller does on the page: "pay_on_our_checkout" (an instant tour: the booking is confirmed once paid on our website) or "send_request_no_payment" (a request tour: the traveller sends a request without paying, our team confirms it with the operator, and the traveller pays only after confirmation). The link does not hold or reserve a date. Never tell the traveller that a date is available, or that a tour is booked or confirmed: no tool here checks availability for any tour. Availability is confirmed only on the Boat Trips Club website or by our team.
| Parameter | Type | About |
|---|---|---|
tour_id | string | tour_id from search_tours. |
date | string, optional | Trip date, YYYY-MM-DD. |
guests | integer, optional | Number of guests. |
Returns: url, booking_mode, next_step, agent_ref
get_booking_status
The status of a booking or booking request made through a link from get_booking_link, by that link's agent_ref. Returns only status, booking_code, tour_title and trip_date. Status: requested = request received, our team confirms with the operator, and the traveller pays only after confirmation; confirmed_unpaid = confirmed, payment still open; confirmed = booked and paid; cancelled; expired; not_found = no booking or request made through that link, or an unknown agent_ref. Say "booked" only for confirmed, and "confirmed" only for confirmed or confirmed_unpaid. Never claim a date is available for any tour.
| Parameter | Type | About |
|---|---|---|
agent_ref | string | agent_ref from get_booking_link. |
Returns: status, booking_code, tour_title, trip_date