com.pricetik/mcp-server

Full content for one activity — description, highlights, gallery (XL images), meeting point, redemption type, and bookable rates with rateKeys. Hand the activity code from `pricetik_activity_search` to this tool to get everything needed to compare modalities and surface a checkout link via `pricetik_activity_get_booking_url`. Free at every tier.

Return a pricetik.com/tickets/... checkout URL pre-filled with the trip parameters. Verifies a bookable rate exists for the requested dates before handing the URL back. The user — not the agent — completes the booking on the URL (matches the hotel certification boundary). Free at every tier. Pass an `Idempotency-Key` header on retries to avoid duplicate redirects (24-hour cache window).

Search bookable tours, attractions, and excursions by destination + dates via Hotelbeds Activities. Returns activities with price-from in the requested display currency (USD by default), plus the source EUR price for transparency. Use a 3-letter Hotelbeds destination code (e.g. PMI, BCN, NYC, LON). Free at every tier — no API key required.

Resolve free-text into the canonical shape other PriceTik tools need. Two cases: (1) a DESTINATION ("Las Vegas", "Mallorca") → hotel-search-friendly text + the Hotelbeds activity destination code (for pricetik_activity_search) + country + subtitle (kind:"destination"); (2) a SPECIFIC NAMED HOTEL ("the Wynn Las Vegas") → kind:"hotel" with a providerPropertyId, passable straight to pricetik_hotel_get_booking_url / _details (no UUID round-trip) — this is how you turn a hotel NAME into a bookable handle, since pricetik_hotel_search only accepts a city/landmark. Call this first so you never have to ask the user for a code. Cache-backed, no API key required.

Search flights and get the top offers with price signals. One-way, round-trip, and multi-city (up to 6 legs) in ONE call: pass EITHER the compact legs string — comma-separated ORIG-DEST-YYYY-MM-DD triples, e.g. "JFK-LHR-2026-09-01,LHR-JFK-2026-09-08" — OR the flat origin/destination/departure_date (+ return_date) params, never both. Airports are 3-letter IATA codes; dates within 330 days. Passengers and cabin apply to the whole itinerary: adults (1-6), children with children_ages, lap infants (never more than adults), optional cabin. A live fare search takes 10-20 seconds — make ONE call per itinerary and reuse the returned offers. Returns the cheapest fare per journey with signals (fare options, refundable-upgrade delta, seats remaining, bag inclusions) plus best/price/duration/stops winners. Free at every tier — no API key required.

Propose a candidate to the group — a hotel, activity, live-event ticket, or transfer found via the normal search tools. Pass the surface plus a ref object carrying the surface identifier (hotel: propertyId or providerPropertyId; activity: activityCode; ticket: the event id from pricetik_ticket_search; transfer: the rateToken) and display snapshot fields (name, priceUsd, currency, photoUrl, bookingUrl) copied from the search result so other members see what they are voting on. Member-only (403 otherwise); sessions cap at 25 options. Add 2–4 strong candidates per surface rather than dumping every search result.

Cancel a group trip session (organizer-only; 403 OrganizerOnly for other members). Closes a still-planning session — status moves to "cancelled". A finalized session cannot be cancelled (409 AlreadyFinalized); a re-cancel returns 409 SessionNotOpen. Coordinate-only: cancelling never touches a booking (PriceTik never auto-purchases), so there is nothing to refund. Use this when the group abandons the trip; to lock a plan instead, use pricetik_group_trip_finalize. Requires an authenticated API key.

Start a shared GROUP trip-planning session that friends join by share code — the multi-user counterpart to pricetik_trip_plan. Pass destination (plus optional checkIn/checkOut/title). Returns the session, a shareCode, and a shareUrl (pricetik.com/trips/<code>) — give BOTH to the user so companions can join from their own agent (pricetik_group_trip_join) or vote on the web page without one. Choreography: create → search hotels/activities/tickets as usual → pricetik_group_trip_add_option for the strongest candidates → members vote → organizer finalizes. The creator becomes the session organizer. Requires an authenticated API key; pass an Idempotency-Key header to make retries safe. Sessions are coordinate-only — booking stays per-traveler via the booking-url tools; PriceTik never books on anyone's behalf.

Lock in the group's plan (organizer-only; 403 for other members). Pass optionIds to finalize the winning subset — read pricetik_group_trip_get first and pick the top-voted options; when optionIds is omitted, ALL candidate options are locked in. Returns the finalized plan grouped by surface with vote tallies and handoffPolicy "user_completes_booking". Prices in option snapshots are display-only — re-check live rates via the surface read tools before booking. Finalizing is irreversible for the session (it moves to "finalized", 409 on repeat); PriceTik never books on anyone's behalf.

