The MCP server for travel & commerce.

Honest tool counts — marketed numbers now cover the ADVERTISED surface only: the four in-place deprecated tools (pricetik_resolve_property, pricetik_my_account, pricetik_activity_destinations, pricetik_demand_pulse) stay dispatchable for cached clients but no longer count or appear in the catalog below.

The default focused surface is now the headline number (45 tools): what a fresh install actually sees in tools/list, kept in lockstep with the server clamp by the consistency suite. The full catalog stays one env var away (PRICETIK_FULL_SURFACE=1).

Default surface trimmed 47 → 45 — the rare group-trip recovery verbs (pricetik_group_trip_remove_option, pricetik_group_trip_reopen) come off the eager list; both remain in the catalog and dispatch normally on scoped/full surfaces.

Tool count 60 advertised (was 64 incl. deprecated) — Hotels 6, Events 8, Account 17, Reference 1; Shopping 10, Trip Planner 14, Transfers 4 unchanged.

Tool-surface consolidation, gated on a 30-day production traffic sweep: sixteen zero-traffic tools retired outright (REST routes stay) — pricetik_deal_score, pricetik_compare, pricetik_batch_price_check, pricetik_hotel_compare, pricetik_check_availability, pricetik_hotel_status, pricetik_activity_deal_score, pricetik_activity_compare, pricetik_activity_status, pricetik_activity_rate_history, pricetik_activity_pickup_check, pricetik_currency_convert, pricetik_get_cashback_rate, pricetik_transfer_status, pricetik_transfer_rate_history, and pricetik_transfer_routes.

Three families folded into params on survivors: pricetik_status gains surface (hotels / events / transfers) for the per-vertical health views; pricetik_demand gains mode:"pulse" + windowSec for the real-time presence counter (pricetik_demand_pulse — 63 calls in the gate window — is deprecated in place and keeps working); pricetik_price_check gains productIds (up to 10) replacing the batch tool.

Widget UI — the six retired widget-bearing bindings (compare grids, activity deal-score card, the two rate-history cards) are gone; every widget keeps at least one live backing tool.

Tool count 64 (was 80) — Shopping 10 (was 13), Hotels 7 (was 10), Events 9 (was 14), Reference 2 (was 4), Transfers 4 (was 7); Account and Trip Planner unchanged.

Last alert-reading tools retired (shopping de-exchange PR-S5) — the API dropped GET /intel/my-alert-history, GET /intel/alerts/:alertId/deliveries, and POST /intel/alert-rotate-secret along with the intel_alerts tables behind them, so pricetik_my_alert_history, pricetik_webhook_deliveries, and pricetik_webhook_rotate_secret retired in the same release. The deprecated pricetik_alert_deliveries / pricetik_alert_rotate_secret aliases retire with their targets — no renamed aliases remain.

Widget UI — the account-card's triggered-alerts banner and its "See history" onward action are gone with their backing tool; the card's watches block is no longer emitted by pricetik_my_dashboard, and pricetik_my_export no longer offers a watches section.

Tool count 80 (was 83) — Shopping 13 (was 14), Account 18 (was 20); every other vertical unchanged.

Consumer watch/alert retirement (shopping de-exchange PR-S4, "no alerts anywhere") — closes the 404 window left by the API-side removal. Removed entirely: pricetik_my_watches / pricetik_cancel_watch / pricetik_set_watch_paused / pricetik_my_watchlist_analytics (the consumer rate-watch surface), pricetik_category_alerts / pricetik_category_alert_create / pricetik_category_alert_delete (in-app category price-drop alerts), pricetik_webhook_create / pricetik_webhook_list / pricetik_webhook_update / pricetik_webhook_delete / pricetik_webhook_test (the developer webhook CRUD quintet — pricetik_webhook_deliveries and pricetik_webhook_rotate_secret survive as read-only tools over alert rows that already existed), and pricetik_activity_watch_rate (its API route + worker retired in the S3 wave). The deprecated pricetik_alert_create/_list/_update/_delete/_test aliases retire with their targets.

Widget UI — the watch-card widget (and its shaping module) is gone entirely; the account-card's "See watches" onward action now points at pricetik_my_alert_history ("See history") since pricetik_my_watches no longer exists.

Tool count 83 (was 96) — Shopping 14 (was 19), Events 14 (was 15), Account 20 (was 27); every other vertical unchanged. Rebased onto 0.37.0 below, so this also reflects that release's pricetik_compare_destinations retirement.

