Treeple — tours in Kazakhstan
kz.treeple/tours · v2.2.0 · MCP 2025-11-25
Search tours in Kazakhstan, book them and pay by card link. A manager follows up on every booking.
Reachability
reachable
checked 2026-11-21 05:37 UTC
Registry status active
Tools pinned 39
a0490a88f53b
Tools last changed
2026-11-19
Provenance
Registry namespace kz.treeple
(domain verified by the official registry)
Website
https://treeple.kz
Remote endpoints
https://mcp.treeple.kz/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-19 05:34 | tools changed | 0 added, 0 removed, 39 changed |
| 2026-11-15 05:30 | first capture | 39 tools pinned |
Pinned tool definitions (39)
| Tool | Description |
|---|---|
| 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... |
| 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... |
| 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.... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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;... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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.... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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,... |
| send_documents | Resend the confirmation e-mail with the voucher to the traveller. Only after payment. At most three times per day per order. The confirmation is sent once: if it was already sent, the answer has status already_sent and nothing new goes... |
| 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,... |
| 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.... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
| 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... |
Get alerted when this changes.
Email the moment kz.treeple/tours drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/kz.treeple/tours)
Maintain this server? Add the badge to your README. It links your users to this live status page.