Fetch a group trip session — status, members (display names only), candidate options with per-option vote tallies (upvotes / downvotes / score), and the caller's own votes. Look up by sessionId or shareCode (exactly one). Poll this after adding options or between conversations to see how the group is converging before the organizer finalizes. Requires an authenticated API key; non-members get 403 (join first via pricetik_group_trip_join). Pure read.

Join a group trip session by share code (idempotent — joining twice is safe). Pass an optional displayName so other members see who voted. After joining, the caller can read the session, add candidate options, and vote. Requires an authenticated API key (the membership is owned by the PriceTik account). Pass an Idempotency-Key header to make retries safe.

Record the caller's vote on a candidate option: 1 (up) or -1 (down). One vote per member per option — voting again replaces the previous vote (upsert), so changing one's mind is safe. Member-only (403 otherwise). After voting, read pricetik_group_trip_get for the updated tallies.

Get full property content for a PriceTik hotel — name, description, star rating, amenities, paid extras, nearby points of interest, address, contact, segments, and gallery imagery. Look up by PriceTik UUID (propertyId) or providerPropertyId returned from a hotel search; exactly one is required. Use the optional include array (rooms, issues, voucherFacilities, fullDescription) to opt into expanded sections — Pro tier unlocks rooms and issues, Scale tier and above unlock voucherFacilities and fullDescription. Open tier responses cap amenities at 8, points of interest at 3, and the description at 240 characters.

Generate a one-click signed PriceTik checkout URL for a hotel stay. Stay-based form (preferred for agents): pass providerPropertyId + checkIn/checkOut + guests/rooms (+ optional roomCode) and the server resolves the best live rate itself. Or pass a rateKey from pricetik_hotel_price_check directly; it auto-refreshes near expiry or when rateType is "RECHECK". URLs are pricetik.com/go/ affiliate redirects — pass to the user's browser unchanged, never fetch server-side. On 410 RateKeyExpired, re-call pricetik_hotel_price_check for a fresh rateKey. On 422 PackagingDenied, the rate is package-only and can't be booked hotel-only. currentBest surfaces nightlyRate, totalStayCost, currency, paymentType, rateType, freeCancellation only — no margin fields. When a stored loyalty program matches the property's chain, the response carries loyaltyApplied ({ program, memberId }) and the URL is member-stamped — tell the user which program linked.

Check current rates across all hotel providers for a specific property and date range. Returns per-provider pricing with availability status. Pass EITHER propertyId (PriceTik UUID) OR providerPropertyId (the handle from a hotel search or destination lookup) — exactly one — so you can price a property straight off a search result without a UUID round-trip. This is cache-first and never calls the provider on read, so for a valid property with no warmed rates it returns `dataAvailable:false` with a `note` + `nextStep` (not an error) — follow the nextStep to pricetik_hotel_get_booking_url's stay-based form, which resolves a fresh live rate, or retry shortly.

Search hotels by DESTINATION (city, region, or landmark) + dates + guest count — `destination` is geographic, NOT a hotel name. For a SPECIFIC named hotel ("the Wynn"), resolve it first with pricetik_destinations (returns a providerPropertyId) and pass that to pricetik_hotel_get_booking_url / _details. Returns properties with the lowest available nightly rate cached on PriceTik; filter by lifestyle segment, hotel chain, accommodation type, and resort-fee/breakfast/pet flags (see params). `destinationResolved: false` means the destination matched no known place — ask the user to confirm it; never retry with a guessed city. Use the returned providerPropertyId with pricetik_hotel_price_check for live rates. Direct REST callers can append `?stream=ndjson` for incremental per-property frames. Hotels only; for a single-call hotel + activity stitch use pricetik_trip_plan instead.

Export the authenticated user's bookings as an RFC-5545 .ics calendar string plus a structured events array, ready to drop onto a calendar app. Upcoming-only by default; pass includePast=true for the full history. The capstone to pricetik_trip_plan / pricetik_my_trips. Requires a bearer API key; Open-tier requests get 401. Pass tripSessionId to export a group trip session's PROPOSED plan before anything is booked — share the .ics with the whole group.

List the authenticated user's group-trip sessions (as organizer or member), newest activity first. Each row carries the sessionId + shareCode (plus title, destination, status, your role, and memberCount) needed to RESUME a trip — vote, add options, or finalize. Call this when a returning user references a group trip but you don't have its sessionId in context (create/join are the only other places that hand one back). Auth required (OAuth account or bearer API key).

List the authenticated user's trips — bookings grouped by destination + overlapping date window. Each trip carries the hotel + all activities, total spend, days-until-departure countdown, and per-member manage URLs. Status filter: 'upcoming' | 'past' | 'all' (default). Requires a bearer API key minted from the dashboard; Open-tier requests get 401. SCOPE: reflects PriceTik order-book fills and agent-assisted direct bookings only — trips the user finished by clicking a pricetik.com/go/ checkout handoff are NOT yet tracked here. An empty result is therefore normal for handoff bookings, not an error; the response carries a `note` field explaining where those bookings live (https://pricetik.com/my-account/bookings) — relay it instead of implying the user has no trips.

