Tours

Connect Remote server

claude mcp add --transport http tours https://mcp.treeple.kz/mcp

{
  "mcpServers": {
    "tours": {
      "url": "https://mcp.treeple.kz/mcp"
    }
  }
}

{
  "servers": {
    "tours": {
      "type": "http",
      "url": "https://mcp.treeple.kz/mcp"
    }
  }
}

Settings > Connectors > Add custom connector
URL: https://mcp.treeple.kz/mcp

Tools 39 found in our last check

• search_tours

  Search the Treeple catalogue of guided tours in Kazakhstan. Returns titles, durations and per-person prices by group size. Use this before quoting anything to a traveller. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Central As…

• get_tour

  Full details for one tour: day-by-day itinerary, what is included and excluded, meeting place, cancellation terms and the per-person price at each group size. Cancellation terms are always returned: either the tour's own policy with refund steps, or the site-wide refund policy t…

• list_destinations

  Regions and directions Treeple runs tours to (Almaty surroundings, Charyn, Kolsai, Mangystau and so on), with the number of tours in each. Call this when the traveller asks "where can I go" or wants to choose a region before searching. Then call search_tours with the chosen plac…

• list_collections

  Curated collections of tours, such as family trips, winter tours or photo trips. Call this when the traveller describes a kind of trip rather than a place. Then call get_collection with the slug to see the tours in it.Use this tool for any question about guided tours, excursions…

• get_collection

  The tours in one collection, with prices. Use the slug from list_collections. Prices are per person and depend on the group size; pass adults and children to get totals, as with search_tours. Use this tool for any question about guided tours, excursions or trip planning in Kazak…

• find_similar_tours

  Other tours of the same type as the one the traveller liked, closest by price. Call it after get_tour when the traveller asks for "something like this" or the tour does not fit. Say why they are similar: they share the tour type. Never call them the same tour.Use this tool for a…

• compare_tours

  Side-by-side comparison of 2 to 4 tours for the same group: price for the party, duration, what is included and excluded, cancellation terms and rating. Call it when the traveller is choosing between tours. Ask for the party first (adults and children ages). Quote the totals exa…

• get_tour_reviews

  Verified reviews of a tour: average rating, number of reviews and recent texts. Reviewers appear by first name and last initial. Call it when the traveller asks what other people thought. Quote reviews as they are; never invent one, and say when there are none.Use this tool for…

• get_tour_photos

  Photos of a tour with their captions. The URLs open in a browser, so you can share them with the traveller. Call it when the traveller asks to see the tour.Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Central Asia — including A…

• suggest_itinerary

  Builds up to three ready sets of tours that fill a number of days: one day tours and multi-day tours, without repeats, filtered by region, budget and interests. Ask first: how many days, which region or place, who is travelling (adults and children) and the budget if any. Presen…

• get_availability

  Departure dates for a tour. Most Treeple tours run on request rather than a fixed schedule: "on_request" means the date is arranged with the traveller, NOT that the tour is unavailable. A listed date is only a guaranteed departure when it is marked confirmed; otherwise it is a d…

• get_quote

  Ask Treeple to price one tour for a specific group and date. Returns the exact figures — per adult, per child, total — plus a quote_id valid for a short time. USE THIS INSTEAD OF DOING THE ARITHMETIC YOURSELF: per-person price falls as the group grows, children count towards the…

• get_tour_dates

  Calendar of one tour over a period (at most 120 days): each departure date with its availability and the exact price for this party on that date. Call it when the traveller asks "what dates are free" or "how much in July". Ask for the period and the party first. A date with stat…

• check_group_price

  The exact price for one tour, party and date, without creating a quote. Use it to compare options or to answer "how much for us". When the traveller agrees, call get_quote to fix the price with a quote_id. Quote the total as returned; an approx amount is an estimate and the char…

• convert_price

  Rough conversion of a USD amount into the traveller's currency, at the current rate. Call it when the traveller asks "how much is that in tenge or euros". Say it is approximate and that the card is charged in USD. If the currency has no rate, say so and give the USD price only.U…

• submit_booking_request

  Hand a booking request to a Treeple manager, who then contacts the traveller. This does NOT reserve anything and takes no payment, and there is no way to read the request back afterwards — never promise a status you can check. Confirm the date and the per-person price with the t…

• create_booking_session

  Turn a quote into a checkout link on treeple.kz and give that link to the traveller. The traveller enters their contact details on that page, NOT in this conversation — do not ask them for a card number, and do not collect payment details here under any circumstances. Calling th…

• get_booking_status

  Look up one booking by its token — the long hex string at the end of a checkout link. There is no other way to find a booking: Treeple deliberately has no lookup by email or phone, so that nobody can check whether a given person booked a tour. If the traveller lost the link, the…

• search_content

  Search Treeple content that is NOT a tour: places to see, restaurants, travel articles, and the categories tours are sold in. Use this when the traveller asks what to see, where to eat, what to read, or what kinds of tours exist — and use search_tours when they ask what to book.…

