Skip to content
LavandaLavanda Developer Docs

Rate Plans

MCP tools for reading and bulk-updating rate plans on channel listings (e.g. Booking.com Standard / Non-refundable / Weekly / Monthly).

Available Tools

Section titled “Available Tools”

Overview

Section titled “Overview”

Rate plans hang off a channel listing. Each plan carries:

  • percentage - discount applied relative to the standard rate (e.g. 15 = 15% off, used for Non-refundable / Weekly / Monthly plans).
  • cancellationPolicyId - the cancelation policy attached to this rate plan (Strict, Moderate, Flexible, etc.).
  • minimumBookingWindow / maximumBookingWindow - booking window bounds, paired with a unit (hour, day, month, year).
  • minStay / maxStay - length-of-stay bounds in nights.

Typical bulk update flow

Section titled “Typical bulk update flow”
  1. search_unit_types to find the unit types in scope.
  2. get_unit_type_listings to get the channel listings on each unit type.
  3. list_channel_rate_plans for each channel listing of interest to read current settings.
  4. Build an array of { id, ...changes } items and call update_channel_rate_plans once.

The mutation accepts updates spanning multiple unit types and channels in a single call, so portfolio-wide changes (e.g. switching from term-time to summer settings) collapse to one round trip.