Treka's MCP server lets an AI assistant work with one outdoor operator's Treka account: read trips, departures, bookings, revenue and rentals, and, only when the owner or admin allows it, make the changes they approve, including booking a guest and sending them a secure payment link. Muse, ChatGPT and Claude connect to it today.
MCP endpoint
https://treka.app/api/mcp
https://treka.app/api/mcptreka.read lets the assistant read. treka.write is added only when the owner or admin turns on Allow changes.https://treka.app/.well-known/oauth-protected-resource/api/mcphttps://treka.app/.well-known/oauth-authorization-serverThe assistant finds Treka's sign-in server from the endpoint's 401 response and registers itself. Treka only sends sign-in codes to the assistants' own callback addresses, or to an app on your own computer.
You sign in to Treka and land on treka.app/connect/ai, which names the assistant and lists exactly what it will be able to read.
You pick the company. Only companies where you are the owner or an admin are offered.
Allow changes is off unless you turn it on. Off, the connection can only read. On, the change tools are offered too, and the assistant asks you before each change.
Treka gives the assistant a token that works only on this endpoint, for that company. Access tokens last 60 minutes; refresh tokens last 90 days and are replaced each time they are used.
Disconnect any time from Connections in the Treka portal. Access stops at once, and it also stops if the person who connected is no longer an owner or admin.
You need a Treka account where you are the company's owner or an admin. Then, in the assistant you use:
21 tools read and 33 make changes. The change tools are offered only on connections where the owner or admin turned on Allow changes. The names, descriptions and inputs below are exactly what the server sends to the assistant.
| Tool | What it does | Type | Annotations |
|---|---|---|---|
| Company overview | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List trips | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List departures | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Search bookings | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Get a booking | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Revenue summary | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List guide invoices | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List reviews | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List gift cards | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List rentals | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List rental pickups and returns | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List email campaigns | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Get an email campaign | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List email contact lists | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Count an email campaign's recipients | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List text campaigns | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Text marketing audience | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List guides | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Guides on a departure | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Departures that need a lead guide | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| List closures | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Add a departure | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Change a departure | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Delete a departure | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Add a manual booking | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Book a guest with a payment link | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Update guest details | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Change party size | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Add a booking note | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Confirm a booking | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Cancel a booking | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Email a booking's guest | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Edit a trip | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Approve a guide invoice | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Reject a guide invoice | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Draft an email campaign | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Edit a draft email campaign | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Email a test to yourself | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Send an email campaign | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Import email contacts | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Delete an email contact list | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Draft a text campaign | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Edit a draft text campaign | Write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Send a text campaign | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Import text contacts | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Create a trip | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Duplicate a trip | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Publish or unpublish a trip | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Assign a guide to a departure | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Remove a guide from a departure | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Add a closure | Write | readOnlyHint: false destructiveHint: false openWorldHint: false | |
| Delete a closure | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Edit website text | Sensitive write | readOnlyHint: false destructiveHint: true openWorldHint: false | |
| Change rental gear | Write | readOnlyHint: false destructiveHint: true openWorldHint: false |
Company overview
ReadRead-only. Start here. The connected Treka company's name, currency and time zone, plus a snapshot: published trips, departures in the next 30 days, and bookings and revenue from the last 30 days.
None
List trips
ReadRead-only. The company's trips (tours/experiences) with price, group size, duration, location and rating. Published trips only unless include_unpublished is true.
include_unpublished boolean — Also list drafts and hidden trips.search string — Match words in the trip title.limit integer — How many to return (default 100, at most 200).List departures
ReadRead-only. Scheduled departures (trip dates) with capacity and seats booked. Defaults to the next 30 days. Dates are YYYY-MM-DD.
from string — Start date (YYYY-MM-DD), default today.to string — End date (YYYY-MM-DD), default 30 days after from.trip_id string — Only this trip (id from list_trips).limit integer — How many to return (default 100, at most 200).Search bookings
ReadRead-only. Find bookings, with guest name, email, phone, party size, status and amounts. Filter by departure date or booking date, status, trip, or a guest name/email/phone search. Newest first.
from string — YYYY-MM-DDto string — YYYY-MM-DDdate_field departure | booked — What from/to filter on: the trip's departure date (default) or when it was booked.status pending | confirmed | cancelled | completed | inquiry — Only this status.trip_id string — Only this trip (id from list_trips).search string — Guest name, email or phone.limit integer — How many to return (default 50, at most 200).Get a booking
ReadRead-only. One booking in full, by its id (from search_bookings).
booking_id string, required — The booking's id (from search_bookings or get_booking).Revenue summary
ReadRead-only. Booking revenue between two booking dates, grouped by month or by trip — counted the way the Treka dashboard does (confirmed and completed bookings). Defaults to the last 90 days by month. Refunds are not subtracted.
from string — YYYY-MM-DD (booked on or after)to string — YYYY-MM-DD (booked on or before)group_by month | trip — Default month.List guide invoices
ReadRead-only. Invoices guides sent the company for their pay, with status, amount and how they were paid. Newest first.
status string — e.g. pending, approved, paid, rejectedlimit integer — How many to return (default 50, at most 200).List reviews
ReadRead-only. Guest reviews of the company's trips, newest first.
max_rating integer — Only reviews at or below this rating. 1–5limit integer — How many to return (default 50, at most 200).List gift cards
ReadRead-only. Gift cards the company sold or issued, with balance, buyer and recipient. Newest first.
status string — Only this status (e.g. active, redeemed).limit integer — How many to return (default 50, at most 200).List rentals
ReadRead-only. The company's rentable gear (Rentals): name, category, variants/sizes, rental price and price type, deposit and quantity in stock. Give start_date and end_date to also see how many of each are free for those dates. Active rentable items only unless include_inactive is true.
search string — Match words in the item name.category string — Only this category (e.g. Climbing).start_date string — YYYY-MM-DD. With end_date: availability for that range.end_date string — YYYY-MM-DD, on or after start_date.include_inactive boolean — Also list items that are switched off or not rentable.limit integer — How many items to return (default 50, at most 100).List rental pickups and returns
ReadRead-only. The rental desk for one day (today by default, in the company's time zone): rentals going out that day, rentals due back that day, and everything overdue right now — rental orders and gear rented with trip bookings — with the guest, items, times, payment and deposit state.
date string — YYYY-MM-DD in the company's time zone. Defaults to today.limit integer — Most rentals per list (default 50, at most 100).List email campaigns
ReadRead-only. The company's email marketing campaigns, newest first: status (draft, sending, sent, failed), subject, and for sent ones how many were delivered, opened, clicked, bounced and unsubscribed.
status draft | scheduled | sending | sent | failed — Only this status.limit integer — How many to return (default 50, at most 200).Get an email campaign
ReadRead-only. One email campaign in full: subject, preheader, its content blocks, who it is addressed to (people who booked and/or which contact lists) and its counts.
campaign_id string, required — The email campaign's id (from list_email_campaigns or create_email_campaign).List email contact lists
ReadRead-only. The company's own email contact lists (uploaded CSVs and imports), with how many addresses each holds. Treka's own lists are never shown or reachable.
limit integer — How many to return (default 50, at most 200).Count an email campaign's recipients
ReadRead-only. Counts exactly who an email campaign would reach right now, the way the sender counts: its audience, minus people who unsubscribed, duplicates, placeholder addresses and anyone who only booked through GetYourGuide. Show this number to the user; send_email_campaign needs it as expected_recipients.
campaign_id string, required — The email campaign's id (from list_email_campaigns or create_email_campaign).List text campaigns
ReadRead-only. The company's text (SMS) marketing campaigns, newest first, with status (draft, scheduled, sending, sent, paused_cap, failed, cancelled), the message, who it is addressed to and how many were texted, failed or skipped.
limit integer — How many to return (default 50, at most 200).Text marketing audience
ReadRead-only. Who the company can text: how many people agreed to marketing texts from it, how many of them are textable now (STOP replies removed), its imported text lists with counts, this month's texting use against its limit, and whether texting is set up. Give audience (and trip_ids or list_id) to count one campaign's audience; send_sms_campaign needs that number as expected_recipients. Texts reach only people who agreed to marketing texts from this company (at checkout, or on a list the company imported and confirmed they agreed), never anyone who replied STOP, and never between 9pm and 8am in the company's time zone (all of North America when it has none) — a campaign started then waits until 8am.
audience all | booked | list — all = everyone who agreed to texts from the company; booked = those of them who booked one of trip_ids; list = those of them on the imported list list_id.trip_ids string[] — With audience 'booked': trip ids from list_trips.list_id string — With audience 'list': an imported text list's id (from sms_audience_summary).List guides
ReadRead-only. The company's guides (active team members who guide): name, email, phone, whether they have a Treka account, and what they're qualified to do per activity (lead or assistant). Use the id with assign_guide.
search string — Match words in the guide's name or email.Guides on a departure
ReadRead-only. Who is assigned to one departure, as lead or assistant, and whether they have confirmed — plus whether the departure still needs a qualified, available lead (the portal's staffing check).
departure_id string, required — The departure's id (from list_departures).Departures that need a lead guide
ReadRead-only. Upcoming public departures with no qualified, available lead guide — the same list as the portal's staffing alert. Defaults to the next 90 days.
from string — Start date (YYYY-MM-DD), default today.to string — End date (YYYY-MM-DD), default 90 days after from; at most a year after from.List closures
ReadRead-only. Days the company is closed (blackouts): whole days take those dates off sale; part-day closures block guides and timed slots. Defaults to closures that haven't ended yet.
from string — YYYY-MM-DD: closures ending on or after this day (default today).to string — YYYY-MM-DD: closures starting on or before this day.Add a departure
WriteChanges Treka: adds a bookable date for a trip. Seats default to the trip's max group size. Times are the company's local time.
trip_id string, required — The trip's id (from list_trips).start_date string, required — YYYY-MM-DDstart_time string — HH:MM (24h), optional — all day if left outend_date string — YYYY-MM-DD for multi-day tripsseats integer — Total seats. 1–10000Change a departure
WriteChanges Treka: sets a departure's total seats (never below seats already booked), marks it sold out or reopens it, or hides/shows it for booking.
departure_id string, required — The departure's id (from list_departures).seats integer — New total capacity 1–10000sold_out boolean — true marks it sold out, false reopens it.bookable boolean — false hides it from bookingDelete a departure
Sensitive writeChanges Treka: permanently deletes a departure that has no bookings. A departure with bookings must be cancelled in the Treka portal, where refunds are handled. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
departure_id string, required — The departure's id (from list_departures).Add a manual booking
WriteChanges Treka: records a booking taken outside Treka (phone, email, walk-in), holding seats on a departure. No card is charged and no email is sent; an optional amount is recorded as owed by invoice. Use hold=true to hold seats as pending until confirmed.
departure_id string, required — The departure's id (from list_departures).guest_name string, required — Lead guest's name.guest_email string, required — Lead guest's email.guest_phone string — Optional.guests integer, required — Party size. 1–500amount number — Total owed, in the company currency (optional)notes string — Optional notes on the booking.hold boolean — true = pending hold instead of confirmedBook a guest with a payment link
Sensitive writeChanges Treka, and can send an email: makes a Treka booking link for a guest on a departure and returns its secure checkout URL so the user can share it. With email_guest=true, Treka also emails the link to the guest. The guest pays on Treka's own Stripe-hosted checkout at the trip's normal price; the booking holds seats from when they check out and confirms when they pay. No card details pass through the assistant, and the assistant never takes the payment. Fails if the departure doesn't have enough seats left. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the guest, party size, departure and whether Treka will email them.
departure_id string, required — The departure's id (from list_departures).guest_name string, required — Lead guest's name.guest_email string, required — Lead guest's email (the link is for them).guests integer, required — Party size. 1–500email_guest boolean — true = Treka also emails the link to the guest (default false).message string — Optional note shown in the email and on the booking page. ≤ 1000 charactersdeposit_only boolean — true = the guest pays the trip's deposit now and the balance later.expires_in_days integer — How long the link works (default 7 days). 1–30Update guest details
WriteChanges Treka: overwrites a booking's guest name, email or phone. Sends nothing to the guest.
booking_id string, required — The booking's id (from search_bookings or get_booking).guest_name string — New name (optional).guest_email string — New email (optional).guest_phone string — New phone (optional).Change party size
WriteChanges Treka: sets how many guests are on a booking, moving seats on its departure. Only for bookings with nothing to charge or refund (manual/invoice bookings or free ones); priced online bookings must be changed in the Treka portal so the price is recalculated.
booking_id string, required — The booking's id (from search_bookings or get_booking).guests integer, required — New party size. 1–500Add a booking note
WriteChanges Treka: adds a private note to a booking (the operator's notes; guests don't see it).
booking_id string, required — The booking's id (from search_bookings or get_booking).note string, required — The note (up to 2000 characters).Confirm a booking
WriteChanges Treka: confirms a pending booking (seats are already held). Doesn't charge anything.
booking_id string, required — The booking's id (from search_bookings or get_booking).Cancel a booking
Sensitive writeChanges Treka: cancels an UNPAID booking and frees its seats. No refund is issued and no email is sent. Bookings with any payment must be cancelled in the Treka portal, where the refund is decided. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
booking_id string, required — The booking's id (from search_bookings or get_booking).reason string — Why (kept on the booking).Email a booking's guest
Sensitive writeSends an email: the guest on a booking gets a plain-text email from the company through Treka (replies go to the company). Write it as the company. At most 50 a day per company. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the exact subject and text.
booking_id string, required — The booking's id (from search_bookings or get_booking).subject string, required — Email subject. ≤ 150 charactersmessage string, required — Plain-text body. ≤ 5000 charactersEdit a trip
WriteChanges Treka: overwrites a trip's details: title, subtitle, description, meeting point, duration, price per person (whole units, more than 0), group sizes, and what's included / not included / requirements (lists replace the whole list). Publishing, payment rules and photos stay in the Treka portal.
trip_id string, required — The trip's id (from list_trips).title string — ≤ 150 characterssubtitle string — ≤ 250 charactersdescription string — ≤ 20000 charactersmeeting_point string — ≤ 500 charactersduration string — e.g. '4 hours', '3 days' ≤ 100 charactersprice number — Per person, whole currency units.max_group_size integer — 1–10000min_group_size integer — 1–10000included string[]not_included string[]requirements string[]Approve a guide invoice
Sensitive writeChanges Treka: approves a guide's pending invoice. This does NOT pay it — the company pays from the Treka portal, its usual payroll, or (when guide pay through QuickBooks or Xero is on) the bill this creates there. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
invoice_id string, required — The guide invoice's id (from list_guide_invoices).Reject a guide invoice
Sensitive writeChanges Treka: rejects a guide's pending invoice with a reason the guide sees. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
invoice_id string, required — The guide invoice's id (from list_guide_invoices).reason string, required — Shown to the guide. ≤ 500 charactersDraft an email campaign
WriteChanges Treka: saves a new email campaign as a DRAFT under the company's logo. Nothing is emailed. It can go only to the company's own audiences: people who booked with it and/or its own contact lists (never arbitrary addresses). Every email carries an unsubscribe link automatically.
name string, required — Internal name (only you see it). ≤ 120 characterssubject string, required — What recipients see in their inbox. Merge tags: {{first_name}}, {{name}}. ≤ 150 characterspreheader string — Optional inbox preview line. ≤ 150 charactersheadline string — Big headline at the top (defaults to the subject). ≤ 150 charactersintro string — Lead paragraph. ≤ 2000 charactersblocks object[] — The email body, in order. Each block is {type:'heading', text} | {type:'paragraph', text} | {type:'button', label, href, style?: 'solid'|'outline'} | {type:'image', src (https photo URL), alt?, caption?, href? (makes the photo a link)} | {type:'divider'}. An email can have up to 10 buttons and up to 10 photos, anywhere in the order — e.g. a photo, a paragraph and a button for each trip. Links (button href, image href) may be https, http, mailto: or tel:. Text may use {{first_name}}.booking_customers boolean — Include everyone who booked with the company (direct bookings only).list_ids string[] — The company's own contact lists to include (ids from list_contact_lists).Edit a draft email campaign
WriteChanges Treka: overwrites parts of a DRAFT email campaign (name, subject, preheader, headline, intro, blocks — blocks replace the whole body — and audience). Campaigns that are sending or sent can't be changed. Nothing is emailed.
campaign_id string, required — The email campaign's id (from list_email_campaigns or create_email_campaign).name string — ≤ 120 characterssubject string — What recipients see in their inbox. Merge tags: {{first_name}}, {{name}}. ≤ 150 characterspreheader string — Optional inbox preview line. ≤ 150 charactersheadline string — Big headline at the top (defaults to the subject). ≤ 150 charactersintro string — Lead paragraph. ≤ 2000 charactersblocks object[] — The email body, in order. Each block is {type:'heading', text} | {type:'paragraph', text} | {type:'button', label, href, style?: 'solid'|'outline'} | {type:'image', src (https photo URL), alt?, caption?, href? (makes the photo a link)} | {type:'divider'}. An email can have up to 10 buttons and up to 10 photos, anywhere in the order — e.g. a photo, a paragraph and a button for each trip. Links (button href, image href) may be https, http, mailto: or tel:. Text may use {{first_name}}.booking_customers boolean — Include everyone who booked with the company (direct bookings only).list_ids string[] — The company's own contact lists to include (ids from list_contact_lists).Email a test to yourself
WriteSends one test copy of an email campaign to the connected Treka user's OWN sign-in address (never anyone else), subject marked [Test]. The campaign stays a draft and no counts move. At most 10 a day per company.
campaign_id string, required — The email campaign's id (from list_email_campaigns or create_email_campaign).Send an email campaign
Sensitive writeSends an email campaign now to its whole audience. It can't be undone. Uses the portal's own sender: people who unsubscribed, placeholder addresses and GetYourGuide-only customers are left out, and every email carries the recipient's unsubscribe link and the company's logo. First call preview_email_audience and show the user the subject and the recipient count; pass that count as expected_recipients (refused if it changed). Drafts only. At most 2 campaigns a day per company and 5000 recipients per campaign; larger sends go from the Treka portal. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the subject, the audience and the exact number of recipients.
campaign_id string, required — The email campaign's id (from list_email_campaigns or create_email_campaign).expected_recipients integer, required — The exact number of recipients (from preview_email_audience) the user was shown and approved. The call is refused, with the current number, if it differs.Import email contacts
Sensitive writeChanges Treka: adds people to one of the company's own email contact lists — a new list (list_name) or an existing one (list_id) — from rows the user provided, up to 5000 per call (call again for more, with the list_id the first call returned). Addresses are checked, lowercased and deduplicated; ones already on the list are skipped. Only for people who agreed to hear from the business: consent_confirmed must be true, meaning the user confirmed that in this conversation. Nobody is emailed. At most 10 imports a day per company. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show how many contacts, which list, and ask the user to confirm these people agreed to receive email from their business.
list_name string — Name for a new list. ≤ 120 characterslist_id string — Add to this existing list instead.contacts object[], required — Up to 5000 rows of {email, name?}.consent_confirmed boolean, required — true only if the user confirmed these people agreed to receive email from their business.Delete an email contact list
Sensitive writeChanges Treka: permanently deletes one of the company's own email contact lists and every address on it. Refused while a campaign that is scheduled or sending uses it. Draft campaigns that named it simply stop including it. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the list's name and how many contacts it holds.
list_id string, required — The contact list's id (from list_contact_lists).Draft a text campaign
WriteChanges Treka: saves a new text (SMS) marketing campaign as a DRAFT. Nothing is texted. The message may use {{first_name}} and {{company_name}}, must be under 480 characters, and always ends with "<company>: Reply STOP to opt out" (added automatically — don't write it). Texts reach only people who agreed to marketing texts from this company (at checkout, or on a list the company imported and confirmed they agreed), never anyone who replied STOP, and never between 9pm and 8am in the company's time zone (all of North America when it has none) — a campaign started then waits until 8am.
name string, required — Internal name (only you see it). ≤ 120 charactersbody string, required — The message, without the footer. ≤ 480 charactersaudience all | booked | list — all = everyone who agreed to texts from the company; booked = those of them who booked one of trip_ids; list = those of them on the imported list list_id.trip_ids string[] — With audience 'booked': trip ids from list_trips.list_id string — With audience 'list': an imported text list's id (from sms_audience_summary).Edit a draft text campaign
WriteChanges Treka: overwrites the name, message or audience of a DRAFT text campaign. Scheduled, sending and sent campaigns can't be changed here. Nothing is texted.
campaign_id string, required — The text campaign's id (from list_sms_campaigns or create_sms_campaign).name string — ≤ 120 charactersbody string — ≤ 480 charactersaudience all | booked | list — all = everyone who agreed to texts from the company; booked = those of them who booked one of trip_ids; list = those of them on the imported list list_id.trip_ids string[] — With audience 'booked': trip ids from list_trips.list_id string — With audience 'list': an imported text list's id (from sms_audience_summary).Send a text campaign
Sensitive writeTexts a campaign to its audience through Treka's text sender. It can't be undone. Texts reach only people who agreed to marketing texts from this company (at checkout, or on a list the company imported and confirmed they agreed), never anyone who replied STOP, and never between 9pm and 8am in the company's time zone (all of North America when it has none) — a campaign started then waits until 8am. Every text ends with the company name and "Reply STOP to opt out", and the company's monthly texting limit applies. First call sms_audience_summary with the campaign's audience and show the user the message (with the footer) and the recipient count; pass that count as expected_recipients (refused if it changed). Drafts only. At most 1 text campaign a day per company and 1000 recipients per campaign; larger sends go from the Treka portal. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the exact message, the audience and the number of people it will text.
campaign_id string, required — The text campaign's id (from list_sms_campaigns or create_sms_campaign).expected_recipients integer, required — The exact number of people (from sms_audience_summary) the user was shown and approved. The call is refused, with the current number, if it differs.Import text contacts
Sensitive writeChanges Treka: records that people the user provided agreed to marketing texts from the company, onto an imported text list — a new list (list_name) or an existing one (list_id) — up to 5000 per call. Phone numbers are normalised (US/Canada numbers without +1 are accepted); invalid and duplicate numbers are counted, not guessed. A number that ever replied STOP or that the company removed is never re-added (counted as previously_opted_out), and an existing consent is kept as it is. Only for people who really agreed to texts from this business: consent_confirmed must be true, meaning the user confirmed it in this conversation, and consent_source must say where they agreed; both are stored with each person. Treka's toll-free number is shared by every company, so never import bought, scraped or guessed lists. Nobody is texted. At most 10 imports a day per company. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show how many numbers, which list, where they agreed, and ask the user to confirm "These people agreed to receive text messages from my business."
list_name string — Name for a new text list. ≤ 120 characterslist_id string — Add to this existing text list instead (id from sms_audience_summary).consent_source string, required — Where these people agreed to texts, e.g. 'Paper sign-up sheet at the shop, summer 2026'. ≤ 300 characterscontacts object[], required — Up to 5000 rows of {phone, name?, email?}.consent_confirmed boolean, required — true only if the user confirmed these people agreed to receive text messages from their business.Create a trip
WriteChanges Treka: creates a new trip as an UNPUBLISHED draft (guests can't see or book it). Price is per person in the company currency, whole units. Photos are added in the Treka portal; publish with set_trip_published once it has everything a live trip needs.
title string, required — ≤ 150 characterscategory Mountaineering | Hiking | Trekking | Trekking with Lodging | Rafting | Skiing | Climbing | Backpacking | Biking | Private Trips | Fishing | Hunting | Cultural Tours | Snowmobiling | Horseback Riding | Skill Courses | Kayaking | ATV Tours | Other — The activity (default Other).location string, required — Where it runs, e.g. 'Moab, UT'. ≤ 200 charactersregion string — Wider region, e.g. 'Utah' (default: the location). ≤ 120 charactersduration string, required — e.g. '4 hours', '3 days' ≤ 100 charactersprice number, required — Per person, whole currency units.booking_style scheduled | open_range | custom_request — scheduled = set departures (default); open_range = guests pick any day in a season; custom_request = guests ask for dates.subtitle string — ≤ 250 charactersdescription string — ≤ 20000 charactersmeeting_point string — ≤ 500 charactersdifficulty Easy | Moderate | Challenging | Expert — Default Moderate.max_group_size integer — Default 10. 1–10000min_group_size integer — Default 1. 1–10000included string[]not_included string[]requirements string[]Duplicate a trip
WriteChanges Treka: copies one of the company's trips into a new UNPUBLISHED draft, like Duplicate in the portal — details, booking and payment setup, photos, price tiers, checklists and rental gear. Departures are copied only with copy_departures=true (with fresh seats); bookings and reviews never are.
trip_id string, required — The trip's id (from list_trips).title string — The copy's title (default: the original's, plus ' (Copy)'). ≤ 150 characterscopy_departures boolean — Also copy the trip's departures (default false).Publish or unpublish a trip
Sensitive writeChanges Treka's public site: published=true puts a trip live on the company's website and booking pages; false takes it down (existing bookings stay). Publishing is refused, with what's missing, unless the trip has a title, description, location, duration, a price above 0, a group size and at least one photo — the portal's own check. A trip with no dates yet becomes bookable any day for a year (the portal's default), which the operator can change. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
trip_id string, required — The trip's id (from list_trips).published boolean, required — true = publish, false = unpublish.Assign a guide to a departure
Sensitive writeChanges Treka, and notifies the guide: puts a guide on a departure as lead or assistant (pending until they confirm), and Treka emails them — and texts them if they get guide texts — to confirm or decline, as the portal does. Refused if the guide isn't qualified to lead this activity (for role lead), is already on it, or is on another trip those days. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the guide, the role and the departure.
departure_id string, required — The departure's id (from list_departures).guide_id string, required — The guide's id (from list_guides).role lead | assistant — Default: lead if they're qualified to lead this activity, else assistant.Remove a guide from a departure
Sensitive writeChanges Treka: takes a guide off a departure, as removing them in the portal does. Treka doesn't message the guide; tell them yourself. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
departure_id string, required — The departure's id (from list_departures).guide_id string, required — The guide's id (from list_guides).Add a closure
WriteChanges Treka: closes the company on a day or a run of days (a blackout). Whole-day closures take those dates off sale and no departure can be added on them; existing departures and bookings are kept. Give start_time and end_time for a part-day closure on one day. Times are the company's local time.
start_date string, required — YYYY-MM-DDend_date string — YYYY-MM-DD, for a closure over several days (whole days only).start_time string — HH:MM (24h), part-day closures only.end_time string — HH:MM (24h), after start_time.title string — e.g. 'Staff training'. ≤ 120 charactersDelete a closure
Sensitive writeChanges Treka: removes a closure, so those days can be booked again. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation.
closure_id string, required — The closure's id (from list_closures).Edit website text
Sensitive writeChanges Treka, and with publish=true the company's public website: overwrites the website's headline, intro line, about text, main button label or hero badge (plain text; the about text may use simple Markdown). By default the change is saved as a draft the operator reviews and publishes in the website builder; publish=true puts it live at once. Layout, design, pages, domains and code stay in the portal. Sensitive: before calling, show the user exactly what will happen and get their explicit approval in this conversation. Show the exact new text.
headline string — ≤ 120 charactersintro string — The line under the headline. ≤ 400 charactersabout string — ≤ 5000 characterscta_label string — Main button, e.g. 'Book a Trip'. ≤ 40 charactershero_badge string — ≤ 80 characterspublish boolean — true = live now; false = save as a draft to publish in the portal (default).Change rental gear
WriteChanges Treka: overwrites a rental item's price, half-day price (per-day items only), deposit, or switches it on/off for rent. Amounts are whole currency units (decimals allowed), not cents. Stock, sizes and photos stay in the portal.
rental_id string, required — The item's id (from list_rentals).price number — Rental price. 0–100000half_day_price number — Half-day price; 0 removes it. 0–100000deposit number — Deposit; 0 = none. 0–100000rentable boolean — false stops new rentals of it.A second, public server for travellers: they ask their AI assistant to find a guided outdoor trip, check dates and prices, and hold spots. No Treka account or sign-in is needed. Only trips whose operator turned on AI-assistant booking appear, at the same price as the operator's own Treka booking page.
Endpoint
https://treka.app/api/book/mcp
| Tool | What it does | Type | Annotations |
|---|---|---|---|
| Search outdoor trips | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Trip details | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Check availability and price | Read | readOnlyHint: true destructiveHint: false openWorldHint: false | |
| Hold spots and get a payment link | Write | readOnlyHint: false destructiveHint: false openWorldHint: true |
Search outdoor trips
ReadRead-only. Find guided outdoor trips (tours, lessons, rentals with a guide) that operators offer on Treka, by place, activity, dates, party size and price. Only trips their operator chose to show in AI assistants appear. Returns each trip's operator, short description, location, price from, duration, rating and next open departures, and the trip's public Treka page. Results are paged; ask again with page for more.
query string — Words to match: activity, trip name or operator (e.g. 'kayak', 'via ferrata'). ≤ 120 characterslocation string — Place name to match (town, region, lake, park), e.g. 'Lake Tahoe'. ≤ 120 characterslatitude number — -90–90longitude number — -180–180radius_km number — With latitude/longitude: how far to look (default 50 km). 1–300category string — Activity category, e.g. Hiking, Kayaking, Climbing, Rafting, Skiing. ≤ 60 charactersdate string — A single day the guest wants to go (YYYY-MM-DD).date_from string — Earliest day (with date_to for a range) (YYYY-MM-DD).date_to string — Latest day (YYYY-MM-DD).party_size integer — How many people are going. 1–50max_price number — Highest price per person, in the trip's currency.language string — A language the guest wants the trip in (e.g. 'Spanish'). Matches trips that mention it in their details. ≤ 40 characterspage integer — Results page (default 1). 1–20limit integer — Trips per page (default 10, at most 25).Trip details
ReadRead-only. One trip's full public details: description, what's included and not, requirements, meeting point, cancellation policy, photos, a reviews summary and upcoming departures with spots left.
trip_id string, required — The trip's id (from search_trips).Check availability and price
ReadRead-only. Departures of one trip in a date range with spots left, and the exact price for the party: price per person, booking fee, total, what is due now and any balance later, in the trip's currency. The same price as the operator's own Treka booking page.
trip_id string, required — The trip's id (from search_trips).party_size integer, required — How many people are going. 1–50date_from string — First day to check, default today (YYYY-MM-DD).date_to string — Last day, default 30 days later (at most 62 days) (YYYY-MM-DD).Hold spots and get a payment link
WriteCreates a booking hold, not a charge: reserves the spots on one departure for the guest and returns a secure Treka payment link. The guest pays on Treka's own checkout page (card, Apple Pay, Google Pay); nothing is charged here and no card details are asked for. The hold lasts about 30 minutes; unpaid, it lapses and the spots are released. Before calling, confirm the trip, date, party size, total, the cancellation policy and the guest's name and email with the guest, and get their explicit OK. Then share the payment link and say the booking is confirmed only once they pay.
trip_id string, required — The trip's id (from search_trips).departure_id string, required — The departure's id (from check_availability).party_size integer, required — How many people are going. 1–50guest_name string, required — Lead guest's full name. ≤ 100 charactersguest_email string, required — Lead guest's email (the confirmation goes here). ≤ 254 charactersguest_phone string — Lead guest's phone (optional). ≤ 30 charactersnotes string — Anything the guest wants the operator to know (optional). ≤ 500 charactersguest_confirmed boolean, required — true only after the guest explicitly said yes to these details.Support
Email us about setup, a tool that misbehaves, or a security concern, and a real person answers. support@treka.app
Claim your 30-day free trialHow Muse, ChatGPT and Claude work with Treka