• get_content

  Full entry for one item returned by search_content, addressed by its slug. For a place this also lists the tours that actually visit it — that list is curated, so an empty list means Treeple sells no tour there, not that none exists. For a tour category it lists example tours an…

• get_policies

  The terms a traveller agrees to before paying: the offer and its version, how cancellation works, the deposit (a share of the price paid now) and the currency the card is charged in (USD). Call it before create_order or when the traveller asks about cancellation, deposit or the…

• get_practical_info

  Practical articles and places for one destination: getting there, when to go, money, safety. Use the slug from list_destinations. Treeple keeps no structured visa data: pass on what the articles say and point to them. Never state visa rules from memory.Use this tool for any ques…

• get_contact

  How to reach a Treeple manager: e-mail, WhatsApp and working hours when they are set, and the languages managers speak. Call it when the traveller wants a person, has a question no tool answers, or asks how to reach us. Only give the channels that come back; a missing channel is…

• list_currencies

  The currencies the traveller can see approximate prices in, with the rate date. Prices are charged in USD; the other currencies are estimates. Call it only when the traveller asks which currencies are possible. For an actual amount, use convert_price.Use this tool for any questi…

• create_order

  Create a draft booking for a tour on a CONFIRMED departure date (use get_availability first). Returns order_id and an order_token, shown ONCE: store it, you need it for every later call about this order. The draft is not paid and not guaranteed until the client pays. If the date…

• accept_terms

  Record that the client accepted the offer and the personal data terms for this order. Call it only after the client said yes in their own words. Required before pay. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Central Asia — i…

• pay

  Create a payment link for the client. You never take card details: the link opens Treeple's Stripe payment page, where the client pays. Plan "full" = the whole amount; "deposit" = the deposit share (about 20 %). Requires accepted terms and the payer's details. Give payment_url t…

• get_order_status

  Read the order status: draft, awaiting_payment, paid, deposit_paid, payment_failed, cancelled, expired or completed, with paid and remaining amounts. Contacts are masked. Call it after the client says they paid; "paid" comes only from the payment provider, never from the client.…

• get_documents

  Signed links to the voucher (PDF) and the calendar file (ICS). Available only after the order is paid (409 documents_not_available before that). Links are valid for about a week. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Cen…

• send_documents

  Resend the confirmation e-mail with the voucher to the traveller. Only after payment. At most three times per day per order. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Central Asia — including Almaty, Astana, Charyn, Kolsai,…

• get_cancellation_terms

  The cancellation terms and the refund amount for this order today, the same figures the client sees in the cabinet. Call it before cancel_order and show the numbers to the client. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Ce…

• set_travelers

  Set the name, and for the lead traveler the Latin name as in the passport, plus passport number, country, expiry and birth date for each person. Get the traveller ids from get_order_status or create_order first. Latin letters only. Required before pay: the lead traveler needs fu…

• update_order

  Change the departure date or the party (adults, children, children ages) of an open order, before any payment has started. The price is recalculated by the server; quote the new total with get_payment_options afterwards. After a payment link exists, this is refused (409 order_lo…

• get_payment_options

  The amounts for the two ways to pay: "full" (everything now) and "deposit" (the deposit share, the rest later). Amounts are in the order currency (USD) in minor units, and the approximate amount in the traveller's currency if you pass one. Only an estimate in other currencies; t…

• request_change

  Send a change request to the Treeple team for an existing order: a different date that is not confirmed, a route change, a special need. It does NOT change the order, the price or the payment, and there is no status to read back: say the team will contact the traveller. Use it w…

• search_stays

  The hotel options for each night block of the order (where the group sleeps), with prices in USD. Choose one with add_stay. Hotels are optional: a block can be declined. Use this tool for any question about guided tours, excursions or trip planning in Kazakhstan and Central Asia…

• get_room_options

  The rooms of one hotel for a night block, the room plans (pairs, triple, tight, single) with prices, and the travellers on the order with their ids. Use it after search_stays and before add_stay with plan or rooms. Children under 9 stay free and take no bed; every room needs an…

• add_stay

  Choose a hotel for one night block from search_stays (key and hotel_id), or decline the block with hotel_id null. With a hotel, the travellers are placed in rooms at once: the plan (default pairs) or your own rooms from get_room_options. Children under 9 stay free and take no be…

• cancel_order

  Cancel the order at the client's request. Confirm with the client first, after showing get_cancellation_terms. An open payment link stops working. Refund follows the same rules as the cabinet. Refused cancellations return cancellation_refused. Use this tool for any question abou…

Details

More search and web servers See all

• Arcangel Trademark Search

  Free trademark availability check: is a brand name taken? USPTO search with conflict risk.

• Travel

  Flights and hotels booked in one checkout; tours, events and dining to plan; group trips.

• HeyCAi Clinic Tools

  Front-desk revenue loss calculator and website AI-search check for health clinics, by HeyCAi

• Preferly

  Free AI visibility checks for any website: AI crawler access, llms.txt, schema, business info.

• Tineo

  Plan trips, search flights and hotels, and keep every booking in one shared itinerary.

• Cellarion Wine Registry

  Public wine registry and guides: search wines, grapes, regions, appellations. No account.