Resolve a free-text activity/event NAME ("the Sphere show", "Grand Canyon helicopter tour") into a Hotelbeds activityCode. Returns ranked candidates {activityCode, name, destinationCode, fromPrice}; hand the activityCode to pricetik_activity_details (rates + rateKeys) or pricetik_activity_search. Optionally scope with destinationCode. Coverage is lazy — a name never surfaced via search may miss until first searched. Free at every tier, no API key required.

Filtered, ranked room catalog for a property. Pass checkIn/checkOut to get LIVE per-room nightly rates for the stay (rooms with no live availability are dropped; cached-rate fallback when the live look fails). Filter by bedType (KING/QUEEN/DOUBLE/TWIN/SOFA), suite, kitchenette, accessible, minAdults.

Discovery search across PriceTik travel surfaces (hotels/events) — see the `surface` param for what each value returns. For a SPECIFIC intent prefer the dedicated tool (`pricetik_hotel_search`, `pricetik_activity_search`) for richer, date-accurate results in their own widget; use `pricetik_search` when exploratory or the surface is unknown. For a multi-surface trip ("a hotel AND a show"), do NOT use `surface=all` to commingle — fire parallel dedicated calls or use `pricetik_trip_plan` (includeTickets=true for a ticketed show) instead. To compare multiple candidate destinations, fire one `pricetik_hotel_search` per destination in parallel with the same dates/guests and summarize the results side by side. The events surface also returns a separate labeled "Event tickets" section when live-event tickets match (city, eventDate, a pricetik_ticket_details drill-in); call pricetik_ticket_search directly for ticket-specific city/date filtering. Each result carries a `drillDownTool` for the next call. For "best deals right now" with nothing specific in mind use pricetik_trending_deals.

Check Intel API health and feature flag state. Use before making calls to verify the API is available. Returns current status, resolved tier, and active feature flags. For an authenticated caller it also returns an `account` block — `tokenBalance` and `tokensInCooldown`. The block is omitted for anonymous callers. Pass `surface` for a per-vertical health view instead (cache freshness, rate-history coverage, refresh-worker status for that surface).

Full detail for one LIVE-EVENT TICKET listing (by `id` or slug from pricetik_ticket_search): venue, date, performers/teams, the from-price, a pricetik.com/go/ checkout link, and OTHER upcoming dates for the same event so you can offer alternatives. Affiliate inventory — surface the checkout link to the user unchanged; PriceTik never auto-purchases. Companion to pricetik_ticket_search.

Search LIVE-EVENT TICKETS — concerts, theater, sports, comedy — by name, type, city, and date window (to attend a specific event). DISTINCT from pricetik_activity_search (tours/attractions) and pricetik_search (broad discovery), neither of which return event tickets on their own. Each result carries venue, city, date, a from-price, and a pricetik.com/go/ checkout link the user opens on the ticket seller — affiliate inventory, no auto-purchase or on-site checkout. Recurring dates of the same event collapse into one result with a `moreDates` count; call pricetik_ticket_details for the others. To bundle tickets WITH a hotel in one call, use pricetik_trip_plan with includeTickets=true instead.

Today's best travel deals ranked 0-100, across every vertical, with nothing specific in mind ("what are the best deals right now?"). Pass `surface` explicitly: hotels (biggest 7-day nightly-rate drops), events (activity rate drops), tickets (live-event tickets below their 30-day median, with a reasons[] breakdown), or all (labeled per-surface sections: hotels, things to do, event tickets). Rows carry a drillDownTool for the next call (hotel_details / activity_details / ticket_details) and a dealScore. Optional minDealScore floor. URLs are pricetik.com/go/ affiliate redirects — pass to the user's browser unchanged, never fetch server-side. No API key required. For a specific query use pricetik_search instead.

Single-call orchestrated trip planner — stitches top hotels + recommended activities + estimated spend into one response (skips the manual "search hotels → search activities → stitch" fan-out). Pass destination + dates (optional budget, interests, star rating, no-resort-fees). See the `includeTickets`, `groupByDay`, and `includeTransfer` params for optional event-ticket, daily-itinerary, and ground-transfer attachments. Free at every tier; stricter rate limit than single-surface tools (10/min) since it fans out parallel searches. Direct REST callers can append ?stream=ndjson for incremental frames. Use this for a single-call hotel + activity (+ ticket) stitch; for hotels only use pricetik_hotel_search, for tickets only use pricetik_ticket_search.