Prepare audio-guided tours: templates, travel programs, trips and participants for tour guides.
Scored across 61 tools
The set spans three parallel entity tiers (program / template / trip) and repeats nearly identical operations for each (add_*, update_*, delete_*, reorder_* for items, info cards, schedule stops, slides), so boundaries rest entirely on prose. Descriptions do real work to separate similar tools (e.g. list_my_departures explicitly excludes upcoming trips, list_my_trips owns availability, session vs trip ratings split), but the analytics cluster (list_my_sessions, list_my_departures, get_my_stats, get_my_session, get_my_session_ratings, list_my_ratings) and the five reorder_* tools remain easy to misselect.
The dominant pattern is snake_case verb_noun with an entity qualifier (add_program_item, update_trip_item, reorder_template_info_cards), applied consistently across the resource tiers. Deviations are minor but real: get_my_* / list_my_* prefixes, and inverted orderings like link_collectible_to_template vs unlink_template_collectible, plus set_template_visibility sitting alongside update_* mutators.
61 tools is heavy for this surface and much of the weight is structural duplication: three parallel item/info-card CRUD stacks plus five near-identical reorder tools and six rating/session analytics tools. A generic item/card API parameterized by parent type would collapse many of these, so the count feels driven by entity fan-out rather than distinct capabilities.
Core lifecycle coverage is genuinely deep: create/update/delete/duplicate/publish for programs, templates and trips, plus items, info cards, schedule stops, slides, participants, join links and reorder/status operations. However there are dead ends advertised in descriptions but absent from the set: get_my_trip points at list_trip_participants, and delete_trip points at announce_trip_cancellation, neither of which exists, and participant details can never be listed or updated after adding.
Add an info/rule card to a program. Params: id (program uuid) + body { kind (info|rule), title, body } -- at least one of title OR body must be filled (the inner 'body' here is the card text).
Inputs: id (required), body (required). Returns: id, body, kind, title, +5 more
Add a stop/leg to a program. Params: id (program uuid) + body { templateId OR label (at least one required), dayNumber, notes, kind (tour|activity|place|meal|transfer|free_time|accommodation|info), startTime (HH:MM, OPTIONAL -- do NOT pass it if the time is unknown; the order is already set by dayNumber + insertion order/reorder_program_items), locationText (stop name/address for the map route), locationLat, locationLng, durationMin, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules. Copied into trips created from this program.
Inputs: id (required), body (required). Returns: id, kind, label, notes, +12 more
Add an info card to a template. Params: id (uuid) + body { title (required), description, triggerType, linkedScheduleStopId }.
Inputs: id (required), body (required). Returns: id, title, imageUrl, createdAt, +5 more
Add a schedule stop to a template. Params: id (uuid) + body { title (required), description, estimatedTime (min), latitude, longitude, linkedInfoCardId, linkedSlideIndex, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
Inputs: id (required), body (required). Returns: id, title, latitude, createdAt, +8 more
Add a TEXT slide to a template (at the end). Params: id (uuid) + body { caption }. IMAGE slides cannot be added through this channel -- upload them from the app/panel.
Inputs: id (required), body (required). Returns: id, type, caption, mediaUrl, +4 more
Add a stop to a trip. Params: id (trip uuid) + body { templateId OR label, dayNumber, notes, kind, startTime (HH:MM), locationText, locationLat, locationLng, durationMin, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules. NO notification is sent.
Inputs: id (required), body (required). Returns: id, kind, label, notes, +15 more
Manually add a participant to a trip. Params: id (trip uuid) + body { displayName (required), email, phone }. Does NOT SEND an EMAIL (for an invite link use invite_trip_participant). Safe to retry: if the same person (same email or phone, or same name without conflicting contact details) is already on the trip, the existing participant is returned and no duplicate is created.
Inputs: id (required), body (required). Returns: id, email, phone, status, +6 more
Create a new travel program (multi-day trip draft). Fields: name (required), description, language, estimatedDays, category, country, city, region, tags (max 20), visibility (personal|org).
Inputs: name (required), city, tags, region, +6 more. Returns: id, city, name, tags, +18 more
Create a new tour template. Fields: name (required), description, language, estimatedDuration (min), tourType, tourFormat (single|multi_stop), category, country, city, region, visibility (personal|org -- org only for a company owner/manager), broadcastMode (offline|online|both), routerProfileId. The plan quota applies.
Inputs: name (required), city, region, country, +9 more. Returns: id, city, name, tags, +22 more
Create a new TRIP from a program (the program's current state is snapshotted). Fields: programId (uuid, REQUIRED -- a trip is always a live instance of a program), name, startDate, endDate (YYYY-MM-DD), maxParticipants (null = unlimited), timezone (IANA name, e.g. 'Europe/Istanbul'). A new trip starts as a DRAFT and is NOT LISTED on the company website; to open it for sale/on the site, use publish_trip.
Inputs: name (required), programId (required), endDate, timezone, +2 more. Returns: id, name, status, endDate, +18 more
Delete a travel program. Params: id (uuid). The program's non-completed trips without participants are deleted too (returned as deletedTrips { count, names }) and its listing is removed from the company website draft (publishing is a separate step); if an open trip with participants exists, deletion stops with itinerary.delete_blocked_by_trips (details.trips lists the blocking trips with id, name, status, participants; cancel or complete them first). Completed trips remain as history records (keptCompletedTrips).
Inputs: id (required). Returns: id, deletedTrips, keptCompletedTrips
Delete a program info card. Params: id (program uuid), cardId (uuid).
Inputs: id (required), cardId (required). Returns: id
Delete a program stop. Params: id (program uuid), itemId (uuid).
Inputs: id (required), itemId (required). Returns: id, imageUrls
Delete a slide. Params: id (template uuid), slideId (uuid).
Inputs: id (required), slideId (required). Returns: id, type, caption, mediaUrl, +4 more
Delete your own template (together with its sub-resources). Params: id (uuid).
Inputs: id (required). Returns: id
Delete an info card. Params: id (template uuid), cardId (uuid).
Inputs: id (required), cardId (required). Returns: imageUrl
Delete a schedule stop. Params: id (template uuid), stopId (uuid).
Inputs: id (required), stopId (required). Returns: ok
Permanently DELETE a trip (a wrong or duplicate departure, or one whose program was deleted). Works only on a trip that has no (joined) participants and is not completed; for a trip with participants use announce_trip_cancellation. NO notification is sent. Params: id (trip uuid).
Inputs: id (required). Returns: id, deleted
Delete a trip stop. Params: id (trip uuid), itemId (uuid). NO notification is sent.
Inputs: id (required), itemId (required). Returns: id, label
Deep-copy a program (create a variant). Params: id (uuid) + body { name?, visibility? }.
Inputs: id (required), body (required). Returns: id, city, name, tags, +18 more
Copy your own template (or a company template open to you) into a NEW template; sub-resources are deep-copied. Params: id (uuid) + body { visibility? }. The copy gets an AUTOMATIC name -- to rename it, call update_template afterwards. The plan quota applies.
Inputs: id (required), body (required). Returns: id, city, name, tags, +22 more
Your audience: country/language/device BREAKDOWN of participants (aggregate counts, not personal identities).
Inputs: no named parameters. Returns: total, byDevice, byCountry, byLanguage
Details of one travel program: stops/items + info cards. Params: id (uuid).
Inputs: id (required). Returns: id, city, name, tags, +21 more
Your ratings summary: total count, average score and 1-5 star distribution.
Inputs: no named parameters. Returns: distribution, totalRatings, averageRating
Your rating trend: average stars + rating count as a time series. Params: days, granularity (day|week).
Inputs: days, granularity. Returns: items
Details of one of your tours: session facts, participants as AGGREGATE COUNTS (total, by country, language and device type, average listening time), ratings (score + comment, no names) and live translation usage per language. Individual listener records are not returned. Params: id (uuid).
Inputs: id (required). Returns: id, tripId, endedAt, ratings, +16 more
Ratings of one of your tours (score + comment + your own report status). Listener names are not returned. Params: id (uuid).
Inputs: id (required). Returns: items
Your own all-time live tour stats: total tours (sessions), total/average participants, total/average duration in seconds.
Inputs: no named parameters. Returns: totalTours, avgDuration, totalDuration, avgParticipants, +1 more
Details of one template: slides, info cards, schedule stops, routes. Params: id (uuid).
Inputs: id (required). Returns: id, city, name, tags, +28 more
Details of one trip: stops, info cards, change log and derived progress (day X/Y, completed stops). The participant list is NOT INCLUDED (it needs list_trip_participants + the trips:roster scope). Params: id (uuid).
Inputs: id (required). Returns: id, name, items, status, +24 more
A trip's participant ratings (given after the trip is completed, optional): average, number of raters / participants, 1-5 distribution and comments (newest first). Participant NAMES are NOT returned (trips:roster is not required). Params: id (uuid).
Inputs: id (required). Returns: count, average, ratings, distribution, +1 more
Generate and return a SINGLE-USE invite token for an existing participant. Does NOT SEND an email -- you share the link yourself. Params: id (trip uuid), participantId (uuid).
Inputs: id (required), participantId (required). Returns: token, participant
Link a ready-made magnet chosen from the catalog to a template (without uploading an image). Params: id (template uuid) + body { collectibleId (uuid) }. The target must be ACTIVE and either a ready-made platform magnet OR yours. The previously linked magnet is not deleted, only unlinked. For the catalog use list_collectible_catalog (content:read).
Inputs: id (required), body (required). Returns: id, city, tags, title, +9 more
Souvenir magnet (collectible) catalog: ready-made platform magnets + your own magnets. Filters: search, category, country, city, tag, owner (platform|mine).
Inputs: tag, city, page, limit, +4 more. Returns: data, page, limit, total
History of PAST live tour runs grouped by run (how many sessions and participants each repeat run had). It does NOT list scheduled or upcoming trips; for upcoming departures, dates, capacity and spots left use list_my_trips.
Inputs: no named parameters. Returns: items
Your travel programs (itineraries / draft trip plans) + the ones your company shares.
Inputs: no named parameters. Returns: items
Ratings listeners left after your live tour sessions (feed across all your sessions; trip ratings come from get_my_trip_ratings). Listener names are not returned. Filters: minRating, maxRating (1-5), hasComment ('true'|'false'), flagged ('true'|'false'), search, dateFrom, dateTo (YYYY-MM-DD), sort (newest|oldest|highest|lowest). Pagination: page/limit.
Inputs: page, sort, limit, dateTo, +6 more. Returns: data, page, limit, total
List your own completed tours (sessions), newest first, up to 500: name, date, duration, online/local, participant counts, slides and stops shown, rating average and count. No listener records.
Inputs: no named parameters. Returns: items
Your tour templates (+ org templates your active company shares with you). Filters: q, category, country, city, hasCollectible.
Inputs: q, city, country, category, +1 more. Returns: object
List your trips: the scheduled departures of your programs (upcoming, active and past), each with dates, status (draft|active|completed|cancelled), capacity (maxParticipants, null = unlimited) and participantCount. Use this for questions about upcoming departures, availability or spots left (spots left = maxParticipants - participantCount).
Inputs: no named parameters. Returns: object
PUBLISH a draft trip (draft -> active): the trip is listed on the company website and opens for booking. NO notification is sent to participants (it is not an announcement). Params: id (trip uuid). Works only on a draft trip.
Inputs: id (required). Returns: id, name, status, endDate, +18 more
Remove a participant from a trip (status='removed'). Params: id (trip uuid), participantId (uuid).
Inputs: id (required), participantId (required). Returns: id
Reorder program info cards. Params: id (uuid) + body { cardIds: [...] }.
Inputs: id (required), body (required). Returns: ok
Reorder program stops. Params: id (uuid) + body { itemIds: [...] } -- ALL item ids, in the new order, without duplicates.
Inputs: id (required), body (required). Returns: ok
Reorder slides. Params: id (uuid) + body { slideIds: [...] } -- ALL slide ids of the template, in the new order, without duplicates.
Inputs: id (required), body (required). Returns: ok
Reorder info cards. Params: id (uuid) + body { ids: [...] } -- ALL card ids, in the new order.
Inputs: id (required), body (required). Returns: ok
Reorder schedule stops. Params: id (uuid) + body { ids: [...] } -- ALL stop ids, in the new order.
Inputs: id (required), body (required). Returns: ok
Reorder trip stops. Params: id (uuid) + body { itemIds: [...] } -- ALL item ids, in the new order. NO notification is sent.
Inputs: id (required), body (required). Returns: ok
Reset the trip's open join link and 6-digit join code (draft or active trip). The old link, QR code and code stop working immediately; use it after removing a participant so they cannot rejoin as a guest. Participants are NOT notified: share the returned joinUrl with the group yourself. Params: id (trip uuid).
Inputs: id (required). Returns: id, joinUrl, joinCode
Switch one of YOUR OWN templates between personal <-> company-shared (a company template created by another guide cannot be switched). Params: id (uuid) + body { visibility: personal|org }. org only for a company owner/manager. Only changes who can see it INSIDE your own Your Next Tours company workspace; nothing becomes public and nothing is sent outside the account.
Inputs: id (required), body (required). Returns: id, city, name, tags, +22 more
Record the on-site status of a trip stop: planned | in_progress | done | cancelled | skipped. Params: id (trip uuid), itemId (uuid) + body { status }. Setting in_progress or done also marks every EARLIER stop that is still planned or in_progress as done (trip order: day, then time; stops without a time keep their place); their ids come back in autoCompletedItemIds. Setting planned reopens a stop without touching others. NO notification is sent (a stop cancellation announcement requires trips:announce).
Inputs: id (required), body (required), itemId (required). Returns: id, kind, label, notes, +16 more
Remove a template's magnet link. Params: id (template uuid). Does NOT DELETE the PLATFORM magnet, only detaches it from the template.
Inputs: id (required). Returns: ok
Update program metadata. Params: id (uuid) + body (the create fields, all optional). Changing visibility (personal|org) is allowed only for the program's CREATOR. Visibility only controls access INSIDE your own Your Next Tours company workspace; programs never become public through this tool and nothing is sent outside the account.
Inputs: id (required), body (required). Returns: id, city, name, tags, +18 more
Update a program info card. Params: id (program uuid), cardId (uuid) + body { kind, title, body }.
Inputs: id (required), body (required), cardId (required). Returns: id, body, kind, title, +5 more
Update a program stop. Params: id (program uuid), itemId (uuid) + body (label/dayNumber/notes/kind/startTime/location*/durationMin/headsetPolicy). headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
Inputs: id (required), body (required), itemId (required). Returns: id, kind, label, notes, +12 more
Update a slide's caption/text. Params: id (template uuid), slideId (uuid) + body { caption } (null = clear).
Inputs: id (required), body (required), slideId (required). Returns: id, type, caption, mediaUrl, +4 more
Update template metadata. Params: id (uuid) + body (the create fields except visibility, all optional; category/country/city/region/routerProfileId null = clear). visibility is not accepted here and is dropped silently; change it with set_template_visibility.
Inputs: id (required), body (required). Returns: id, city, name, tags, +22 more
Update an info card. Params: id (template uuid), cardId (uuid) + body (title/description/triggerType/linkedScheduleStopId).
Inputs: id (required), body (required), cardId (required). Returns: id, title, imageUrl, createdAt, +5 more
Update a schedule stop. Params: id (template uuid), stopId (uuid) + body (title/description/estimatedTime/latitude/longitude/headsetPolicy/...). headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
Inputs: id (required), body (required), stopId (required). Returns: id, title, latitude, createdAt, +8 more
Update trip metadata. Params: id (uuid) + body { name, startDate, endDate (YYYY-MM-DD), maxParticipants (null = unlimited), timezone (IANA name, e.g. 'Europe/Istanbul'), weatherCardsEnabled (boolean, turns the trip's weather cards on or off), stableLiveCode (boolean, keeps the same live broadcast link and join code for the whole trip; the code itself is assigned by the server) }. startDate/endDate/maxParticipants/timezone accept null to clear. NO notification is sent to participants.
Inputs: id (required), body (required). Returns: id, name, status, endDate, +20 more
Update a trip stop. Params: id (trip uuid), itemId (uuid) + body (same fields as add_trip_item; headsetPolicy null clears). NO notification is sent.
Inputs: id (required), body (required), itemId (required). Returns: id, kind, label, notes, +15 more
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Create trips, compare variants side by side, and add accommodation, transport and event options.
Read-only MCP for Sparkling Tracks European tours: packages, itineraries, pricing, contacts.
Read-only city guides and public itineraries for family and group trips.
Audio guides for 44,000+ places in 1,900+ cities, with narrated previews in ChatGPT and Claude.
Add one secure layer between your agents and this server.