Destination comparison retired — pricetik_compare_destinations and its compare-matrix widget removed (the tool was the widget's sole binder). The tool logged zero production calls over its entire live period, and parallel pricetik_hotel_search calls return richer, bookable results per destination; pricetik_search's routing guidance now points multi-destination comparisons at parallel dedicated hotel searches. The REST endpoint stays online for older published package versions.

Tool count 96 (was 97) — Trip Planner 14 (was 15); every other vertical unchanged.

Full MCP price-intelligence retirement — hotels become search → compare → book. Removed entirely: pricetik_hotel_watch_rate (rate-drop webhooks), pricetik_hotel_rate_history (90-day trend + all-time stats), pricetik_hotel_should_book, and the deprecated pricetik_hotel_deal_score, plus the dark shopping order-book trio pricetik_set_target_price / pricetik_my_target_prices / pricetik_cancel_target_price and pricetik_predict (ML fill-probability). The web Targets tab keeps target-price watching as a live shopping feature — only the MCP tool layer for these retired.

Widget UI parity — the hotel-card watch panel + alert-preset chips, the 90-day price-history chart (Sparkline + PricePositionBar) on hotel-card/price-card/trip-plan, and the price-card "Set price alert" control are gone. Product and activity cards keep their deal scores; hotel cards keep live rates and comparisons; watch-card keeps activity watches (pricetik_activity_watch_rate) and the my-watches list.

Tool count 106 (was 114) — Shopping 19 (was 23), Hotels 13 (was 17); every other vertical unchanged.

Hotel + show bundling — pricetik_trip_plan now exposes includeTickets + ticketQuery (the agent-API backing supported them; the MCP schema previously hid them). Set includeTickets=true to bundle live-event tickets (concerts, theater, sports) matched to the destination and stay window into an eventTickets[] block; the trip-plan widget renders them as an "Event tickets" section with seller-checkout handoffs. Ticket amounts stay out of estimatedTotalUsd and the widget discloses it.

Live-event tickets get first-class treatment — pricetik_ticket_search gains city + dateFrom/dateTo filters ("a show in Vegas during my trip dates" resolves server-side), both ticket tools now render the interactive event-card widget instead of plain text, and pricetik_ticket_details accepts code as an id alias so widget drill-ins dispatch cleanly. Trip-plan ticket matching is constrained to the destination city + stay window.

Group trip sessions (6 new tools, trip vertical) — pricetik_group_trip_create / _get / _join / _add_option / _vote / _finalize. Shared multi-user planning: friends join by an 8-character share code, members propose candidates from any surface (hotel / activity / ticket / transfer), vote up/down (one vote per member per option, upsert), and the organizer finalizes. Coordinate-only by design — finalize returns handoffPolicy "user_completes_booking" and every traveler books their own pieces; PriceTik never auto-purchases. Gated behind the groupTripsV1Enabled master flag + per-tool flags.

MCP prompts capability — the server now advertises prompts and ships three one-click starters Claude Desktop surfaces natively: "Plan a trip", "Hotel + show night", and "Plan a group trip", each pre-wiring the right multi-tool choreography.

Group-plan widget (7th MCP Apps widget) — pricetik_group_trip_get renders the shared session as an interactive card: header (title, destination, dates, status, join code, member count) and candidate options grouped by surface with proposer notes, prices, and LIVE vote tallies. The up/down vote controls dispatch pricetik_group_trip_vote in-model with optimistic tally updates; per-row drill-ins route to each option's surface detail tool.

Widget coverage 14 → 20 tools — pricetik_compare (side-by-side deal grid with a cheaper-product verdict), pricetik_hotel_price_check (per-provider comparison + freshness stamp on the hotel card), pricetik_activity_compare (event-card rows), and pricetik_flexible_dates (stay-window rows priced by total cost with confidence badges) now return rich interactive UI instead of JSON text.

Search quality — surface=events now also returns a labeled "Event tickets" section (activities first, never interleaved; ticket rows carry city, eventDate, and the ticket-details drill-in), the hotels surface gains a trigram fallback when the semantic-embedding path misses, and semantic search (pgvector, MiniLM) extends to activities and live-event tickets via new embedding tables — every search surface is now semantic-first.

Cross-vertical trending deals — pricetik_trending_deals gains a surface param: shopping (default, legacy behavior preserved), hotels (biggest 7-day rate drops), events (activity rate drops), tickets (below their 30-day median via a new deterministic ticket deal-score with a reasons breakdown), or all (labeled per-surface sections rendered in the deal-grid widget). Surface pools are Redis-cached.

pricetik_coupons_for (new tool) — coupons + cashback probe for a retailer, product, or URL: active coupon codes from affiliate-feed offer data, per-retailer cashback rates, and a bestStack hint with estimated total savings. Sourced fields only — codes are never fabricated. Tool count 91 → 92.

Widget coverage 20 → 26 tools — transfer_search (the transfers surface's first rich UI), alternative_dates (shifted stay windows with savings badges), my_trips (trip rows with spend + departure countdown), and hotel/activity should_book rendering a new price-card decision view: Book now / Wait / Watch verdict chip, confidence, and reasoning, with the Buy commerce controls suppressed.

Master agent-API surface count: 92 tools across Shopping (23), Hotels (16), Events (13), Account (18), Trip Planner (11), Reference (4), Transfers (7) — 91 exposed via the stdio package, 1 auth-required Account tool REST-only.

Description cross-linking pass — pricetik_search documents the events surface's new "Event tickets" section and when to reach for pricetik_ticket_search instead, pricetik_compare_destinations clarifies activityDestinationCode is the short activity destination code (not the destination UUID), and pricetik_check_availability no longer implies activity rateKeys can be probed.

Route→tool gap fill — two backing intel routes that had no stdio tool are now exposed: pricetik_activity_watch_rate (subscribe a webhook/auto-book to an activity price or availability condition — the events analog of pricetik_hotel_watch_rate; Pro tier, HTTPS webhook, Idempotency-Key replay) and pricetik_destinations (free-text → destination + activity-code resolver that feeds hotel-search, activity-search, and trip-plan). Agents can now set activity alerts and resolve destination codes directly through the stdio package.

Activity request schemas consolidated into @pricetik/validators — all 10 activity tools now validate against shared, contract-tested Zod schemas (parity with the hotel + transfer surfaces) instead of per-route inline schemas.

Added a per-tool kill switch for pricetik_destinations (DESTINATIONS_ENABLED) so every intel tool now has an operator-flippable feature flag.

Master agent-API surface count: 82 tools across Shopping (21), Hotels (16), Events (11), Account (18), Trip Planner (5), Reference (4), Transfers (7) — 81 exposed via the stdio package, 1 auth-required Account tool (Stripe Customer Portal handoff) REST-only.

pricetik_activity_status (P2 parity) — cache-side health for the events/tickets surface, the events analog of pricetik_hotel_status. Reports `activity_price_history` rate-cache coverage over the trailing 24 hours (rows written, distinct activities covered, hours since the last write) plus the 30-minute watch-rate worker classification, rolled up to a top-level `ok` / `degraded` service status. Activities are cache-on-demand so the worker liveness is the primary signal. Free at every tier; surfaces no live partner quota numbers.

pricetik_transfer_status (P2 parity, ships dark) — cache-side health for the ground-transfer surface: content-mirror freshness (route / terminal / vehicle / type row counts + hours since the last refresh), transfer rate-history coverage in the last 24h, and the weekly content-refresh worker status, rolled up to `ok` / `degraded`. Gated behind `TRANSFER_TOOLS_V1_ENABLED` + `TRANSFER_STATUS_ENABLED` (strict) like the rest of the transfers vertical.

Master agent-API surface count: 82 tools across Shopping (21), Hotels (16), Events (11), Account (17), Trip Planner (6), Reference (4), Transfers (7).

Account / Personal-Dashboard MCP (P4-A) — the data layer for user-built dashboards. Promoted the previously REST-only account reads (`pricetik_my_account`, `pricetik_my_bookings`, `pricetik_my_booking_voucher`, `pricetik_my_watches`, `pricetik_my_payment_methods`) to first-class stdio tools, and added four authenticated, read-only aggregation tools: `pricetik_my_dashboard` (one-call portfolio snapshot — account, lifetime + YTD savings, upcoming trips, active-watch + open-alert counts, recent bookings), `pricetik_my_watchlist_analytics` (per-watch current-vs-target price + % distance to fill + status), `pricetik_my_alert_history` (cross-key fired-alert delivery timeline), and `pricetik_my_export` (normalized bookings/watches/savings dump for BI). Each gated by its own per-tool feature flag; all pure reads that only touch data the caller owns.

Surface reconciliation — completed the `pricetik_find_dupes` removal (the visual-matching pipeline was retired back in 0.21.0; the tool definition and counts had lingered). The single-source-of-truth tool counts in `@pricetik/shared-types` now match the live `TOOL_DEFINITIONS` array exactly, enforced by the consistency suite.

pricetik_get_cart_link (P4-B) — retail parity for the hotel/activity/transfer booking-url handoff. Give it a product (URL or productId) and it returns the checkout link to hand the user for the best (or a chosen) retailer offer, as an attribution-preserving `pricetik.com/go/` redirect built off the same affiliate path as price-check. Optional `retailer` + `quantity`; lists alternative retailers too.

Order-book target-price tools (P4-B) — `pricetik_set_target_price` / `pricetik_my_target_prices` / `pricetik_cancel_target_price` let agents set a target price on a product (a price WATCH, never an auto-purchase): PriceTik watches the retail price and notifies the user with a checkout link when it hits the target. Under the hood it places a queued order on the exchange (queue position + token stake surfaced). Full guardrails — free-tier 3-target cap, Pro-only time-in-force, 10%/retail price-band rejection, flat token stake with refund-on-reject, and Idempotency-Key replay. Ships dark behind `TARGET_PRICE_TOOLS_V1_ENABLED` (strict) pending validation.

Discovery + cross-vertical (P4-C/E) — `pricetik_activity_destinations` (free-text → activity destination code, the events analog of pricetik_destinations), `pricetik_trending_deals` (today's best deals ranked 0–100 by deal score, optional category, with attribution-preserving /go/ links), and `pricetik_itinerary_export` (your bookings as an RFC-5545 .ics calendar + structured events — the capstone to trip_plan / my_trips).

pricetik_activity_should_book (P2 parity) — deterministic book_now / wait / watch recommendation for an activity, the events analog of pricetik_hotel_should_book / pricetik_transfer_should_book. Combines the 0–100 deal score, free-cancellation, recent price trend, and days-to-travel into a recommendation + 0–1 confidence + plain-language reasoning. No LLM.

Master agent-API surface count: 80 tools across Shopping (21), Hotels (16), Events (10), Account (17), Trip Planner (6), Reference (4), Transfers (6).

Lighthouse 100 across the board — `/mcp-server` and homepage now both score 100 / 100 / 100 / 100 (Accessibility / Best Practices / SEO / Agentic Browsing) on desktop and mobile, up from 92 / 96 respectively. Fix shipped over the design tokens in `apps/web/src/app/globals.css`: `--color-text-muted` `#9ca3af → #5b6370` (4.69:1 → 5.10:1 against bg), `--color-brand-primary` `#10b981 → #047857` (2.44:1 → 6.05:1), `--color-brand-secondary` `#3b82f6 → #1d4ed8`, plus AA-aligned status colors. Vertical accent text (`text-blue-500`, `text-amber-400`, `text-emerald-400`, `text-violet-400`, `text-pink-400`, `text-rose-500`, `text-cyan-500`) bumped to `-700` shades on every page. Heading order fixed in `SurfaceCards` (h3 → h2). Sidebar TOC links now meet WCAG 2.2 AA target-size (24×24 minimum). LiveTickerWithHotels animation drops opacity transition so motion-mid contrast scoring is solid.

Master agent-API surface count at this release: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

`/mcp-server` page refactor — extracted ~2,100 lines of static data (TOC groups, tool catalogs, tool-response examples, marketing examples, reference tables, changelog) out of `apps/web/src/app/(public)/mcp-server/page.tsx` into a focused `_data/` directory. The page is now pure composition at 1,302 lines (was 3,384). Six modules: `toc.ts`, `marketing-examples.ts`, `tool-examples.ts` (every EX_* response shape), `tool-catalogs.ts` (per-vertical tool definitions), `reference.ts` (workflows / error codes / feature flags / architecture / abuse controls / cert boundary), `changelog.ts`. Barrel export at `_data/index.ts` keeps the page imports tidy.

Master agent-API surface count unchanged: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

Coverage map generator — new script `packages/mcp-server/scripts/generate-coverage-map.ts` introspects the live `TOOL_DEFINITIONS` array and emits `docs/mcp-coverage-map.generated.md` with per-vertical tool tables (name + method + path). Path-prefix heuristics first, name-prefix fallbacks, anything unmapped lands in "Reference / cross-cutting" so unmapped tools surface visibly. Run via `pnpm --filter @pricetik/mcp-server gen:coverage-map`.

Demand-pulse activity tests — new `apps/api/src/routes/intel/__tests__/demand-pulse.test.ts` covers the response composition (intensity bucketing, headline copy variants, activity-name enrichment, fallback messaging). 12 unit tests on the pure `buildPulseResponse` helper, exported from the route module specifically for testability. Catches headline-copy drift before it ships.

Master agent-API surface count unchanged: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

Public homepage stats endpoint — new `GET /api/v1/intel/platform-stats` returns live merchant / hotel-property / event-destination counts plus the SSOT MCP tool counts. Cached 1h in Redis, falls back to `MCP_STATS` constants on DB hiccup. New `PLATFORM_STATS_ENABLED` feature flag (default on). The marketing homepage now SSR-fetches from this endpoint with a 10-minute revalidate so the stats bar renders real numbers instead of static fallbacks.

Feature-flag dashboard panel on `/admin/intel/metrics` — read-only resolved-state view of every `getIntelFeatureFlags()` flag with env-var name and on/off pill. Filterable by enabled / disabled / all, links out to the existing `/admin/feature-flags` page for toggling. Backed by new `GET /admin/intel/feature-flags` endpoint that derives the list from the flag service so new flags show up without registering.

Tool-metrics admin endpoint — new `GET /admin/intel/tool-metrics` returns the per-tool latency + error-rate dashboard data the existing metrics page was already trying to render. Reads `summariseAllEndpoints()` from the Redis-backed 1h rolling window. The dashboard now actually has data.

Activity travel-date column on `intel_queries` — migration 0081 adds `activity_travel_date` plus a partial composite index `(activity_code, activity_travel_date, queried_at DESC)`. All six activity routes log the `from` date alongside `activityCode`. The demand-aggregate worker pivots on persisted travel date instead of `queried_at::date`, so per-show-date demand stays in distinct buckets. `pricetik_demand_pulse` accepts an optional `travelDate` filter.

Master agent-API surface count unchanged: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

Activity demand-aggregate rollup — `pricetik_demand` now answers `targetType: "activity"` queries. Migration 0080 adds `intel_activity_demand_signals` (mirror of the hotel rollup table). The `intel-demand-aggregate.worker.ts` job grew an activity branch alongside the hotel branch — every 15-minute pass groups `intel_queries.activity_code` rows by `(activityCode, travelDate)`, gates on the same ≥3 unique fingerprint threshold, and inserts one row per tuple that meets the threshold.

New `getActivityDemand(...)` service reads the latest signal for a `(activityCode, travelDate)` tuple. Same Pro+ tier gate as the hotel branch. Returns `uniqueAgentCount`, `totalQueryCount`, `medianTargetPrice`, `topTargetPriceModes`, and a bucketed `priceDistribution` matching the hotel response schema.

Daily prune extended — `intel-db-maintenance.worker.ts` now also prunes `intel_activity_demand_signals` rows older than 15 days. Same retention window as the hotel rollup so any future "demand history" surface can join both tables.

`pricetik_demand` validator extended — `targetType: "activity"` requires `activityCode` + `travelDate` and rejects `productId` / `checkIn` / `checkOut`. Existing `targetType: "product"` and `targetType: "hotel"` callers stay backwards-compatible.

9 new unit tests on the rollup helpers (threshold gate, grouping, median + modes + buckets, window stamps).

Master agent-API surface count unchanged: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

Activity watch-rate worker — `pricetik_activity_watch_rate` alerts now actually fire. The new BullMQ worker (`activity-watch-rate.worker.ts`) scans active alerts every 30 minutes, groups by `(activityCode, travelDate, pax, currency)` so a single provider availability call serves every alert in the group, and forwards each group to the new `evaluateActivityAlertsForCode(...)` evaluator.

New per-alert rate cache (Redis, 30-day TTL) tracks last-observed price + availability so `activity_price_drop_percent` can compute deltas and `activity_availability_in_window` can detect sold-out → available transitions across pass boundaries.

New `evaluateActivityConditions(...)` evaluator with cross-surface isolation — retail and hotel evaluators skip activity_* conditions and vice versa, defense in depth on top of the SQL XOR check.

Webhook delivery shared with retail + hotel — same HMAC-SHA256 signing, 1m / 5m / 30m retries, disable-after-3-failures path. New `ActivityAlertWebhookPayload` shape carries `currentPricePerPerson`, `previousPricePerPerson`, `available`, and the `activityTarget` block.

New env flag `DISABLE_ACTIVITY_WATCH_RATE=true` to drop the worker during incidents without disabling the alert-creation route. 22 unit tests on the new evaluator + grouping + snapshot helpers.

Master agent-API surface count unchanged: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

pricetik_my_loyalty_link_set — write half of the loyalty-link surface. Body `{ program, memberId }` upserts the program (replace by case-insensitive match, else append); body `{ program, delete: true }` removes it. The `traveler_profiles` row is created on first call so a brand-new user can link Marriott Bonvoy mid-conversation without a separate `pricetik_traveler_profile_set` round-trip. Response carries the updated `loyaltyPrograms` array + an `action` field (`appended` / `replaced` / `removed` / `noop`) so retries are detectable.

Master agent-API surface count: 61 tools across Shopping (17), Hotels (16), Events (7), Account (13), Trip Planner (4), Reference (4).

pricetik_get_cashback_rate — read-only resolution of the cashback rate a user would earn for a retailer. Pass `retailer`, `productId`, or `url` (exactly one). Optional `price` adds a USD `estimatedCashback` projection. Auth optional — Pro callers receive the 1.25× share-rate multiplier (capped at 100%). Returns rate=0 with `meta.isFallback=true` when no active affiliate config exists for the retailer, so agents can quote "no cashback active for this retailer" rather than leaving the user wondering.

pricetik_activity_compare — mirror of pricetik_hotel_compare for activities. Compare 2–4 codes side-by-side: name, type, cheapest fromAmount, freeCancellation flag, modalitiesCount, meetingPoint, and a 0–100 dealScore per activity. The winner block picks the highest dealScore (ties broken by fromAmount ascending) so the agent can quote a clear pick.

Per-tool feature flag `GET_CASHBACK_RATE_ENABLED` (default `true`). Activity-compare reuses the existing `ACTIVITIES_V1_ENABLED` master.

Master agent-API surface count: 60 tools across Shopping (17), Hotels (16), Events (7), Account (12), Trip Planner (4), Reference (4).

Worked-example responses on every tool card. The remaining ~50 cards (Shopping 12, Hotels 13, Events 6, Account 12, Trip Planner 3, Reference 3) now have a collapsible "Example response" block on `/mcp-server` showing the JSON shape an agent receives. Realistic sample IDs throughout — `550e8400-...` for product UUIDs, `16914` for property IDs, `E-E10-A1GMNO0125` for activity codes.

Added missing tool cards on `/mcp-server` for `pricetik_demand_pulse` (Reference), `pricetik_my_loyalty_link` (Account), and `pricetik_alert_rotate_secret` (Account) — they shipped in v0.12.0 but had no card on the page yet.

Master agent-API surface count unchanged: 58 tools across Shopping (17), Hotels (16), Events (6), Account (12), Trip Planner (4), Reference (3).

`pricetik_demand_pulse` now works for activity targets — previously returned zero for `target=activity` because `intel_queries` had no activity column. Migration 0079 adds an `activity_code varchar(80)` column, a partial index `idx_intel_queries_activity_code` on `(activity_code, queried_at DESC)` filtered by `target_type = 'activity'`, and extends the `target_type` CHECK to include `'activity'`.

Activity routes (`activity-search`, `activity-details`, `activity-deal-score`) now call `logIntelQuery` with `targetType: 'activity'` and `activityCode`. `activity-search` logs the first 10 results per call so a single search seeds the pulse for the whole result set.

Headline enrichment — activity pulses now read the cached display name from a new `pricetik:activity:name:{code}` Redis key (24h TTL, populated on every activity-search / activity-details / activity-deal-score call). Output reads "8 people are looking at this Cirque du Soleil show right now" instead of the generic "8 viewers in the last 60s." Cache miss falls back to "this show" so the headline still composes.

New `targetName` field on the response — null when the cache misses, populated when present, ignored on hotel/product targets today.

Master agent-API surface count unchanged: 58 tools across Shopping (17), Hotels (16), Events (6), Account (12), Trip Planner (4), Reference (3).

Activity-target column on `intel_alerts` — activities now persist via the dedicated `target_type = 'activity'` branch with a structured `activity_target` JSONB payload `{ activityCode, travelDate, adults, children }`. The synthetic-UUID indirection (where activity codes were hashed to a UUID and stored as `productId`) is gone, and the worker can now look up alerts by `((activity_target->>'activityCode'))` via a partial index.

New `createActivityAlert(...)` helper in `intel-alert.service.ts` mirrors the shape of `createHotelAlert` — Pro+ tier check, default `expiresAt = travelDate - 24h`, shared per-tier alert-count budget. The legacy `createAlert(...)` is now `@deprecated` for activity callers (still works for retail).

`pricetik_activity_watch_rate` route now calls `createActivityAlert` instead of `createAlert` with a synthetic UUID. The idempotency-key path stays unchanged. Response carries the structured travel context (travelDate, adults, children) the worker will need at fire time.

Migration `0078_intel_alerts_activity_target.sql` extends the `target_type` enum, adds the `activity_target` JSONB column, rewrites the `intel_alerts_target_xor` CHECK to cover three branches (product / hotel / activity), and adds the `idx_intel_alerts_activity_code` partial index.

Master agent-API surface count unchanged: 58 tools across Shopping (17), Hotels (16), Events (6), Account (12), Trip Planner (4), Reference (3).

Loyalty injection on the booking-url handoff — when the caller is authenticated and a stored loyalty program (`traveler_profiles.loyaltyPrograms`) matches the property's `chainCode`, `pricetik_hotel_get_booking_url` now stamps the signed `pricetik.com/hotels/live/...` URL with `?loyalty=<chainCode>&loyaltyMember=<id>`. Response carries a new `loyaltyApplied: { program, memberId } | null` block so agents can quote "Marriott Bonvoy linked" to the user. Consumer checkout shows a "linked" badge above the lead-booker fields.

Per-tool kill switch `LOYALTY_INJECTION_ENABLED` (default `true`) — flip to drop just the loyalty stamping during chain-loyalty incidents without disabling the booking-url tool itself.

Best-effort lookup — booking-URL still succeeds when the property has no chain affiliation, the user has no traveler-profile row, or the database read fails. Loyalty is additive; it never blocks a booking handoff.

Master agent-API surface count unchanged: 58 tools across Shopping (17), Hotels (16), Events (6), Account (12), Trip Planner (4), Reference (3).

pricetik_demand_pulse — real-time presence indicator. Returns unique-viewer + query counts for a hotel/product/activity over the trailing 60s window. Powers "12 people are looking at this hotel right now" prompts.

pricetik_alert_rotate_secret — rotate the HMAC signing secret on the developer-API-key row. Mirrors the existing key-rotation pattern. Auth required.

pricetik_my_loyalty_link — read-only convenience tool over `traveler_profiles.loyaltyPrograms`. Saves a round-trip vs `pricetik_traveler_profile_get` when the agent only needs the loyalty block.

Idempotency-Key support on `pricetik_hotel_watch_rate` and `pricetik_activity_watch_rate` — retries are now safe; same 24-hour replay window as the booking-url tools.

Worked-example responses on every high-traffic tool card. Click "Example response" on price_check, should_buy, deal_score, search, hotel_search, hotel_price_check, hotel_booking_url, trip_plan to see the JSON shape an agent gets back.

Per-tool feature flags for demand_pulse, alert_rotate_secret, my_loyalty_link.

Master agent-API surface count: 58 tools across Shopping (17), Hotels (16), Events (6), Account (12), Trip Planner (4), Reference (3).

pricetik_check_availability — lightweight rateKey probe via the provider's /checkrates. Cuts the booking flow by 1 round-trip vs. pricetik_hotel_price_check.

pricetik_hotel_review_summary — synthesised review summary with theme cues for cleanliness, location, staff, value, and comfort. Cache-only; theme cues are inferred from cached amenity content.

pricetik_activity_pickup_check — pickup + meeting-point detail for an activity. Returns hasPickup boolean, meetingPoint, and the list of modalities that include pickup.

pricetik_my_savings_report — authenticated savings breakdown (lifetime, YTD, per-month, top fills, per-surface).

pricetik_search — now cross-vertical: pass surface=shopping|hotels|events|all to fan out across all three surfaces with round-robin merging.

Per-tool feature flags for check_availability, hotel_review_summary, activity_pickup_check, my_savings_report.

Master agent-API surface count: 55 tools across Shopping (17), Hotels (16), Events (6), Account (10), Trip Planner (4), Reference (2).

pricetik_currency_convert — single-amount + batch endpoints converting between any two ISO 4217 currencies. Cache-only — same Redis FX cache the hotel and activity surfaces share. Up to 100 amounts per batch call.

pricetik_weather_forecast — daily forecast for a destination + date window. Open-Meteo upstream (free, no API key, ~16-day horizon). Returns per-day highs/lows/precip/wind plus aggregate stats and a headline summary. Pairs with pricetik_hotel_should_book.

New "Reference Tools" section on /mcp-server with TOC entry. Both new tools sit alongside Trip Planner.

Per-tool feature flags for currency_convert and weather_forecast.

Master agent-API surface count: 51 tools across Shopping (17), Hotels (14), Events (5), Account (9), Trip Planner (4), Reference (2).

pricetik_explain_price — decompose a hotel total into base rate + taxes & fees + paid amenities (resort fee, parking) + seasonal premium. Pure cache read.

pricetik_alternative_dates — anchored ±N-day shifts of an intended check-in. Returns alternatives ranked by savings vs. the requested window.

pricetik_room_types — filtered, ranked room catalog for a property. Reads cached hotel_property_content.rooms and joins cheapest cached rate when a stay window is supplied. Filter by bedType, suite, kitchenette, accessible, minAdults.

pricetik_cancel_booking — cancel a completed direct booking the user owns. Calls the provider DELETE, refunds the Stripe charge, marks the row cancelled.

pricetik_modify_booking — surfaces 422 ModifyNotSupported with a `nextSteps` payload describing the cancel + rebook flow (the provider doesn't support real modifications).

pricetik_traveler_profile_get/_set — stored per-user travel preferences (preferred chains, excluded chains, segments, bed type, star floor, resort-fee/breakfast/pet flags, max nightly rate, loyalty programs). Pass applyTravelerProfile=true on hotel_search and trip_plan to soft-merge prefs over caller params.

Per-tool feature flags for explain_price, alternative_dates, room_types, booking_lifecycle, traveler_profile.

Master agent-API surface count: 49 tools across Shopping (17), Hotels (14), Events (5), Account (9), Trip Planner (4).

Hotel-search filter expansion — excludeResortFees (now a real SQL NOT EXISTS against hotel_property_content.paid_amenities, no more flaky heuristic), excludeChainCodes (inverse of chainCode), freeBreakfast, petFriendly, minNightlyRate, and POI-pin filters (nearPoiLat / nearPoiLng / nearPoiRadiusKm) so agents can pin a search to "the Strip" rather than the Vegas centroid.

pricetik_flexible_dates — "find the cheapest weekend in June" via the cached hotel_price_history hypertable. Tier-clamped windows (Open ≤ 30 days, Pro ≤ 90, Scale+ ≤ 180); each candidate carries a high/low confidence flag.

pricetik_compare_destinations — apples-to-apples "Cabo vs Tulum" comparison: median 4★ rate, top-3 hotels by deal score, top-3 activities, and seasonal-premium flag (event-window markers like "F1 weekend in Vegas — rates 65% above baseline"). Stricter rate cap of 10/min.

pricetik_my_trips — group bookings into actual trip objects (destination + overlapping windows), with total spend, days-until-departure countdown, and per-member manage URLs.

pricetik_trip_plan v2 — opt-in daily itinerary via groupByDay=true. Conflict avoidance for 4h+ activities + rest-day placeholders for trips longer than 5 nights. Resort-fee filter now SQL-backed, not a post-fetch heuristic.

Idempotency-Key support on pricetik_hotel_get_booking_url and pricetik_activity_get_booking_url — 24-hour replay window keyed on (fingerprint, route, key). Replays return Idempotency-Replay: true.

NDJSON streaming opt-in — pass `?stream=ndjson` (or `Accept: application/x-ndjson`) on pricetik_hotel_search, pricetik_trip_plan, and pricetik_compare_destinations to receive frames incrementally as they materialize. Cuts perceived TTFB on cache-miss searches from ~3s to <50ms.

Per-tool feature flags for trip-plan, compare-destinations, hotel-flex-dates, my-trips so ops can drop just one tool during incidents.

Tool-level metrics dashboard at /admin/intel/metrics — Redis-backed 1-hour rolling window. Surfaces per-tool call counts, p50/p95/p99 latency, error rates, and last-sample-seen timestamps. Powers incident triage without spinning up ClickHouse.

@pricetik/mcp-server published to npm — npx @pricetik/mcp-server now works without a 404. SDK quickstarts on this page cover TypeScript, Python, and curl.

Master agent-API surface count: 43 tools across Shopping (17), Hotels (11), Events (5), Account (6), Trip Planner (4).

Trip Planner MCP — pricetik_trip_plan stitches hotel + activity search + budget allocation into one call. Powers prompts like "find me the cheapest hotel in Vegas, no resort fees, plus fun events" without 4–6 sequential tool calls.

Destinations resolver — pricetik_destinations converts free-text ("Las Vegas") into the canonical shape every other tool needs (hotel-search-friendly text, 3-letter activity destination code, country, lat/lng).

Activity watch-rate — pricetik_activity_watch_rate mirrors hotel watches: targetPricePerPerson, dropPercent, dealScoreAbove, notifyOnAvailability triggers; auto_book action mode honored when API key has directBookingEnabled=true.

My-watches tool — pricetik_my_watches consolidates every active alert (hotel, activity, shopping) under the user's account into one human-readable list. Each row includes a prettified conditions array agents can quote verbatim.

Hotel watch-rate enhanced — now accepts targetNightlyRate / dropPercent / dealScoreAbove as OR-conditions in one call, plus optional action="auto_book". Existing single-condition callers stay backwards-compatible.

Alert condition vocabulary expanded: hotel_rate_drop_percent, hotel_deal_score_above, hotel_availability_in_window, activity_price_below, activity_price_drop_percent, activity_availability_in_window.

Master agent-API surface count: 40 tools across Shopping (17), Hotels (10), Events (5), Account (6), Trip Planner (2).

Account MCP — 5 new authenticated tools: pricetik_my_bookings (list trips), pricetik_my_booking_voucher (single-booking detail with confirmation #, address, cancellation policy), pricetik_my_account (plan + lifetime stats), pricetik_my_payment_methods (masked card list), pricetik_update_payment_method (Stripe Customer Portal handoff). Powers conversational lookup like "pull up my Wynn voucher" and "update my card."

PCI scope-out: pricetik_update_payment_method returns a Stripe-hosted URL — raw card data never enters the agent runtime.

Direct booking groundwork — agent_direct_bookings table + email-confirmation handshake routes shipped behind feature flag. Stripe + provider settlement still pending.

API key dashboard — users can now mint, name, revoke, and toggle direct-booking permission on keys at /api-keys (no Stripe subscription required).

Tickets MCP — 4 new tools wrapping live activities: pricetik_activity_search, pricetik_activity_details, pricetik_activity_deal_score, pricetik_activity_get_booking_url.

Activity prices auto-convert EUR → USD (or any ISO 4217 target) using the same exchange-rate cache the hotel surface relies on; source quote always preserved on `originalCurrency`/`originalFromAmount`.

New error code: 503 ActivityToolDisabled when ACTIVITIES_V1_ENABLED kill switch is off.

Hotels MCP — Phase 2: pricetik_hotel_get_booking_url generates signed pricetik.com/go/ booking URLs with rateKey refresh.

Hotels MCP — Phase 2: pricetik_hotel_watch_rate webhook alerts fire when cross-provider best nightly rate drops below target.

pricetik_demand extended to accept hotel UUIDs via targetType=hotel.

Per-fingerprint sliding-window abuse caps (60/min, 1,000/hour) on every surface.

New error code: 410 RateKeyExpired for stale hotel rate handles.

Hotels MCP — Phase 1: pricetik_hotel_details surfaces full property content (description, amenities, paid extras, POIs, rooms, chain, contact).

Hotels MCP — Phase 1: pricetik_hotel_rate_history with deterministic OLS trend slope.

Hotels MCP — Phase 1: pricetik_hotel_should_book deterministic recommendation engine.

Hotels MCP — Phase 1: pricetik_hotel_compare for 2–4 properties in one call.

pricetik_hotel_search adds segments, chainCode, accommodationType filters.

Richer response shaping for hotel-price-check (full content depth on every request).

Added pricetik_compare tool for side-by-side product comparison

Added pricetik_batch_price_check for multi-product price checks

Added pricetik_alert_update for modifying existing alerts

Spread analysis and confidence intervals added to deal-score response

Webhook payload format documented with HMAC-SHA256 signature verification

Initial three hotel tools shipped: pricetik_hotel_search, pricetik_hotel_price_check, pricetik_hotel_deal_score.

Initial release with 12 Shopping MCP tools

Free for every agent — no API key required

Attribution system with /go/ redirect tracking

Webhook alerts with 4 condition types

Anti-scraping anomaly detection